unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 parmodify(1M)						       parmodify(1M)




 NAME
      parmodify - modify an existing partition

 SYNOPSIS
      parmodify -p PartitionNumber
	   {-a cell:[celltype]:[use_on_next_boot]:[failure_usage][:clm_value]
	   [-a...]
	   |-m cell:[celltype]:[use_on_next_boot]:[failure_usage][:clm_value]
	   [-m...]
	   |-d cell [-d...]
	   |-B
	   |-r cell [-r...]
	   |-u username -h IPaddress|hostname
	   |-g -h IPaddress|hostname
	   |-I IPaddress |-b path |-t path |-s path
	   |-P PartitionName |-k s_lock:p_lock	}

 DESCRIPTION
      The parmodify command is used to modify the attributes of an existing
      partition.  By default the target partition is the local partition.
      Either the -u or the -g option can be specified to allow this command
      to modify any other partition in the (local or remote) complex.  This
      command can modify the following attributes:

		Partition name
		Cell assignment:
		     Add cells to the partition
		     Delete cells from the partition
		Attributes of existing cells:
		     celltype
		     use_on_next_boot
		     failure_usage
		     clm_value (cell local memory)
		Core cell choices
		Primary boot path
		HA Alternate boot path
		Secondary boot path
		Partition's IP address

      By the nature of its operation, this command can modify the
      configuration of its target complex.  Operation can be affected by the
      state of the target complex's nPartition Configuration Privilege.	 If
      the nPartition Configuration Privilege is unrestricted (the default),
      or the complex is accessed using the -g option, all operations are
      allowed.	Otherwise any of the operations below causes the command to
      fail:

	   +  add cells to any partition in the complex
	   +  delete cells from any partition in the complex
	   +  modify the CLM parameters of any cell in the complex




 Hewlett-Packard Company	    - 1 -      HP-UX 11i Version 1: Sep 2004






 parmodify(1M)						       parmodify(1M)




      The -g option is unaffected by the state of the nPartition
      Configuration Privilege.	Note:  The state of the nPartition
      Configuration Privilege can only be changed at the service processor's
      Command menu.

      Root permission is required to run this command on the local
      partition.  If the -u or -g option is used to access a remote
      partition or complex, root permission is not required on the local
      system, and the local system need not exist on an nPartition.  If the
      -u option is specified, username on the remote host must have root
      permission or the command will fail.

      Please refer to the HP System Partitions Guide for a description of
      the partition management terms used in this man page.

    Remote Management Options
      The -u and -g options will be available only if NParProvider and
      NPartition products are installed.  The clm_value can be used only if
      NParProvider and NPartition products are installed.  The cplxmodify
      command exist only if NPartition product is installed.

    Options and Arguments
      parmodify recognizes the following command line options and arguments:

      -p PartitionNumber
		     Specifies the partition to be modified.
		     PartitionNumber specifies the unique number (integer)
		     assigned to the partition when it was created.  Note:
		     The partition which is specified to be modified is
		     called the target partition.  The partition in which
		     the command is executing is called the local partition.

      Note: One or more of the following options must be specified.

      -u username    Specifies the required authorization to access a
		     partition other than the local system (but can also be
		     used as a loopback access to the local partition).

		     The -h option is required if this option is used.

		     username specifies a configured user name on the target
		     partition. If -u username is specified, the command
		     will prompt for the password associated with the
		     username.

		     Note: This command is a Web-Based Enterprise Management
		     (WBEM) Client Application.	 The -u option accesses the
		     target partition using a Secure Sockets Layer (SSL)
		     connection.  If errors are reported, check that the
		     conditions described in the DEPENDENCIES section are
		     satisfied.



 Hewlett-Packard Company	    - 2 -      HP-UX 11i Version 1: Sep 2004






 parmodify(1M)						       parmodify(1M)




		     Note: If the commands are used in a script, the user
		     password must be passed in a secured way. For example,

		     1. Save the user password in a variable and pass it to
			the command as,

			echo $passwd | parstatus -X -u username -h
			hostname/IP

		     2. Save the user password in a file and pass the file
			as input to the command like,

			parstatus -X -u username -h hostname/IP <&lt&lt&lt;
			passwd_file

			Note, for security reason, protect the file that has
			the user password by removing read permissions for
			non-privileged users.

      -h IPaddress|hostname
		     This option should only be used in combination with
		     either the -u or -g option.  IPaddress|hostname
		     specifies the IP address or hostname of the target
		     partition (-u) or complex (-g).

      -g	     Allows access to the complex specified by the -h
		     option.  The accessed complex is then considered the
		     target complex.  Access is via the service processor's
		     LAN port.

		     The -h option is required if this option is used.

		     If -g is specified, the IPMI password of the service
		     processor should be passed when prompted.

		     If an error is reported when you attempt to connect
		     using this option, check to see that IPMI LAN access
		     has not been disabled on the remote service processor.
		     Access to the complex via IPMI over LAN can be enabled
		     or disabled by logging on to the service processor and
		     using the SA command from the Command Menu.

		     The -u and -g options are mutually exclusive.

		     Note: If the commands are used in a script, the IPMI
		     password must be passed in a secured way. For example,

		     1. Save the user password in a variable and pass it to
			the command as,





 Hewlett-Packard Company	    - 3 -      HP-UX 11i Version 1: Sep 2004






 parmodify(1M)						       parmodify(1M)




			echo $passwd | parstatus -X -g -h hostname/IP

		     2. Save the  user	password in a file and pass the file
			as input to the command like,

			parstatus -X -g -h hostname/IP <&lt&lt&lt; passwd_file

			Note, for security reason, protect the file that has
			the IPMI password by removing read permissions for
			non-privileged users.

      -a cell:[celltype]:[use_on_next_boot]:[failure_usage][:clm_value]
		     Assigns the specified cell to the target partition.  To
		     assign multiple cells to the partition, multiple -a
		     options should be used.

		     cell specifies the cell id. It can be specified either
		     in the local (cabinet#/slot#) or global (cell#) format.
		     For example, the cell located in cabinet 0, slot 1 is
		     identified in the local format as 0/1 or in the global
		     format as 1.

		     celltype specifies the type of the cell.  The valid
		     celltype value for cells is:
		     base    This is the default if celltype is not
			     specified.

		     use_on_next_boot specifies whether the cell will
		     participate in a reboot. The valid values for
		     use_on_next_boot are:
		     y	     participate in reboot.  This is the default.
			     However if the slot is missing or the cell does
			     not exist or the cell is powered off then it
			     defaults to n
		     n	     do not participate in reboot.

		     failure_usage field is used by system firmware when a
		     partition is booted.  If a CPU selftest failure or a
		     DIMM de-allocation occurs during the power-on self-test
		     process then this flag is used by the system firmware
		     to determine whether or not and how the cell should be
		     integrated into the partition at boot time.  The valid
		     failure_usage value for cells is:
		     ri	     reactivate with memory interleave.	 Specifies
			     to integrate the cell as it would normally be
			     integrated.  This is the default.

		     clm_value specifies the amount of the memory that will
		     be configured as local (non-interleaved) memory for the
		     cell.  The command issues a warning if the specified
		     clm_value exceeds the total memory of the cell.  If no



 Hewlett-Packard Company	    - 4 -      HP-UX 11i Version 1: Sep 2004






 parmodify(1M)						       parmodify(1M)




		     clm_value is specified, maximum interleaved memory(no
		     clm) is assumed for cells.	 The command will issue a
		     warning if 100% CLM is specified for all the cells in
		     the partition.  The clm_value can be expressed in two
		     forms:

		     +	As a percentage (ratio).  The percent number can be
			any number in the range 0 - 100 with a suffix of
			"%".  This number will be rounded up to 12.5%, 25%,
			37.5%, 50%, 62.5%, 75%, 87% or 100%.  If the cell
			contains less than 4GB memory, then the percentage
			will be rounded to 25%, 50%, 75% or 100%.  The
			specified percentage is applied each time the
			partition boots, thus resulting in a different value
			if the working memory in the cell is different.	 For
			example, a cell in a partition has 8GB memory and
			the user specifies 4GB CLM.  When the partition
			boots 4GB of that cell's memory will be used as CLM.
			Later the user shuts down the partition, adds
			another 8GB memory to that cell.  When the partition
			is booted again, the cell now has 16GB of memory, so
			8GB (50%) is allocated as CLM.

		     +	As an absolute number (default).  This can also be
			optionally suffixed by "GB".  The clm_value is
			interpreted as an absolute number of gigabytes of
			memory.	 Numbers other than integers and halves are
			rounded up to the nearest 0.5GB.  For example: 2.5GB
			will not be rounded up.	 However 2.3GB will be
			rounded up to 2.5GB.  For example, a cell in a
			partition has 8GB memory and the user specifies 50%
			CLM.  When the partition boots 4GB of that cell's
			memory will be used as CLM.  Later the user shuts
			down the partition, adds another 8GB memory to that
			cell.  When the partition is booted again, the cell
			now has 16GB of memory, but the CLM is still 4GB.

      -m cell:[celltype]:[use_on_next_boot]:[failure_usage][:clm_value]
		     Modify attributes of cell(s) already assigned to the
		     target partition.	Please refer to the explanation of
		     the -a option for details of the different fields in
		     this option argument.  Note:
		     +	The use_on_next_boot field of the last cell
			containing core IO cannot be modified to "n".
		     +	If modifying the CLM value of a cell in any
			partition other than the local partition, it is
			preferable to use the -u option.

      -d cell	     Delete the specified cell(s) from the partition.  If
		     the cell which is being deleted is an active cell then
		     after the execution of the parmodify command the user



 Hewlett-Packard Company	    - 5 -      HP-UX 11i Version 1: Sep 2004






 parmodify(1M)						       parmodify(1M)




		     must shutdown the partition using the shutdown -R
		     command for the configuration change to take effect.
		     If the -B option is also specified then the partition
		     will boot up to the command prompt.  If the -B option
		     is not specified then the partition will have to be
		     booted manually from the service processor.  Deletion
		     of inactive cells does not require a shutdown of the
		     partition.

		     A cell can be specified either in the local
		     (cabinet#/slot#) or global (cell#) format.	 For
		     example, the cell located in cabinet 0, slot 1 is
		     identified in the local format as 0/1 or in the global
		     format as 1.

      -B	     Specifies to reboot the partition now.  The default is
		     not to boot.  If this option is specified and the
		     partition to be modified is not the local partition,
		     then the command proceeds only if the specified
		     partition is not active.  Also this option is useful
		     only if the -a option or the -d option or a clm_value
		     has been specified.

      -r cell	     Specifies the core cell choices.  A core cell choice is
		     a configured cell which has attached core IO.  If the
		     core cell of a partition is deleted then the firmware
		     will select the first core cell choice as the next core
		     cell. One to four core cell choices can be specified.
		     The first cell specified is the first core cell choice,
		     the second cell specified is the second core cell
		     choice, the third cell specified is the third core cell
		     choice and the fourth cell specified is the fourth core
		     cell choice.  Use of this option will override previous
		     core cell choices.	 So, if the order of a given cell is
		     changing, all of the core cell choices should be
		     specified in the new order.

		     A cell can be specified either in the local
		     (cabinet#/slot#) or global (cell#) format.	 For
		     example, the cell located in cabinet 0, slot 1 is
		     identified in the local format as 0/1 or in the global
		     format as 1.

      -I IPaddress   Specifies the IP address that should be used by
		     management tools such as parmgr to address the target
		     partition.	 This value must be consistent with the IP
		     address that is assigned to the partition once HP-UX is
		     installed and networking is configured.

      -b path	     Specifies the primary boot path.  path specifies a
		     physical hardware path.  Note: On Itanium-based



 Hewlett-Packard Company	    - 6 -      HP-UX 11i Version 1: Sep 2004






 parmodify(1M)						       parmodify(1M)




		     platforms, only boot paths of the local partition can
		     be modified.

      -t path	     Specifies the alternate boot path.	 path specifies a
		     physical hardware path.  Note: On Itanium-based
		     platforms, only boot paths of the local partition can
		     be modified.

      -s path	     Specifies the secondary boot path.	 path specifies a
		     physical hardware path.  Note: On Itanium-based
		     platforms, only boot paths of the local partition can
		     be modified.

      -P Partition Name
		     Specifies the name of the partition.  The characters
		     which can appear in a valid partition name are a-z, A-
		     Z, 0-9, - (dash), _ (underscore), " " (space) and .
		     (period).	If the partition name includes space then
		     the name should be enclosed within double quotes.	The
		     partition name can have a maximum of 64 characters.

      -k s_lock:p_lock
		     Specifies the lock keys provided by parmgr for the
		     Stable Complex Configuration Data and Partition
		     Configuration Data.  The lock keys should always be
		     specified in pairs.  If either lock key is not
		     available -1 should be specified as a placeholder.	 For
		     example: if the s_lock is available but the p_lock is
		     not available, then it should be specified as -k
		     s_lock:-1.

		     Note: The -k option is intended for use by system
		     management tools which invoke the parmodify command
		     programmatically.	Command line users should avoid this
		     option.

    Mapping of Global Cell Numbers to Local Cell Numbers
      The cabinets in a complex are numbered starting from 0.  The cell
      slots in each cabinet are also numbered starting from 0.	Each cabinet
      can have a maximum of 8 cells.  For example, the cells located in
      cabinet 0 will have the following cell numbers in global format: 0, 1,
      2, 3, 4, 5, 6, 7.	 The cell numbers in corresponding local format will
      be 0/0, 0/1, 0/2, 0/3, 0/4, 0/5, 0/6, 0/7.

      Similarly the cells located in cabinet 1 will have the following cell
      numbers in global format: 8, 9, 10, 11, 12, 13, 14, 15.  The cell
      numbers in corresponding local format will be 1/0, 1/1, 1/2, 1/3, 1/4,
      1/5, 1/6, 1/7.

      From the above convention the cell located in cabinet 1, slot 0 is
      identified in the local format as 1/0 or in the global format as 8.



 Hewlett-Packard Company	    - 7 -      HP-UX 11i Version 1: Sep 2004






 parmodify(1M)						       parmodify(1M)




      The parstatus(1) command will display the above cell as "cab1,cell0".
      The cell located in cabinet 1, slot 4 is identified in the local
      format as 1/4 or in the global format as 12.  The parstatus(1) command
      will display the above cell as "cab1,cell4".

 RETURN VALUE
      The parmodify command exits with one of the following values:

      0	   Successful completion.
      1	   Error condition occurred.

 EXAMPLES
      Add a new cell in cabinet 0 slot 5 to the existing Partition 2 and
      activate it.

	   parmodify -p 2 -a 0/5:base:y:ri:50% -B

      Delete a cell in cabinet 0 slot 5 from the existing Partition 2.

	   parmodify -p 2 -d 5

 WARNINGS
      On a partition whose hardware resources are managed under an instant
      Capacity On Demand (iCOD) license, the parmodify command fails if a
      configuration change would take the partition out of compliance.

      Examples of such actions include:
      +	 Assigning an iCOD cell to a partition, specifying "y" for the
	 cell's use_on_next_boot field.
      +	 Changing an iCOD cell's use_on_next_boot field to "y" after
	 assigning it to a partition.
      +	 Assigning a cell containing iCOD-licensed CPUs to a partition that
	 is not running, or that does not have the iCOD software installed.

      For more information about actions that are restricted on iCOD
      partitions, refer to the iCOD User's Guide located at
      /usr/share/doc/icodUserGuide.pdf.

 DEPENDENCIES
      This command uses the Web-Based Enterprise Management (WBEM) product
      and certain of its configuration settings.  If you encounter
      connection errors when using the -u option, check that the following
      two conditions are satisfied:

      +	 Use the cimconfig(1M) command to verify (and correct if necessary)
	 the setting of the following two variables:

	 +  enableRemotePrivilegedUserAccess=true

	 +  enableHttpsConnection=true




 Hewlett-Packard Company	    - 8 -      HP-UX 11i Version 1: Sep 2004






 parmodify(1M)						       parmodify(1M)




      +	 You must have appended the target partition's digital certificate
	 to the local partition's Trust Store file.  For the nPartition
	 commands, the Trust Store file is /opt/nparcmds/nparcmds.pem.

      Refer to the WBEM documents specified in the SEE ALSO section below
      for further information.

 AUTHOR
      parmodify was developed by the Hewlett-Packard Company.

 FILES
      /usr/sbin/	     The partition commands under this directory do
			     not provide remote management feature.

      /usr/lib/npar/	     The partition commands under this directory
			     provide remote management feature. These
			     commands use the nPartition Provider product.

      /opt/nparprovider/lib/installed
			     The presence of this file indicates that
			     nPartition Provider is installed.

 SEE ALSO
      cplxmodify(1M), fruled(1), frupower(1M), parcreate(1M), parmgr(1M),
      parremove(1M), parstatus(1), parunlock(1M), partition(5),

      HP System Partitions Guide on docs.hp.com,

      HP WBEM Services for HP-UX System Administrator's Guide on
      docs.hp.com,

      HP WBEM Services for HP-UX 11i v2.0 on Integrity Servers Version
      A.01.05 Release Notes on docs.hp.com.





















 Hewlett-Packard Company	    - 9 -      HP-UX 11i Version 1: Sep 2004