Starting up, shutting down, and restarting your instance
This page will show you how to start up, shutdown, and restart Martini. Martini includes a variety of ways to perform these operations:
- CLI script
- CLI tool
- Martini Runtime Admin UI
- Martini Desktop
- REST endpoints
- Windows Services Manager
Using the CLI script
One of the most common ways to start and stop Martini is by executing the provided CLI script. You can also pass arguments to the following scripts to specify how you want to start Martini.
- For Windows:
<martini-home>\bin\toro-martini.bat
- For Unix or macOS:
<martini-home>/bin/toro-martini
Argument | Description |
---|---|
run | Default. Starts Martini. |
start | Starts Martini without outputting the logs to the terminal. |
debug | Starts Martini with the underlying JDK in debug mode. |
stop | Shuts down Martini. |
For example:
1 |
|
Using the CLI tool
The shutdown
and restart
commands are also available in the CLI tool. Take note that in order to use
these commands, the CLI tool needs to be connected to a Martini instance.
Command | Description |
---|---|
shutdown | Shuts down Martini |
restart | Restarts Martini |
The --now
argument is required for both commands.
Using the Martini Runtime Admin interface
The Martini Runtime Admin interface also provides a way to shutdown or restart a Martini instance. To do this, click the power icon in the top right of the interface (beside the user icon) and choose Restart or Shutdown.
Using Martini Desktop
Shutdown and restart operations are provided in Martini Desktop. To shutdown or restart Martini via Martini Desktop follow these steps:
- Right click the Martini instance in Navigator view; this will show the context menu with the actions applicable for the instance.
-
Select Shut Down or Restart.
Using RESTful web services
Martini also provides REST endpoints for shutting down and restarting.
Send a PUT
request to the following endpoints to shutdown or restart Martini.
<martini-base-url>/esbapi/system/shutdown
<martini-base-url>/esbapi/system/restart
Authentication required
The endpoints above require authentication. You can read more about supported
authentication schemes, which are Basic and OAuth2. A user who
invokes these endpoints must be in the ESBAPIAdminGroup
user group.
Using the Windows Services Manager
If Martini has been installed as a service in Windows, it can be started, stopped, or restarted like a normal Windows service. To start, stop, or restart Martini via the Windows Services Manager, follow these steps:
- Open the start menu.
-
Type 'services'.
-
Find the service named 'Martini Runtime' and double-click it.
Martini can be started, stopped, or restarted using the window above. These operations can also be done by clicking the hyperlinks in the sidebar.
Windows only
This applies for Windows only. Martini should also be installed as a service.