This option is only valid when backing up the data to a remote NFS file system. Display the help text for this command and exit.

Transcription

1 NAME bkconsdata - back up console data SYNOPSIS bkconsdata -r {dvd ftp nfs} [-h host-name] [-u user-id] [--passwd password] [-l mount-resource-location] [-o "mount-command-options"] [--help] DESCRIPTION bkconsdata backs up critical Hardware Management Console (HMC) data, which is HMC data that is stored on the HMC hard disk. This backup data may be used to restore the HMC if the HMC needs to be reinstalled from the HMC recovery CDs in the event of an HMC hard disk failure. OPTIONS -r The archive option for the backup data. Valid values are dvd for the DVD drive on the HMC, ftp for a remote FTP site, or nfs for an NFS mounted remote file system. -h The host name or IP address of the remote FTP or NFS server. This option is required when backing up the data to a remote FTP site or NFS file system. Otherwise, this option is not valid. -u The user ID to use to log in to the remote FTP site. This option is required when backing up the data to a remote FTP site. Otherwise, this option is not valid. --passwd The password to use to log in to the remote FTP site. If this option is omitted, you will be prompted to enter the password. This option is only valid when backing up the data to a remote FTP site. -l The mount resource location defined on the NFS server where the backup data will be written. This option is required when backing up the data to a remote NFS file system. Otherwise, this option is not valid. -o Options to be passed to the mount command used to mount the remote NFS file system where the backup data will be written. The options must be enclosed in double quotes. --help This option is only valid when backing up the data to a remote NFS file system. Display the help text for this command and exit. EXAMPLES Back up critical HMC data to DVD: bkconsdata -r dvd Back up critical HMC data to a remote FTP site: bkconsdata -r ftp -h ftpserver -u ftpuser --passwd ftppassword Back up critical HMC data to an NFS mounted remote file system: bkconsdata -r nfs -h l /home/hmc/backups Linux May

2 ENVIRONMENT BUGS AUTHOR IBM Austin Linux May

3 NAME bkprofdata - back up profile data SYNOPSIS bkprofdata -m managed-system -f file [--help] DESCRIPTION bkprofdata backs up profile data for the managed-system. The rstprofdata command can be used to restore profile data for the managed-system. OPTIONS -m The name of the managed system for which to back up profile data. The name may either be the user-defined name for the managed system, or be in the form tttt-mmm*ssssssss, where tttt is the machine type, mmm is the model, and ssssssss is the serial number of the managed system. The tttt-mmm*ssssssss form must be used if there are multiple managed systems with the same userdefined name. -f The name of the backup file where the profile data is to be written. If file is not fully qualified, file will be written to the /var/hsc/profiles/serial-number directory on the HMC (serial-number is the serial number of the managed system). --help Display the help text for this command and exit. EXAMPLES Back up the profile data to a file called myfile. A floppy diskette must have already been inserted into the diskette drive and the mount command must have already been issued: bkprofdata -m mysystem -f /mnt/floppy/myfile Back up the profile data to a file called backup1. The file will be written to the /var/hsc/profiles/ directory on the HMC: bkprofdata -m * f backup1 ENVIRONMENT BUGS AUTHOR IBM Austin SEE ALSO rstprofdata Linux August

4 NAME chaccfg - change access control configuration SYNOPSIS chaccfg -t {resourcerole taskrole} {-f configuration-file -i "configuration-data"} [--help] DESCRIPTION chaccfg changes the configuration of an access control role. OPTIONS -t The type of access control role to change. Valid values are resourcerole for managed resource role and taskrole for task role. -f The name of the file containing the configuration data needed to change the access control role. The configuration data consists of attribute name/value pairs, which are in comma separated value (CSV) format. These attribute name/value pairs form a configuration record. A line feed marks the end of a configuration record. There can only be one configuration record in the file. The format of a configuration record is as follows: attribute-name=value,attribute-name=value,...<lf> Note that certain attributes accept a comma separated list of values, as follows: "attribute-name=value,value,...",...<lf> When a list of values is specified, the attribute name/value pair must be enclosed in double quotes. Depending on the shell being used, nested double quote characters may need to be preceded by an escape character, which is usually a \ character. If += is used in the attribute name/value pair instead of =, then the specified value is added to the existing value for the attribute if the attribute is numerical. If the attribute is a list, then the specified value(s) is added to the existing list. If -= is used in the attribute name/value pair instead of =, then the specified value is subtracted from the existing value for the attribute if the attribute is numerical. If the attribute is a list, then the specified value(s) is deleted from the existing list. The += and -= operators can only be used when changing a managed resource role. Attribute names for managed resource roles: name name of the managed resource role to change (required) resources comma separated list of managed resource objects (required) Attribute names for task roles: name name of the task role to change (required) resources comma separated list of tasks (required) parent Linux May

5 name of the parent task role on which to base this task role (optional). Valid values are hmcsuperadmin, hmcoperator, hmcviewer, hmcpe, hmcservicerep, ora user-defined task role. The -f and the -i options are mutually exclusive. -i This option allows you to enter configuration data on the command line, instead of using a file. Data entered on the command line must follow the same format as data in a file, and must be enclosed in double quotes. --help The -i and the -f options are mutually exclusive. Display the help text for this command and exit. EXAMPLES Change the managed resource objects for the managed resource role lpar_role where XXX is a resource name returned from lsaccfg -t resource --script: chaccfg -t resourcerole -i "name=lpar_role,resources=xxx" Add a managed resource object to the managed resource role mr1 where XXX is a resource name returned from lsaccfg -t resource --script: chaccfg -t resourcerole -i "name=mr1,resources+=xxx" Change the task role tr1: chaccfg -t taskrole -i "name=tr1,"resources= cec:chhwres+chsysstate,lpar:chhwres+chled+chsyscfg"" Change a task role using the configuration data in the file /tmp/cfgfile: chaccfg -t taskrole -f /tmp/cfgfile ENVIRONMENT BUGS AUTHOR IBM Austin SEE ALSO lsaccfg, mkaccfg, rmaccfg Linux May

