artexremset Command

Edit online

Purpose

artexremset command executes artexset command on one or more remote systems.

Syntax

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}

Description

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.

Flags

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:
  • The dynamic variable indicates to apply non-disruptive parameters only.
  • The noreboot variable indicates to apply all parameters that do not need a reboot, and recycle the resources as needed.
  • The reboot variable indicates to apply only the parameters that have reboot constraint
  • The all variable indicates to apply all parameters, including the ones that need reboot.
-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.

Parameters

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.

Exit Status

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.

Examples

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 client1

The 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 client2

The 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