Skip to content

Toro Cloud Dev Center

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:

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:

$ <martini-home>/bin/toro-martini run

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.

Shutting down or restarting via the Martini Runtime Admin interface

Using Martini Desktop

Shutdown and restart operations are provided in Martini Desktop. To shutdown or restart Martini via Martini Desktop follow these steps:

  1. Right click the Martini instance in Navigator view; this will show the context menu with the actions applicable for the instance.
  2. Select Shut Down or Restart.

    Instance context menu

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:

  1. Open the start menu.
  2. Type 'services'.

    Launching the Windows Services Manager

  3. Find the service named 'Martini Runtime' and double-click it.

    Martini Runtime as a service in Windows

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.