login (Application Control and Management)--Login to a Component

Shell Commands › Component Control › login (Application Control and Management)--Login to a Component

login (Application Control and Management)--Login to a Component

Syntax

component login name [--ssh] [console=text|graphic] [--force] [--abort] [command]

Parameters

name: Name of component to login to
--ssh: SSH into component (default)
console=text: Access text console
--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

component login sugarcrm:main.config: SSH into component 'main.config' in application 'sugarcrm'
component login sugarcrm:main.config "ls /tmp": SSH into component 'main.config' in application 'sugarcrm' and execute ls /tmp
component login sugarcrm:main.config console=text: Access text boot console of appliance instance.

Notes:

This command will fail if the component is not started.
When no command line options are specified, login to the component using the default console that is specified for the component.
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.
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.

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).