6 NAME chcod - change Capacity on Demand SYNOPSIS To enter a CoD code: chcod -o e -m managed-system -k CoD-code To activate On/Off CoD resources: chcod -o a -m managed-system -c onoff -r {mem proc} -q quantity-of-resources -d number-of-days To activate Reserve CoD processors: chcod -o a -m managed-system -c reserve -r proc -q quantity-of-processors To deactivate all On/Off CoD, all Reserve CoD, or all Trial CoD resources: chcod -o d -m managed-system -c {onoff reserve trial} -r {mem proc} DESCRIPTION chcod performs Capacity on Demand (CoD) operations on the managed-system. chcod is used to enter a CoD code for the managed-system. It is also used to activate On/Off CoD and Reserve CoD resources, or to deactivate On/Off CoD, Reserve CoD, or Trial CoD resources. CoD resources are either memory or processors. OPTIONS -o The CoD operation to perform. Valid values are e to enter a CoD code, a to activate On/Off CoD or Reserve CoD resources, and d to deactivate all On/Off CoD, all Reserve CoD, or all Trial CoD resources. To change the number of Reserve CoD processors that are currently activated, specify an activate operation with this option, and specify the total number of activated Reserve CoD processors that you want with the -q option. An activate operation is to be used regardless of whether the total number of activated Reserve CoD processors is being increased or decreased. A deactivate operation is to be used only when you no longer want to have any activated Reserve CoD processors. A deactivate operation will deactivate all Reserve CoD processors. Note that CUoD and Trial CoD resources are activated by entering CoD codes. -m The name of the managed system for which the CoD operation is to be performed. The name may either be the user-defined name for the managed system, or be in the form tttt-mmm*ssssssss, where tttt is the machine type, mmm is the model, and ssssssss is the serial number of the managed system. The tttt-mmm*ssssssss form must be used if there are multiple managed systems with the same user-defined name. -k The CoD code (key) to enter. Letters may be entered in either upper case or lower case. -c The CoD type. Valid values are onoff for On/Off CoD, reserve for Reserve CoD, and trial for Trial CoD. -r The CoD resource type. Valid values are mem for memory and proc for processors. -q The quantity of On/Off CoD or Reserve CoD resources to activate. The value specified must be a whole number which is greater than 0. When activating On/Off CoD memory, the value specified must be in megabytes, and it must be a multiple of 1024 megabytes. Linux August

7 -d The number of days to activate the On/Off CoD resources. The value specified must be a whole number which is greater than 0. --help Display the help text for this command and exit. EXAMPLES Enter a CoD code: chcod -m sys1 -o e -k AlphaNumericString12345 Activate 2 GB of On/Off CoD memory for 10 days: chcod -m *1001CA -o a -c onoff -r mem -q d 10 Activate 2 On/Off CoD processors for 5 days: chcod -m sys1 -o a -c onoff -r proc -q 2 -d 5 Activate 3 Reserve CoD processors: chcod -m *1001CA -o a -c reserve -r proc -q 3 Decrease the number of activated Reserve CoD processors from 3 to 1: chcod -m sys1 -o a -c reserve -r proc -q 1 Deactivate all On/Off CoD processors: chcod -m sys1 -o d -c onoff -r proc Deactivate all Reserve CoD processors: chcod -m sys1 -o d -c reserve -r proc Deactivate all Trial CoD memory and stop the trial: chcod -m *1001CA -o d -c trial -r mem ENVIRONMENT BUGS AUTHOR IBM Austin SEE ALSO lscod Linux August

8 NAME chhmc - change Hardware Management Console configuration information SYNOPSIS To change remote access settings: chhmc -c {ssh http websm xntp} -s {enable disable} [--help] To add or remove an entry in the syslog configuration file: chhmc -c syslog -s {add remove} {-a IP-address -h host-name} [--help] To add or remove an entry in the network time protocol configuration file: chhmc -c xntp -s {add remove} {-a IP-address -h host-name} {--ntpversion 1 2} [-nm network-mask] [-i interface] [--help] To configure whether keyboard mapping configuration will occur at the next reboot: chhmc -c kbdcfg -s {enable disable} [--help] To permit or deny IP addresses from utilizing HMC services: chhmc -c {ssh websm http service} -s {add remove} -a IP-address [-nm network-mask] [-i interface] [--help] If -nm is omitted, the default network mask will be If -i is omitted, the rule will be applied to all interfaces. To add or remove entries from the DNS server search order or the domain suffix search order: chhmc -c network -s {add remove} [-ns DNS-server] [-ds domain-suffix] [--help] To change network settings for a specific network interface: chhmc -c network -s modify -i interface [-a IP-address] Linux May

