sagcc add security credentials
Adds security credentials for an installation or run-time component. Command Central does not store security credentials for run-time components. Command Central only stores the credentials it uses to connect to Platform Manager nodes. When adding security credentials for all run-time components, Command Central propagates the credentials to the run-time component installation. Command Central does not propagate only the credentials for the connection between Command Central and the Platform Manager installation.
Syntax
Command Central syntax:
With parameters
sagcc add security credentials nodeAlias=node_alias
[runtimeComponentId=componentid]
authenticationType={NONE|BASIC|TRUSTED} [username=username]
[password=password] [options]
With input file
sagcc add security credentials nodeAlias=node_alias
[runtimeComponentId=componentid] {--input | -i} file{.xml|.json}
[options]
options:
[{--debug | -d}]
[{--error | -r} file]
[{--log | -l} file]
[{--password | -p} password]
[{--quiet | -q}]
[{--server | -s} url]]
[{--username | -u} user_name]
Not supported by
Platform ManagerArguments and Options
Argument or Option | Description |
nodeAlias=node_alias | Required. Specifies the alias name of the installation for which you want to associate the security credentials. |
[runtimeComponentId=componentid] | Optional. Specifies the run-time component for which you want to associate the security credentials. Important: When configuring the credentials used for communication between Command Central and the Platform Manager installation, set this argument as follows: runtimeComponentId=SPM-CONNECTION. |
authenticationType={NONE|BASIC|TRUSTED} | Required when you use the command syntax with parameters. Specifies the authentication type to use for the run-time component. Valid values: NONE BASIC - use basic authentication TRUSTED - use trusted authentication |
[username=username] | Optional. Specifies the user name to use when the authentication type is set to BASIC. |
[password=password] | Optional. Specifies the password to use when the authentication type is set to BASIC. |
{--input | -i} file{.xml|.json} | Required when you use the command syntax with input file. Identifies an input file that contains the data for the security credentials. For more information, see input. |
[options] | Optional. Refer to the command syntax for a list of the options the command supports. For a description of the options, see Common Options. |
Usage Notes
By default, if you omit an argument, the command applies the credentials to all items. For example, if you omit the
[runtimeComponentId=componentid] argument, the command applies the credentials to all run-time components.
You can set different credentials for the
Platform Manager servers in your landscape using the
Command Central web user interface or the command line tool. For example, you can configure
Command Central to connect to one
Platform Manager as “Administrator1/manage1” and the second
Platform Manager server as “Administrator2/manage2”. For example:
sagcc add security credentials runtimeComponentId=SPM-CONNECTION
nodeAlias=sag01 --input c:\inputs\creds_data.xml
Note: This command will not return an error. However, Command Central does not use the supplied credentials for connection to specified Platform Manager on the specified installation.
Examples When Executing on Command Central
In the following examples, because the
{--server | -s} and
{--username | -u} options are not specified, the commands use the default server and user name. For more information, see
server and
username. The commands specify “secret” for the user’s password.
To update the security credentials used for the communication between
Command Central and the
Platform Manager installed in the installation with alias name “sag01”, using authentication type “BASIC”:
sagcc add security credentials nodeAlias=sag01
runtimeComponentId=SPM-CONNECTION
authenticationType=BASIC username=Administrator password=secret
To update the security credentials used for the communication between
Command Central and the
Platform Manager installed in the installation with alias name “sag01”, using an input file:
After changing the
Command Central default administrator password, create the c:\inputs\credentials_osgi.xml file. Open the credentials_osgi.xml file and include the updated security credentials for the run-time component with ID “SPM-CONNECTION”.
Execute the following command:
sagcc add security credentials nodeAlias=sag01
runtimeComponentId=SPM-CONNECTION --input credentials_osgi.xml
-p newpassword
To update the security credentials for a run-time component with ID “MwsProgramFiles” installed in the installation with alias name “sag01”, using trusted authentication:
sagcc add security credentials nodeAlias=sag01
runtimeComponentId=MwsProgramFiles
authenticationType=TRUSTED
Security credentials data is in the c:\inputs\creds_data.xml file. To add security credentials for all
Integration Server run-time components on all installations:
sagcc add security credentials runtimeComponentId=IntegrationServer_instanceName
--input c:\inputs\creds_data.xml --password secret
Security credentials data is in the c:\inputs\creds_data.xml file. To add security credentials for the
Integration Server run-time components on installations with alias names “sag01” and “sag02”, use the following two commands:
sagcc add security credentials nodeAlias=sag01
runtimeComponentId=IntegrationServer_instanceName
--input c:\inputs\creds_data.xml --password secret
sagcc add security credentials nodeAlias=sag02
runtimeComponentId=IntegrationServer_instanceName
--input c:\inputs\creds_data.xml --password secret