artexremset command executes artexset command on one or more remote systems.
artexremset [ [ [ [ [-q] [-c] [-r] [-R] ] | -t | -p] [-l {dynamic | noreboot | reboot | all} ] ]
| -b | -x | -u] [-L] [-D] profile {clientname | nim_mac_group}
artexremset [-q] [-c] [-r] [-R] [-l {dynamic | noreboot | reboot | all} ] [-L] [-D]
profile {clientname | nim_mac_group}
artexremset [-l {dynamic | noreboot | reboot | all} ] -t [-L] [-D] profile {clientname | nim_mac_group}
artexremset [-l {dynamic | noreboot | reboot | all} ] -p [-L] [-D] profile {clientname | nim_mac_group}
artexremset -b [-L] [-D] profile {clientname | nim_mac_group}
artexremset -x [-D] {clientname | nim_mac_group}
artexremset -u [-D] {clientname | nim_mac_group}artexremset provides the ability to execute artexset commands on each client with a designated profile provided by the server or a profile stored on an LDAP server. Therefore, all the command options designated for the local artexset command must also be provided by the server so these options can be directly conveyed to each client’s local artexset command.
The artexremset command runs only on NIM master. When the profile is on NIM master, the artexremset command copies the profile to a remote client machine prior to requesting the client to execute artexset command. When the –L option is specified, the profile name given is assumed to be the pathname to a profile that exists in LDAP. Thus, no profile is copied to the client from NIM master. Instead, the LDAP pathname is packaged in the custom script file and the local artexset command should realize that the ldap:// prefix represents an LDAP file.
By default, the exit status of the artexremset command will be a cumulative “OR” of all the remote artexset commands. With the –D option, the results of each individual NIM command result is captured and associated with each individual node and listed in a stdout listing.
| Item | Description |
|---|---|
| -q | Indicates to ignore non-fatal warning messages. |
| -c | Indicates to verify that the artexset command set the values and that they were successfully applied to the system. |
| -r | If the -c option indicates that not all parameters were applied successfully, the -r option indicates to rollback the parameter values for the specified profile to their original state. To do this, the command applies the values stored in the latest_rollback.xml file. |
| -l { dynamic | noreboot | reboot | all} | Indicates the level to which to apply the command.
The -l flag has the following options:
|
| -R | Specifies to not create a rollback profile. |
| -b | Indicates to enable the master profile, which is also referred to as the boot profile. |
| -x | Indicates to disable the master profile, which is also referred to as the boot profile. This flag is the opposite of the -b option. If the -x option is specified, no profile parameter is required. |
| -t | Indicates to test if the values listed in the profile are valid tunables, as recognized by the runtime system. |
| -p | Generates XML output that includes the parameters and values from the profile that are different from the system. This option is valid only when the comparison is between a profile and a system. |
| -u | Indicates to rollback the parameter values of the last applied profile, as they were prior to issuing the last artexset command. To do this, the command applies the values stored in the /etc/security/artex/latest_rollback.xml file. If the -u option is specified, no profile parameter is required. |
| -L | Instructs each individual AIX® Runtime Expert client to download the profile from an LDAP repository designated by the profile string. |
| -D | Indicates to output the results of the remote artexset command associated with each individual node. |
| Item | Description |
|---|---|
| profile | This is a mandatory file, except when the -x or -u option is specified. The file specified includes a list of the tunable parameters. |
| clientname | nim_mac_group | The name of the client node or pre-defined NIM machine groups. |
Individual error messages from the resulting NIM commands are masked unless the -D option is used. A cumulative return value that consists of an “OR” of all the individual nodes or groups is retuned by the artexremset command.
| Item | Description |
|---|---|
| 0 | The command completed successfully |
| >0 | An error occurred. |
The following example illustrates how to execute the artexset command on a client machine, using a profile located on NIM master.
artexremset nim_profile.xml client1The following example illustrates how to execute the artexset command on multiple client machines, using a profile located on LDAP server.
artexremset –L ldap://profile1.xml client1 mac_group1 client2The following example illustrates how to output the results of the remote artexset command associated with each individual client machine.
artexremset –D profile1.xml client1 client2