9 [-nm network-mask] [--lparcomm {on off}] [--help] To change other network settings: chhmc -c network -s modify [-h host-name] [-d network-domain-name] [-g gateway] [--help] DESCRIPTION chhmc changes Hardware Management Console (HMC) configuration information, such as remote access settings and network settings. OPTIONS -c The type of configuration to be modified. Valid values are ssh, websm, http, syslog, xntp, network, and service. -s The new state value of the configuration. Valid values are enable, disable, add, modify, and remove. -i The interface to configure, such as eth0. -a The network IP address. -nm The network mask. --lparcomm The LPAR communication setting for the network interface. -d The network domain name. -h The host name. -g The default gateway IP address. -ns -ds The nameserver IP address to add or remove. The domain suffix to add or remove. --ntpversion The ntp version if the server is not at NTP version 3 and above. --help Display the help text for this command and exit. EXAMPLES To change the Hardware Management Console host name: chhmc -c network -s modify -h mynewhost Linux May

10 To set the IP address and network mask for network interface eth0: chhmc -c network -s modify -i eth0 -a nm To enable remote access via ssh: chhmc -c ssh -s enable To disable remote access via http: chhmc -c http -s disable To enable remote access via websm: chhmc -c websm -s enable To add host myhost.company.com to the syslog configuration file, for remote logging: chhmc -c syslog -s add -a To enable keyboard mapping configuration to occur on the next reboot: chhmc -c kbdcfg -s enable To permit a single IP address to use the ssh service over network interface eth0: chhmc -c ssh -s add -a nm i eth0 To permit a range of IP addresses to use the http service over network interface eth1: chhmc -c http -s add -a nm i eth1 To permit a single IP address to use the websm service over all network interfaces: chhmc -c websm -s add -a nm To enable Network Time Protocol service: chhmc -c xntp -s enable To add a Network Time Protocol server to the configuration file: chhmc -c xntp -s add mytimeserver.company.com Specify the hostname will not change firewall rule settings. It is assumed that the user will use the Customize Network Settings to change firewall settings. To add a Network Time Protocol server to the configuration file, using IP address and at the same time enable firewall access through network interface eth0: chhmc -c xntp -s add -a i eth0 Linux May

11 To remove a Network Time Protocol server from the configuration file: chhmc -c xntp -s remove mytimeserver.company.com ENVIRONMENT BUGS AUTHOR IBM Austin SEE ALSO lshmc Linux May

12 NAME chhmcusr - change a Hardware Management Console user SYNOPSIS chhmcusr -u user-name -t {assign desc name passwd pwage taskrole} [-o {a r}] [-r {resource resourcerole}] [-v new-attribute-value] [--help] DESCRIPTION chhmcusr changes an attribute of a Hardware Management Console (HMC) user. OPTIONS -u The user name of the HMC user to change. -t The user attribute to change. Valid values are assign for the user s access control managed resource object assignment or managed resource role assignment, desc for the user s description, name for the user s user name, passwd for the user s password, pwage for the number of days until the user s password expires, and taskrole for the user s access control task role. -o The managed resource object or role assignment operation to perform. Valid values are a to add a managed resource object or role to the user and r to remove a managed resource object or role from the user. This option is required when changing the user s managed resource object assignment or managed resource role assignment. This option is not valid when changing any other user attribute. -r The type of access control assignment to change. Valid values are resource for managed resource object assignment and resourcerole for managed resource role assignment. This option is required when changing the user s managed resource object assignment or managed resource role assignment. This option is not valid when changing any other user attribute. -v The new value for the attribute being changed. When changing the user s managed resource object assignment, specify the managed resource object to be added or removed. When changing the user s managed resource role assignment, specify the managed resource role to be added or removed. When changing the user s description, specify the new description with this option. The new description can be any string. When changing the user s user name, specify the new user name with this option. The new user name must not be longer than 32 characters, and it must begin with a letter. When changing the user s password, you can either specify the new password with this option, or you can omit this option and you will be prompted to enter the password. The new password must be at least 7 characters in length. When changing the number of days until the user s password expires, specify the new number of days with this option. When changing the user s access control task role, specify the new task role with this option. Valid values are hmcsuperadmin, hmcoperator, hmcviewer, hmcpe, hmcservicerep, or a userdefined task role. This option is required when changing any user attribute other than the user s password. Linux May

13 --help Display the help text for this command and exit. EXAMPLES Add the managed resource role lpar_role to the user hmcuser1: chhmcusr -u hmcuser1 -t assign -o a -r resourcerole -v lpar_role Change the password for the user tester (the new password must be entered when prompted): chhmcusr -u tester -t passwd Change the number of days until the password expires for the user hmcuser1 to be 180: chhmcusr -u hmcuser1 -t pwage -v 180 Change the task role for the user tester to hmcoperator: chhmcusr -u tester -t taskrole -v hmcoperator ENVIRONMENT BUGS AUTHOR IBM Austin SEE ALSO lshmcusr, mkhmcusr, rmhmcusr, lsaccfg Linux May

