h5. Name
{{agentadm - to manipulate xVM Ops Center agent services}}
h5. Synopsis
On Solaris:
BASE ={{/opt/SUNWxvmoc}}
On Linux:
BASE = {{/opt/sun/xvmoc}}
h6. Usage
{{<BASE>}}{{/bin/agentadm {-V \| \--version } { -q \| \--quiet \] \[ \-v \| \--verbose \] \[ \-f \| \--force \] \[ \-n \| \--norefresh \] \[ \-o \| \--output-file \] \[ \-h \| \--help\]}}
{{<BASE>}}{{/bin/agentadm subcommand \[ options \]}}
h5. Description
The {{agentadm}} command helps to manage the xVM Ops Center agents such as registering the agent to the proxy and unconfiguring the agents.
h5. Options
The following common options are supported:
* \-V* *\| \--version*: Displays the version number of {{agentadm}}.
* \-h* *\| \--help*: Displays the usage synopsis for all configuration steps supported by {{agentadm}}.
{quote}
{quote}
* \-v* *\| \--verbose*: Display verbose error and informational messages. Use multiple occurrences of this option to increase the verbosity level
*\-q* *\| \--quiet*: Does not display anything and returns only the return code.
* \-f* *\| \--force*: Ignores non critical errors during steps operations.
* \-n* *\| \--norefresh*: Does not overwrite the existing operation.
* \-o* *\| \--output-file*: Sends the output to the specified logfile.
h5. Subcommands
The subcommands of {{agentadm}} are as follows:
h5. Usage
Equivalent to {{\[ \-h \| \--help\]}}
h6. configure
The configuration step consists of:
* sc-console registration of the agent to proxy.
* scn-agent cacao instance creation.
* uce-agent cacao instance creation.
* Registration of the agent's products to the proxy.
The registration of the agent to the proxy is as follows:
{{<BASE>/bin/agentadm configure \[ \-u \| \--user _<username>_ \] \[ \-p \| \--passwordfile _<passwordfile>_ \] \[ \-t \| \--token _<tokenfilename>_ \] \[ \-x \| \--proxy _<URI>_ \] \[ \-I \| \--non-interactive \] \[ \--registration-domain-name _<domainname>_ \] \[ \--register-os \]}}
{quote}
*\-u \| \--user* *_<username>_*: Use the Sun Online Account (SOA) username.
*\-p \| \--passwordfile* *_<passwordfile>_*: Filename with the SOA credentials.
*\-t \| \--token* *_<tokenfilename>_*: Filename containing auto registration token.
*\-x \| \--proxy* *_<URI>_*: URI of the proxy to be registered.
*\-I \| \--non-interactive*: Launch sc-console in non-interactive mode (without \-i). Default is interactive mode.
*\--registration-domain-name* *_<domainname>_*: The domain with which to register the products.
*\--register-os*: Registration of the OS product.
h6. unconfigure
Performs the inverse operation of configuring the agent.
{{<BASE>/bin/agentadm unconfigure}}
h5.
{quote}
{quote}
{{agentadm - to manipulate xVM Ops Center agent services}}
h5. Synopsis
On Solaris:
BASE ={{/opt/SUNWxvmoc}}
On Linux:
BASE = {{/opt/sun/xvmoc}}
h6. Usage
{{<BASE>}}{{/bin/agentadm {-V \| \--version } { -q \| \--quiet \] \[ \-v \| \--verbose \] \[ \-f \| \--force \] \[ \-n \| \--norefresh \] \[ \-o \| \--output-file \] \[ \-h \| \--help\]}}
{{<BASE>}}{{/bin/agentadm subcommand \[ options \]}}
h5. Description
The {{agentadm}} command helps to manage the xVM Ops Center agents such as registering the agent to the proxy and unconfiguring the agents.
h5. Options
The following common options are supported:
* \-V* *\| \--version*: Displays the version number of {{agentadm}}.
* \-h* *\| \--help*: Displays the usage synopsis for all configuration steps supported by {{agentadm}}.
{quote}
{quote}
* \-v* *\| \--verbose*: Display verbose error and informational messages. Use multiple occurrences of this option to increase the verbosity level
*\-q* *\| \--quiet*: Does not display anything and returns only the return code.
* \-f* *\| \--force*: Ignores non critical errors during steps operations.
* \-n* *\| \--norefresh*: Does not overwrite the existing operation.
* \-o* *\| \--output-file*: Sends the output to the specified logfile.
h5. Subcommands
The subcommands of {{agentadm}} are as follows:
h5. Usage
Equivalent to {{\[ \-h \| \--help\]}}
h6. configure
The configuration step consists of:
* sc-console registration of the agent to proxy.
* scn-agent cacao instance creation.
* uce-agent cacao instance creation.
* Registration of the agent's products to the proxy.
The registration of the agent to the proxy is as follows:
{{<BASE>/bin/agentadm configure \[ \-u \| \--user _<username>_ \] \[ \-p \| \--passwordfile _<passwordfile>_ \] \[ \-t \| \--token _<tokenfilename>_ \] \[ \-x \| \--proxy _<URI>_ \] \[ \-I \| \--non-interactive \] \[ \--registration-domain-name _<domainname>_ \] \[ \--register-os \]}}
{quote}
*\-u \| \--user* *_<username>_*: Use the Sun Online Account (SOA) username.
*\-p \| \--passwordfile* *_<passwordfile>_*: Filename with the SOA credentials.
*\-t \| \--token* *_<tokenfilename>_*: Filename containing auto registration token.
*\-x \| \--proxy* *_<URI>_*: URI of the proxy to be registered.
*\-I \| \--non-interactive*: Launch sc-console in non-interactive mode (without \-i). Default is interactive mode.
*\--registration-domain-name* *_<domainname>_*: The domain with which to register the products.
*\--register-os*: Registration of the OS product.
h6. unconfigure
Performs the inverse operation of configuring the agent.
{{<BASE>/bin/agentadm unconfigure}}
h5.
{quote}
{quote}