Stackato Client

The stackato client is the command-line interface to Stackato. You can use it to push application code up to the server, start and stop applications, create data services and link them to applications, and a number of other application management operations.

The Command Reference has full descriptions of all client commands and options. These details are also available at the command line via the stackato help command.

Stackato Client Setup

The Stackato Client is available for download or via:

• ActivePython: pypm install stackato

When installing using pypm, the stackato client will be added to your system path automatically.

If you have downloaded the executable:

• Rename the downloaded file to stackato

• Put it in system/shell PATH directory, add it to your PATH, or create a symlink to it

• For Linux or Mac OS X:

  • Make sure that it is executable (i.e. chmod +x stackato)
  • On some systems read access is necessary, in which case try chmod 755 stackato

Getting Help

To get a list of available commands or help on a particular command:

$ stackato help [COMMAND]

See also the Command Reference for a full list of commands.

Accessing the Micro Cloud

If you are using the Sandbox, skip ahead to Accessing the Sandbox.

Before you can use the client, you must set the target URL. This tells the stackato client where it will be pushing applications. The default target URL for the Stackato Server micro cloud VM is api.stackato-xxxx.local:

$ stackato target api.stackato-xxxx.local

Note

This hostname is generated dynamically, made up of a set of alphanumeric characters where the xxxx is shown, and can be found in the Server VM window when it starts up, or by using the stackato-admin info command.

If you have configured the hostname and DNS of the Stackato Server manually, or are connecting to a server administered by someone else, connect to the assigned hostname (e.g. api.myserver.mydomain.com).