14 NAME chhwres - change hardware resources SYNOPSIS To add, remove, or move a physical I/O slot: chhwres -r io -m managed-system -o {a r m} {-p partition-name --id partition-id} [{-t target-partition-name --tid target-partition-id}] -l slot-drc-index [-a "attributes"] [-w wait-time] [-d detail-level] [--force] To set physical I/O attributes: chhwres -r io -m managed-system -o s {-p partition-name --id partition-id} --rsubtype {iopool taggedio} -a "attributes" To add or remove a virtual I/O adapter: chhwres -r virtualio -m managed-system -o {a r} {-p partition-name --id partition-id} [--rsubtype {eth scsi serial}] -s virtual-slot-number [-a "attributes"] [-w wait-time] [-d detail-level] [--force] To set virtual I/O attributes: chhwres -r virtualio -m managed-system -o s [{-p partition-name --id partition-id}] --rsubtype {eth hsl virtualopti} -a "attributes" To add, remove, or move memory: chhwres -r mem -m managed-system -o {a r m} {-p partition-name --id partition-id} [{-t target-partition-name --tid target-partition-id}] -q quantity [-w wait-time] [-d detail-level] [--force] To add, remove, or move processing resources: chhwres -r proc -m managed-system -o {a r m} {-p partition-name --id partition-id} [{-t target-partition-name --tid target-partition-id}] [--procs quantity] [--procunits quantity] [--5250cpwpercent percentage] [-w wait-time] [-d detail-level] [--force] To set processing attributes: chhwres -r proc -m managed-system -o s {-p partition-name --id partition-id} -a "attributes" DESCRIPTION chhwres changes the hardware resource configuration of the managed-system. chhwres is used to perform dynamic logical partitioning (DLPAR) operations. Linux December

15 OPTIONS -r The type of hardware resources to change. Valid values are io for physical I/O, virtualio for virtual I/O, mem for memory, and proc for processing resources. --rsubtype The subtype of hardware resources to change. Valid physical I/O resource subtypes are slot for I/O slots, iopool for I/O pools, and taggedio for tagged I/O resources. Valid virtual I/O resource subtypes are eth for virtual ethernet, scsi for virtual SCSI, serial for virtual serial, hsl for High Speed Link (HSL) OptiConnect, and virtualopti for virtual OptiConnect resources. This option is required for physical I/O or virtual I/O set operations, and for virtual I/O add operations. This option is not valid for memory or processor operations. -m The name of the managed system for which the hardware resource configuration is to be changed. The name may either be the user-defined name for the managed system, or be in the form ttttmmm*ssssssss, where tttt is the machine type, mmm is the model, and ssssssss is the serial number of the managed system. The tttt-mmm*ssssssss form must be used if there are multiple managed systems with the same user-defined name. -o The operation to perform. Valid values are a to add hardware resources to a partition, r to remove hardware resources from a partition, m to move hardware resources from one partition to another, and s to set hardware resource related attributes for a partition or the managed-system. -p The name of the partition for which the operation is to be performed. For a move operation, this is the source partition (the partition the resources will be moved from) for the operation. To perform an add, remove, or move operation, the partition must be in the running state. You can either use this option to specify the name of the partition for which the operation is to be performed, or use the --id option to specify the partition s ID. The -p and the --id options are mutually exclusive. --id A partition is required to be specified with this option or the --id option for all operations except a virtual ethernet set operation. The ID of the partition for which the operation is to be performed. For a move operation, this is the source partition (the partition the resources will be moved from) for the operation. To perform an add, remove, or move operation, the partition must be in the running state. You can either use this option to specify the ID of the partition for which the operation is to be performed, or use the -p option to specify the partition s name. The --id and the -p options are mutually exclusive. A partition is required to be specified with this option or the -p option for all operations except a virtual ethernet set operation. -t The name of the target partition for a move operation. The partition must be in the running state. You can either use this option to specify the name of the target partition, or use the --tid option to specify the ID of the partition. The -t and the --tid options are mutually exclusive. --tid A target partition is required to be specified with this option or the --tid option for a move operation. This option is not valid for any other operation. The ID of the target partition for a move operation. The partition must be in the running state. You can either use this option to specify the ID of the target partition, or use the -t option to specify the name of the target partition. The --tid and the -t options are mutually exclusive. A target partition is required to be specified with this option or the -t option for a move operation. Linux December

16 This option is not valid for any other operation. -l The DRC index of the physical I/O slot to add, remove, or move. -s The virtual slot number of the virtual I/O adapter to add or remove. -q The quantity of memory to add, remove, or move. The quantity specified must be in megabytes, it must be a multiple of the memory region size for the managed-system, and it must be greater than 0. --procs When adding or removing processing resources to or from a partition using dedicated processors, or when moving processing resources from a partition using dedicated processors to another partition using dedicated processors, use this option to specify the quantity of dedicated processors to add, remove, or move. When adding or removing processing resources to or from a partition using shared processors, or when moving processing resources from a partition using shared processors to another partition using shared processors, use this option to specify the quantity of virtual processors to add, remove, or move. When moving processing resources from a partition using dedicated processors to a partition using shared processors, use this option to specify the quantity of dedicated processors to be moved from the source partition and added as shared processors to the target partition. This option is not valid when moving processing resources from a partition using shared processors to a partition using dedicated processors. The --procunits option must be used instead. The quantity of processing resources specified with this option must be a whole number greater than 0. --procunits When adding or removing processing resources to or from a partition using shared processors, or when moving processing resources from a partition using shared processors to another partition using shared processors, use this option to specify the quantity of processing units to add, remove, or move. When moving processing resources from a partition using shared processors to a partition using dedicated processors, use this option to specify the quantity of shared processors to be moved from the source partition and added as dedicated processors to the target partition. This option is not valid when moving processing resources from a partition using dedicated processors to a partition using shared processors. The --procs option must be used instead. When moving processing resources from a partition using shared processors to a partition using dedicated processors, the quantity of processing units specified with this option must be a whole number. Otherwise, the quantity of processing units specified with this option can have up to 2 decimal places. In either case, the quantity specified must be greater than cpwpercent The percentage of 5250 Commercial Processing Workload (CPW) to add, remove, or move. The percentage specified can have up to 2 decimal places, and it must be greater than 0. This option is only valid for i5/os partitions and can only be used when the managed-system supports the assignment of 5250 CPW percentages to partitions. -w The elapsed time, in minutes, after which an add, remove, or move operation will be aborted. wait-time must be a whole number. If wait-time is 0, the operation will not be timed out. Linux December

