sagcc get configuration data
Retrieves data for a specified configuration instance that belongs to a specified run-time component. For example, you might want to retrieve the data for an instance of a configured port. The retrieved data for an instance of a port might include whether the port is enabled, the port number, and the port’s protocol.
Syntax
Command Central syntax:
sagcc get configuration data node_alias componentid instanceid
[sharedsecret=text_string] [options]
Platform Manager syntax:
sagcc get configuration data componentid instanceid
[sharedsecret=text_string] [options]
options:
[{--accept | -a} content_type]
[{--debug | -d}]
[{--error | -r} file]
[{--format | -f} {text | xml | json}]
[{--log | -l} file]
[{--output | -o} file]
[{--password | -p} password]
[{--quiet | -q}]
[{--server | -s} url]
[{--username | -u} user_name]
Arguments and Options
Argument or Option | Description |
node_alias | Command Central only. Required. Specifies the alias name of the installation in which the run-time component is installed. |
componentid | Required. Specifies the ID of the run-time component for which you want to retrieve instance data. |
instanceid | Required. Specifies the ID of the instance for which you want to retrieve data. |
[sharedsecret=text_string] | Optional. Specify a shared secret password that Platform Manager uses to secure any passwords in the configuration data that you want to retrieve. If you omit this parameter, Platform Manager retrieves the configuration data using the shared secret defined for the environment or for the whole landscape. For more information, see
sagcc add security credentials
sharedsecret. If Platform Manager cannot find a shared secret that matches the shared secret specified when creating the configuration instance, Platform Manager does not include the passwords that the configuration contains in the output. When you omit this parameter: If the command is executed on Command Central, Platform Manager retrieves the configuration data using the shared secret defined for the environment or for the whole landscape. For more information, see
sagcc add security credentials
sharedsecret. If the command is executed on Platform Manager, Platform Manager does not include the passwords that the configuration contains in the output. |
[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
If you do not specify the
{--format | -f} option, the default output format is based on from where you execute the command:
If you execute the command from the command line, a batch script, or a shell script, the default format is plain text format.
If you execute the command from an Ant script, the default format is XML format.
Example When Executing on Command Central
To execute a command on the
Command Central server with host name “rubicon” and port “8090” to retrieve instance data for the configuration instance with ID “COMMON-PORTS-com.softwareag.sshd.pid.properties” that belongs to the run-time component that has the ID “OSGI-SPM” and runs in the installation with alias name “sag01”, using the authorization of the user with user name “Administrator” and password “manage”, and have the information displayed on the console in XML format:
sagcc get configuration data sag01 OSGI-SPM COMMON-PORTS-
com.softwareag.sshd.pid.properties --format xml
--server http://rubicon:8090/cce --username Administrator
--password manage
To retrieve instance data for the configuration instance with ID “COMMON-PROXY” that belongs to the run-time component with ID “OSGI-SPM” and runs in the installation with alias name “sag01”, using “mysecret123” as the shared secret to secure the proxy configuration password, and save the configuration data with the encrypted password in the “configWithEncryptedData.xml” file:
sagcc get configuration data sag01 OSGI-SPM COMMON-PROXY
sharedsecret=mysecret123 --output
configWithEncryptedData.xml
Example When Executing on Platform Manager
To retrieve instance data for the configuration instance with ID “COMMON-PORTS-com.softwareag.sshd.pid.properties” that belongs to the run-time component that has the ID “OSGI-SPM” and is managed by the Platform Manager with host name “rubicon2” and port “8092”, and have the information returned to the output file “port_data” in XML format:
sagcc get configuration data OSGI-SPM COMMON-PORTS-
com.softwareag.sshd.pid.properties --output port_data --format xml
--server http://rubicon2:8092/spm
Because the
{--username | -u} and
{--password | -p} options are not specified, the command uses the default user name and password. For more information, see
username and
password.