Shell Commands › Application Control › login (Application Control and Management)--Log Into Application

login (Application Control and Management)--Log Into Application

Access the console of the default component of an application. A single component of the application may be specified to provide the console for the application.

Syntax

application login name [--ssh] [console=text] [--force] [--abort] [command] 

Parameters

name

Name of application whose console is going to be accessed.

--ssh

SSH into the default component of the application (default)

console=text

Access a text console of the default component of the application.

--force

Take control of console (kill existing console)

--abort

Kill existing console (if any)

command

Optional command line to execute. If there is more than one argument, the command must be enclosed in quotes (for example, "ls /tmp"). This argument is only valid if --ssh is specified.

Examples

application login sugarcrm --ssh

SSH into default component of application 'sugarcrm'

application login sugarcrm "ls /tmp"

SSH into default component of application 'sugarcrm' and execute ls /tmp

Note: A single application component may be specified as the default login console by right-clicking on the component within the CA AppLogic for System z® Editor and selecting "Set Default Console" from the context menu.

When no console options are specified, login to the application using the default console that is specified for the application’s default component.

This command will fail if the application or default component is not started.

The ssh login is performed using a special appliances ssh key installed on your grid. This key does not need a passphrase -- it is assumed that if you are logged in on the controller, you are authorized to log in on the appliances. Contact Technical Support if you cannot log in on an appliance or if you believe your appliance key has been compromised and want to have it replaced.

This command is similar to executing comp login app:comp where app:comp is the name of the component that is specified as the default console of the application.

Only one console type may be specified – ssh or text.

The --force and --abort options are only valid for text consoles.

Whenever a user logs into an appliance, CA AppLogic for System z® creates an environment variable named _APPLOGIC_USERID which contains the name of the user that logged into the appliance. This is only valid if the appliance uses the dhcp configuration mode (APK).

Notes:

The graphical console is not yet available on CA AppLogic for System z®. Providing “console=graphic” as an argument to “application login” will result in an error and failure of the command.