17 If this option is not specified, a default value of 5 minutes is used. This option is valid for all add, remove, and move operations for AIX, Linux, and virtual I/O server partitions. This option is also valid for memory add, remove, and move operations for i5/os partitions. -d The level of detail to be displayed upon return of an add, remove, or move operation. Valid values are 0 (none) through 5 (highest). If this option is not specified, a default value of 0 is used. --force This option is valid for all add, remove, and move operations for AIX, Linux, and virtual I/O server partitions. This option allows you to force an add, remove, or move operation to be performed for an AIX, Linux, or virtual I/O server partition that does not have an RMC connection. You will need to manually vary on or off the resources that are added, removed, or moved. This option also allows you to force a remove or move operation to be performed for a physical I/O slot that is currently in use (varied on) by an i5/os partition. -a The configuration data needed to create virtual I/O adapters or set hardware resource related attributes. The configuration data consists of attribute name/value pairs, which are in comma separated value (CSV) format. The configuration data must be enclosed in double quotes. The format of the configuration data is as follows: attribute-name=value,attribute-name=value,... Note that certain attributes accept a comma separated list of values, as follows: "attribute-name=value,value,...",... When a list of values is specified, the attribute name/value pair must be enclosed in double quotes. Depending on the shell being used, nested double quote characters may need to be preceded by an escape character, which is usually a \ character. If += is used in the attribute name/value pair instead of =, then the specified value is added to the existing list for the attribute if the attribute is a list. If -= is used in the attribute name/value pair instead of =, then the specified value is deleted from the existing list for the attribute if the attribute is a list. Valid attribute names for attributes that can be set when adding, removing, or moving a physical I/O slot: slot_io_pool_id Valid attribute names for setting I/O pool attributes: lpar_io_pool_ids comma separated Valid attribute names for setting tagged I/O resources (i5/os partitions only): load_source_slot DRC index of I/O slot, or virtual slot number alt_restart_device_slot Linux December

18 DRC index of I/O slot, or virtual slot number console_slot DRC index of I/O slot, virtual slot number, or the value hmc alt_console_slot DRC index of I/O slot, or virtual slot number op_console_slot DRC index of I/O slot, or virtual slot number Valid attribute names for adding a virtual ethernet adapter: ieee_virtual_eth Valid values: 0 - not IEEE 802.1Q compatible 1 - IEEE 802.1Q compatible Required port_vlan_id Required addl_vlan_ids is_trunk Valid values: 0 -no 1 - yes Valid attribute names for adding a virtual SCSI adapter: adapter_type Valid values are client or server (server adapters can only be added to i5/os partitions on IBM eserver i5 servers, or virtual I/O server partitions) Required remote_lpar_id remote_lpar_name One of these attributes is required for a client adapter remote_slot_num Required for a client adapter Valid attribute names for adding a virtual serial adapter: adapter_type Valid values are client or server (client adapters cannot be added to i5/os partitions on IBM eserver p5 servers, and server adapters can only be added to i5/os or virtual I/O server partitions) Required remote_lpar_id remote_lpar_name One of these attributes is required for a client adapter remote_slot_num Required for a client adapter Linux December

19 supports_hmc The only valid value is 0 for no. Valid attribute names for setting virtual ethernet attributes: mac_prefix Valid attribute names for setting HSL OptiConnect attributes (i5/os partitions only): hsl_pool_id Valid values are: 0 - HSL OptiConnect is disabled 1 - HSL OptiConnect is enabled Valid attribute names for setting virtual OptiConnect attributes (i5/os partitions only): virtual_opti_pool_id Valid values are: 0 - virtual OptiConnect is disabled 1 - virtual OptiConnect is enabled Valid attribute names for setting processing attributes: sharing_mode Valid values are: keep_idle_procs - valid with dedicated processors share_idle_procs - valid with dedicated processors cap - valid with shared processors uncap - valid with shared processors uncap_weight --help Display the help text for this command and exit. EXAMPLES Add the I/O slot with DRC index to partition p1 and set the I/O pool ID for the slot to 3: chhwres -r io -m sys1 -o a -p p1 -l a "slot_io_pool_id=3" Add I/O pools 2 and 3 to the I/O pools in which partition p1 is participating: chhwres -r io --rsubtype iopool -m * A -o s -p p1 -a ""lpar_io_pool_ids+=2,3"" Add a virtual ethernet adapter to the partition with ID 3: chhwres -r virtualio -m * A -o a --id 3 --rsubtype eth -s 2 -a "ieee_virtual_eth=1, port_vlan_id=4,"addl_vlan_ids=5,6"" Remove the virtual adapter in slot 3 from partition p1: chhwres -r virtualio -m sys1 -o r -p p1 -s 3 Enable HSL OptiConnect for the i5/os partition i5_p1: chhwres -r virtualio -m sys1 -o s -p i5_p1 Linux December

