You can start the Application Services CLI from a remote machine.

About this task

As a best practice, run the CLI remotely to reduce server load and avoid shared CLI on the Application Services appliance. The connection from the remote machine to the CLI is secured.

Some CLI commands use names of business groups or deployments that can contain non-English characters. To display these characters, you must run the CLI in a fully internationalized shell client or terminal interface such as Putty or iTerm2. Also set the environment variable LC_CTYPE to en_US.UTF-8 to enable non-English character input.

If you log on to the CLI with su - root, the variable is set automatically. If you omit the hyphen and log on with su root, you must set the variable with the following command.

export LC_CTYPE=en_US.UTF-8; 	 
		

Prerequisites

  • Verify that you know the password for the Application Services appliance.

  • Verify that you installed Java JRE 1.7 on your remote machine.

  • Make sure that the remote machine can connect to the Application Services appliance using HTTPS.

Procedure

  1. Download the darwin-cli.jar file from the Application Services server http://DarwinServerIP/tools/darwin-cli.jar to a folder with write permissions on the remote machine.

    Replace DarwinServerIP with the Application Services server IP address.

    The CLI creates a log file during the session.

  2. Open a command prompt and start the client.
    java -jar /PathToJarFolder/darwin-cli.jar

    The Darwin CLI banner appears and the appd> CLI prompt appears.

  3. Log in to the Application Services server.
    login --serverUrl https://DarwinServerIP:8443/darwin --username UserName --password password 
    --tenantId tenantid

    If you run the --password parameter with the login command or a command that lets you add a password, your password is saved as plain text in the darwin-cli-history.log file located in the current directory. By default, the CLI deletes the log file. For added security, delete this log file.

    If you omit the --password parameter, the system prompts you to enter a password. The system does not save your password as plain text.

    The --tenantId parameter logs you in to the tenant identified by the tenant name tenantid. If you omit the --tenantId parameter, the tenant is the default vsphere.local.

Results

The command line prompt displays your user name, domain, and tenant.