Getting Started

The Metamug Console can be downloaded from https://metamug.com/dl

How to start/stop the server

The console runs as a server and can be started using the following commands:

For Windows

Go the \bin folder and run the following

For starting the server.

startup.bat

For Stopping the server.

shutdown.bat

For Mac/Linux

Go to the /bin folder and run the following

For starting the server

sudo bash catalina.sh start

For starting the server on the main thread of the terminal, this will show the logs on the terminal screen

sudo bash catalina.sh run

For stopping the server

sudo bash catalina.sh stop

It is recommended to run the server as root using sudo to prevent any file permission issues.


Note: The above scripts can be executed using sh instead of bash but we do not recommend doing so as the sh command may not completely run all the required scripts and may cause unpredictable behaviour.

Setting heap size for Java runtime

For Windows, Open /bin/setenv.bat and locate the following line in the file

set "JAVA_OPTS=%JAVA_OPTS% -Xms512m -Xmx2048m"

Xms and Xmx represents the minimum and maximum value in mb respectively. You can modify the values according to your requirements

For Max/Linux, open /bin/setenv.sh and locate the following lines in the file

export CATALINA_OPTS="$CATALINA_OPTS -Xms1024m"
export CATALINA_OPTS="$CATALINA_OPTS -Xmx2048m"

Launch

Point your browser at http://localhost:7000/console You should see the launch page of Metamug.

  1. Login into your account using the default credentials given above and voila! You're ready to use the Metamug Console.
username: admin
password: admin
  1. You'll need internet connection to download updates later. Otherwise you can use console without internet.

  2. PDF Guide is available online at:

https://metamug.com/downloads/how-to-use-metamug-api.pdf

Common Problems

A common startup problem is when another program has claimed port 7000, which Metamug is configured to run on by default. To avoid this port conflict, Metamug's port can be changed in conf/server.xml.

If you encounter any problems, please create a support request at: support@metamug.com

Start Building REST APIs

Once you get the Metamug Console running, you can create a backend connected to your database, save a resource and your REST API will be deployed within seconds!

The API will be available at

http://localhost:7000/{backendName}/{resourceVersion}/{resourceName}

Read this for more on making API requests.

Questions?

Ask at Stackoverflow for Metamug:

https://stackoverflow.com/tags/metamug