20 --rsubtype hsl -a "hsl_pool_id=1" Add 128 MB of memory to the partition with ID 1, and time out after 10 minutes: chhwres -r mem -m sys1 -o a --id 1 -q 128 -w 10 Remove 512 MB of memory from the AIX partition aix_p1, return a detail level of 5, and force the operation to occur if there is no RMC connection: chhwres -r mem -m * A -o r -p aix_p1 -q 512 -d 5 --force Move 1 processor from partition p1 to partition p2 (both partitions are using dedicated processors): chhwres -r proc -m * A -o m -p p1 -t p2 --procs 1 Move.5 processing units from the partition with ID 1 to the partition with ID 2 (both partitions are using shared processors): chhwres -r proc -m sys1 -o m --id 1 --tid 2 --procunits.5 Add.25 processing units to the i5/os partition i5_p1 and add 10 percent 5250 CPW: chhwres -r proc -m sys1 -o a -p i5_p1 --procunits cpwpercent 10 ENVIRONMENT BUGS AUTHOR IBM Austin SEE ALSO lshwres, rsthwres, chsyscfg, lssyscfg Linux December

21 NAME chled - change LED SYNOPSIS chled -r sa -t {phys virtuallpar virtualsys} -m managed-system -o {on off} [{-p partition-name --id partition-id}] [--help] DESCRIPTION chled changes the state of an LED on the managed-system. OPTIONS -r The type of LED resource to change. The only valid value is sa for System Attention (SA) LED. -t The type of System Attention (SA) LED to change. Valid values are phys for the physical SA LED for the managed-system, virtuallpar for a virtual partition SA LED, or virtualsys for the virtual SA LED for the managed-system. -m The name of the managed system on which to change the LED. The name may either be the userdefined name for the managed system, or be in the form tttt-mmm*ssssssss, where tttt is the machine type, mmm is the model, and ssssssss is the serial number of the managed system. The tttt-mmm*ssssssss form must be used if there are multiple managed systems with the same userdefined name. -o The operation to perform on the LED. Valid values are on to activate the LED, and off to deactivate the LED. The value on is not valid when changing the physical SA LED for the managed-system. -p The name of the partition for which the virtual partition SA LED is to be changed. To change a virtual partition SA LED, you must either use this option to specify the name of the partition for which the LED is to be changed, or use the --id option to specify the partition s ID. The -p and the --id options are mutually exclusive. --id This option is not valid when changing the physical SA LED or the virtual SA LED for the managed-system. The ID of the partition for which the virtual partition SA LED is to be changed. --help To change a virtual partition SA LED, you must either use this option to specify the ID of the partition for which the LED is to be changed, or use the -p option to specify the partition s name. The --id and the -p options are mutually exclusive. This option is not valid when changing the physical SA LED or the virtual SA LED for the managed-system. Display the help text for this command and exit. EXAMPLES Deactivate the physical SA LED for the system: chled -m *100103C -r sa -t phys -o off Activate the virtual partition SA LED for partition lpar3: chled -m system1 -r sa -t virtuallpar -o on -p lpar3 Dectivate the virtual partition SA LED for the partition with ID 3: Linux May

22 chled -m system1 -r sa -t virtuallpar -o off --id 3 ENVIRONMENT BUGS AUTHOR IBM Austin SEE ALSO lsled Linux May

23 NAME chsacfg - change Service Agent configuration SYNOPSIS To change customer notification settings: chsacfg -t -o {enable disable setsmtp add remove test} [-a { -address all}] [--events {all callhome}] [-h host-name [-p port-number]] To change FTP firewall settings: chsacfg -t ftpfirewall [-o {add remove}] [-h host-name] [-p port-number] [-u user-id] [--passwd password] [--passive passive-mode] [--fwtype firewall-type] [-n name] To change FTP offload server settings: chsacfg -t ftpoffload [-o {enable disable}] [-h host-name] [-p port-number] [-u user-id] [--passwd password] [--passive passive-mode] [-d directory] DESCRIPTION chsacfg changes the Service Agent configuration. OPTIONS -t The type of Service Agent configuration information to change. Valid values are for customer notification settings, ftpfirewall for FTP firewall settings, and ftpoffload for FTP offload server settings. -o The operation to perform. Valid values are: enable - enable customer notification or FTP offload of service information disable - disable customer notification or FTP offload of service information setsmtp - set the SMTP server information for add customer notification - add a notification address or add a name to the exclusion list for the FTP firewall server remove - remove a notification address or remove a name from the exclusion list for the FTP firewall server test - send a test to a notification address -a The address to add, remove, or test for customer notification . When performing a remove or test operation for a customer notification address, all can be specified with this option instead of a specific address. If all is specified, then the remove or test operation will be performed for all notification addresses. Linux October

