Name
[Windows Manager]
Installation_folder\SVROR\Manager\bin\rcxlogin - Logs in to Resource Orchestrator
[Linux Manager]
/opt/FJSVrcvmr/bin/rcxlogin - Logs in to Resource Orchestrator
Format
rcxlogin [-save] user_name
Description
rcxlogin is the command used to authenticate users in Resource Orchestrator.
If you are using commands for which administrative privileges are required, first use this command to log in as a user with administrative privileges.
If a user already has administrative privileges within the operating system, it is not necessary for that user to execute this command in order to use Resource Orchestrator commands.
If a user has no administrative privileges, to use the commands explained in "Chapter 3 Resource Operations" through "Chapter 8 L-Server Template Operations", log in with the rcxlogin command beforehand.
Specify a user ID that has been registered in Resource Orchestrator. You will then be asked to enter the password of the specified user.
If the correct password is entered, a new command prompt will be displayed showing that the authentication succeeded.
If an invalid password or user ID is entered, an error message is displayed.
To log off, execute the exit command. To log in as a different user without logging off, re-execute the rcxlogin command.
Option
Saves the entered password. This password is remembered only for the user account (within the operating system) used to execute this command. Once a password has been saved for a given user account, this command can then be executed from the same account without being asked for a password again.
Saving the password also allows scripts to use commands for which administrative privileges are required.
Refer to "Automation Using Scripts" in the "Examples" section for details.
Note
Saving the password makes it possible to log in to Resource Orchestrator just by logging in to the operating system user account for which the password was saved. When using this function, ensure that strict control is exercised over this user account on the admin server.
In a clustered manager configuration, use the following procedure to save the password on both the primary and secondary cluster nodes.
[Windows Manager]
Start the cluster service on the primary node.
In the Failover Cluster Management tree, right-click [RC-manager] under [Services and Applications], and select [Bring this service or application online] from the popup menu.
Confirm that all resources are turned online.
Run the rcxlogin -save user_name command on the primary node.
Move the manager "service or application" to the secondary node.
Confirm that all resources are turned online on the secondary node.
Run the rcxlogin -save user_name command on the secondary node.
Move the manager "service or application" back to the primary node.
Confirm that all resources are turned online on the primary node.
[Linux Manager]
Start the cluster service on the primary node.
Use the cluster system's operation management view (Cluster Admin) and start the cluster service of the manager.
Confirm that all resources are turned online.
Run the rcxlogin -save user_name command on the primary node.
Use the cluster system's operation management view (Cluster Admin) and switch to the secondary node.
Confirm that all resources are turned online on the secondary node.
Run the rcxlogin -save user_name command on the secondary node.
Use the cluster system's operation management view (Cluster Admin) and switch to the primary node.
Confirm that all resources are turned online on the primary node.
For a user account with OS administrative privileges, Resource Orchestrator commands can be executed freely without needing to save a password first.
Requirements
Not required.
Admin server
Examples
Logging in Using Password Authentication
>rcxlogin userA <RETURN> |
Automation Using Scripts
To use commands requiring administrative privileges from within a script, thus allowing automated calls from external products, the user account's password must be registered in advance using the rcxlogin -save command.
Within the script, the RCX_USER environment variable must be defined and set to the user ID of the account for which the password was saved.
Once this variable is properly set, Resource Orchestrator commands can be executed using the previously saved password.
Note
The script must be executed by the operating system user account that was used to save the password on the admin server.
Example
Script (batch file) content:
[Windows Manager]
@echo off |
[Linux Manager]
#!/bin/sh |
Exit Status
This command returns the following values:
The command executed successfully.
An error has occurred.
