cpca_client set_mgmt

cpca_client set_mgmt_tool

Description

Controls the ICA Management Tool.

See:

Important - On Multi-Domain Server, you must run this command in the context of the relevant Domain Management Server.

Syntax

cpca_client [-d] set_mgmt_tool {on | off | add | remove | clean | print} [-p <CA port number>] {[-a <Administrator DN>] | [-u <User DN>] | [-c <Custom User DN>]}

Parameters

Parameter	Description
`-d`	Runs the command in debug mode. Use only if you troubleshoot the command itself.
`on`	Starts the ICA Management Tool.
`off`	Stops the ICA Management Tool.
`add`	Adds the specified administrator, user, or custom user that is permitted to use the ICA Management Tool.
`remove`	Removes the specified administrator, user, or custom user that is permitted to use the ICA Management Tool.
`clean`	Removes all administrators, users, or custom users that are permitted to use the ICA Management Tool.
`print`	Shows the configured administrators, users, or custom users that are permitted to use the ICA Management Tool.
`-p <`CA port number`>`	Optional. Specifies the TCP port on the Security Management Server or Domain Management Server, which is used to connect to the Certificate Authority. The default TCP port number is 18265.
`-a <`Administrator DN`>`	Optional. Specifies the DN of the administrator that is permitted to use the ICA Management Tool. Must specify the full DN as appears in SmartConsole: Open Object Explorer > Users > Administrator or User object properties > click Certificates pane > select the certificate and click the pencil icon > click View certificate details > in the Certificate Info window, click the Details tab > click the Subject field > concatenate all fields. Example: `-a "CN=ICA_Tool_Admin,OU=users,O=MGMT.s6t98x"`
`-u <`User DN`>`	Optional. Specifies the DN of the user that is permitted to use the ICA Management Tool. Must specify the full DN as appears in SmartConsole: Open Object Explorer > Users > User object properties > click Certificates pane > select the certificate and click the pencil icon > click View certificate details > in the Certificate Info window, click the Details tab > click the Subject field > concatenate all fields. Example: `-u "CN=ICA_Tool_User,OU=users,O=MGMT.s6t98x"`
`-c <`Custom User DN`>`	Optional. Specifies the DN for the custom user that is permitted to use the ICA Management Tool. Must specify the full DN as appears in SmartConsole: Open Object Explorer > Users > User object properties > click Certificates pane > select the certificate and click the pencil icon > click View certificate details > in the Certificate Info window, click the Details tab > click the Subject field > concatenate all fields. Example: `-c "CN=ICA_Tool_User,OU=users,O=MGMT.s6t98x"`

Note - If you run the 'cpca_client set_mgmt_tool' command without the parameter '-a', or '-u', the list of the permitted administrators and users is not changed. The previously defined permitted administrators and users can start and stop the ICA Management Tool.