24 --events This option is required when adding, removing, or testing a customer notification address. This option is not valid for any other operation. The type of problem events for which the address is to be notified. Valid values are all for all problem events, and callhome for only call home problem events. This option is only valid when adding a customer notification address. If this option is not specified when adding a customer notification address, then the address will be notified for all problem events. -h When enabling customer notification or setting the SMTP server information for customer notification , use this option to specify the host name or IP address of the SMTP server. When changing the FTP firewall settings, use this option to specify the host name or IP address of the firewall server. When changing the FTP offload server settings, use this option to specify the host name or IP address of the FTP offload server. This option is required when setting the SMTP server information for customer notification . -p When setting the SMTP server information for customer notification , use this option to specify the port number to use on the SMTP server. The default port number for an SMTP server is 25. When changing the FTP firewall settings, use this option to specify the port number to use on the firewall server. When changing the FTP offload server settings, use this option to specify the port number to use on the FTP offload server. The default port number for an FTP offload server or firewall server is 21. -u When changing the FTP firewall settings, use this option to specify the user ID to use to log in to the firewall server. When changing the FTP offload server settings, use this option to specify the user ID to use to log in to the FTP offload server. --passwd When changing the FTP firewall settings, use this option to specify the password to use to log in to the firewall server. If this option is omitted, you will be prompted to enter the password. When changing the FTP offload server settings, use this option to specify the password to use to log in to the FTP offload server. If this option is omitted, you will be prompted to enter the password. -d The directory to use on the FTP offload server. --passive When changing the FTP firewall settings, use this option to specify the passive mode to use. Valid values are on for always use PASV, off for always use PORT, and optional for try PASV then PORT. When changing the FTP offload server settings, use this option to specify the passive mode to use. Valid values are on for always use PASV and off for always use PORT. Linux October

25 --fwtype The FTP firewall type to use when offloading service information. Valid values are: 0 - do not use a firewall 1 - connect to firewall server, but send "USER user@real.host.name" 2 - connect to firewall server, log in with "USER fwuser" and "PASS fwpassword", and then "USER user@real.host.name" 3 - connect to and log in to firewall server, and then use "SITE real.host.name" followed by "USER user" and "PASS password" 4 - connect to and log in to firewall server, and then use "OPEN real.host.name" followed by "USER user" and "PASS password" 5 - connect to firewall server, but send "USER user@fwuser@real.host.name" and "PASS pass@fwpass" to log in 6 - connect to firewall server, but send "USER fwuser@real.host.name" and "PASS fwpass" followed by "USER user" and "PASS password" to complete the login 7 - connect to firewall server, but send "USER user@real.host.name fwuser" and "PASS pass" followed by "ACCT fwpass" to complete the login This option is only valid when changing the FTP firewall settings. -n The host name or domain name to add to or remove from the exclusion list for the firewall server. The exclusion list is a list of domains or hosts where the firewall should not be used. --help This option is required when adding or removing a name in the exclusion list for the FTP firewall server. This option is not valid for any other operation. Display the help text for this command and exit. EXAMPLES Enable customer notification for problem events: chsacfg -t -o enable Set the SMTP server information for customer notification chsacfg -t -o setsmtp -h mycompany.com -p 30 Add an address to be notified when call home problem events occur: chsacfg -t -o add -a addr1@mycompany.com --events callhome Send a test to all customer notification addresses: chsacfg -t -o test -a all Enable the use of FTP to offload service information and set the FTP server information: Linux October

26 chsacfg -t ftpoffload -o enable -h ftphost -u ftpuser --passwd userpwd Set the FTP firewall server information to be used when offloading service information: chsacfg -t ftpfirewall --fwtype 1 -h ftpfirewall -u ftpuser --passwd userpwd Add a name to the exclusion list for the FTP firewall server: chsacfg -t ftpfirewall -o add -n excludedhost Disable the use of an FTP firewall when offloading service information: chsacfg -t ftpfirewall --fwtype 0 ENVIRONMENT BUGS AUTHOR IBM Austin SEE ALSO lssacfg Linux October

27 NAME chsvcevent - update a serviceable event on the HMC. SYNOPSIS chsvcevent -p problem number -h analyzing hmc -o close [--help] DESCRIPTION chsvcevent update a serviceable event on the HMC. OPTIONS -p The problem number, as displayed by the lssvcevents command. -h The analyzing HMC, as displayed by the lssvcevents command. -o The operation to perform. Valid values are close. --help Use the close operation to close the specified serviceable event. Display the help text for this command and exit. EXAMPLES To close a serviceable event: chsvcevent -p h 7315-C02/KLRMT0L -o close ENVIRONMENT BUGS AUTHOR IBM Austin SEE ALSO lssvcevents Linux November

28 NAME chsyscfg - change system resources SYNOPSIS chsyscfg -r {lpar prof sys sysprof frame} {-m managed-system -e managed-frame} {-f configuration-file -i "configuration-data"} [--help] DESCRIPTION chsyscfg changes the attributes of partitions, partition profiles, or system profiles for the managed-system. It can also change the attributes of the managed-system. chsyscfg can also change the attributes of the managed-frame. OPTIONS -r The type of resources to change. Valid values are lpar for partitions, prof for partition profiles, sys for the managed system, sysprof for system profiles, and frame for the managed frame. -m The name of either the managed system to be changed, or the managed system which has the system resources to be changed. The name may either be the user-defined name for the managed system, or be in the form tttt-mmm*ssssssss, where tttt is the machine type, mmm is the model, and ssssssss is the serial number of the managed system. The tttt-mmm*ssssssss form must be used if there are multiple managed systems with the same user-defined name. This option is required when changing the attributes of partitions, partition profiles, system profiles, or the managed system. This option is not valid otherwise. -e The name of the managed frame to be changed. The name may either be the user-defined name for the managed frame, or be in the form tttt-mmm*ssssssss, where tttt is the type, mmm is the model, and ssssssss is the serial number of the managed frame. The tttt-mmm*ssssssss form must be used if there are multiple managed frames with the same user-defined name. This option is required when changing the attributes of the managed frame. This option is not valid otherwise. -f The name of the file containing the configuration data needed to change the resources. The configuration data consists of attribute name/value pairs, which are in comma separated value (CSV) format. These attribute name/value pairs form a configuration record. A line feed marks the end of a configuration record. The file must contain one configuration record for each resource to be changed, and each configuration record must be for the same resource type. If the resource type is the managed system or the managed frame, then the file must contain only one configuration record. The format of a configuration record is as follows: attribute-name=value,attribute-name=value,...<lf> Note that certain attributes accept a comma separated list of values, as follows: "attribute-name=value,value,...",...<lf> When a list of values is specified, the attribute name/value pair must be enclosed in double quotes. Depending on the shell being used, nested double quote characters may need to be preceded by an escape character, which is usually a \ character. If += is used in the attribute name/value pair instead of =, then the specified value is added to the existing value for the attribute if the attribute is numerical. If the attribute is a list, then the Linux May

29 specified value(s) is added to the existing list. If -= is used in the attribute name/value pair instead of =, then the specified value is subtracted from the existing value for the attribute if the attribute is numerical. If the attribute is a list, then the specified value(s) is deleted from the existing list. Attribute names for partitions: name lpar_id name or ID of the partition to change (required) new_name default_profile ipl_source i5/os only Valid values are a, b, c, ord shared_proc_pool_util_auth Valid values are: 0 - do not allow authority 1 - allow authority work_group_id Attribute names for partition profiles: name name of the partition profile to change (required) lpar_name lpar_id name or ID of the partition for which the profile to change is defined (required) new_name min_mem megabytes desired_mem megabytes max_mem megabytes proc_mode Valid values are: ded - dedicated processors shared - shared processors min_procs desired_procs max_procs min_proc_units desired_proc_units max_proc_units min_5250_cpw_percent Only valid for i5/os partitions in managed systems that support the assignment of 5250 CPW percentages desired_5250_cpw_percent Only valid for i5/os partitions in managed systems that support the assignment of 5250 CPW percentages Linux May

30 max_5250_cpw_percent Only valid for i5/os partitions in managed systems that support the assignment of 5250 CPW percentages sharing_mode Valid values are: keep_idle_procs - valid with dedicated processors share_idle_procs - valid with dedicated processors cap - valid with shared processors uncap - valid with shared processors uncap_weight io_slots Comma separated list of I/O slots, with each I/O slot having the following format: slot-drc-index/slot-io-pool-id/ is-required Both / characters must be present, but optional values may be omitted. Optional values are slot-io-pool-id. Valid values for is-required: 0 -no 1 - yes For example: /3/1 specifies an I/O slot with a DRC index of , it is assigned to I/O pool 3, and it is a required slot. lpar_io_pool_ids comma separated load_source_slot i5/os only DRC index of I/O slot, or virtual slot number alt_restart_device_slot i5/os only DRC index of I/O slot, or virtual slot number console_slot i5/os only DRC index of I/O slot, virtual slot number, or the value hmc alt_console_slot i5/os only DRC index of I/O slot, or virtual slot number op_console_slot i5/os only DRC index of I/O slot, or virtual slot Linux May

31 number auto_start Valid values are: 0 -off 1 -on boot_mode AIX, Linux, and virtual I/O server only Valid values are: norm - normal dd - diagnostic with default boot list ds - diagnostic with stored boot list of - Open Firmware OK prompt sms - System Management Services power_ctrl_lpar_ids power_ctrl_lpar_names comma separated conn_monitoring Valid values are: 0 -off 1 -on hsl_pool_id i5/os only Valid values are: 0 - HSL OptiConnect is disabled 1 - HSL OptiConnect is enabled virtual_opti_pool_id i5/os only Valid values are: 0 - virtual OptiConnect is disabled 1 - virtual OptiConnect is enabled max_virtual_slots virtual_eth_adapters Comma separated list of virtual ethernet adapters, with each adapter having the following format: virtual-slot-number/is-ieee/ port-vlan-id/additional-vlan-ids/ is-trunk/is-required All 5 / characters must be present, but optional values may be omitted. Optional values are additional-vlan-ids, and is-trunk. Valid values for is-ieee, is-trunk, and is-required: 0 -no 1 - yes For example: 3/1/5/"6,7"/0/1 specifies a virtual ethernet adapter with a virtual slot number of 3, is IEEE 802.1Q compatible, has a port virtual LAN Linux May

32 ID of 5, additional virtual LAN IDs of 6 and 7, it is not a trunk adapter, and it is required. virtual_scsi_adapters Comma separated list of virtual SCSI adapters, with each adapter having the following format: virtual-slot-number/client-or-server/ remote-lpar-id/remote-lpar-name/ remote-slot-number/is-required All 5 / characters must be present, but optional values may be omitted. Optional values for server adapters are remote-lpar-id, remote-lpar-name, and remote-slot-number. Optional values for client adapters are remote-lpar-id or remote-lpar-name (one of those values is required, but not both). Valid values for client-or-server: client server i5/os partitions on IBM eserver i5 servers, and virtual I/O server partitions only Valid values for is-required: 0 -no 1 - yes For example: 4/client/2//3/0 specifies a virtual SCSI client adapter with a virtual slot number of 4, a remote (server) partition ID of 2, a remote (server) slot number of 3, and it is not required. virtual_serial_adapters Comma separated list of virtual serial adapters, with each adapter having the following format: virtual-slot-number/client-or-server/ supports-hmc/remote-lpar-id/ remote-lpar-name/remote-slot-number/ is-required All 6 / characters must be present, but optional values may be omitted. Optional values for server adapters are supports-hmc, remote-lpar-id, remote-lpar-name, and remote-slot-number. Linux May