IVM deploysysplan command

Purpose

Deploys a system plan (an XML-based system configuration) generated using the mksysplan command or the System Planning Tool (SPT) on the managed system.

Syntax

deploysysplan -f <system plan file name>-o dv | v | d [-m <managed system>] [--force] [--plan <system plan name>] [-v] [-clientinstall] [--help]

Description

The deploysysplan command deploys a managed system's partition plan from an XML input file.

Flags

-f SysPlanFileName	Specifies the XML file (saved as a compressed stream with extension .sysplan) that contains the system plan that is to be deployed. This file is not changed by the deploysysplan command. The file must be in the system plan file directory (/opt/hsc/data/sysplan) on the management partition. The file name that you specify must end in ".sysplan." The file name can be uppercase, lowercase, or mixed.
-o	Specifies the deployment option to be used when deploying the system plan. The options are as follows: dv Validates and deploys the system plan on the managed system. v Validates the system plan for the managed system but does not deploy it. d Indicates that the system plan should not be validated against the managed system, but the plan-specified partitions and profiles on the managed system are to be deployed.
-m	Specifies the managed system's name where the plan is to be deployed. The system-plan file specifies the managed system's name where that system plan was intended to be deployed. Because IVM can cater to only one managed system, specify only the defaulted managed system using the -m option. This option is kept just to maintain the consistency with other IVM commands. The name can either be the user-defined name for the managed system, or be in the form tttt-mmmssssssss, where tttt* is the machine type, mmm is the model, and ssssssss is the serial number of the managed system.
--force	When the managed system has existing partitions other than the Virtual I/O Server partition, that the system plan contains and that are in an active state, this option allows the deploysysplan command to proceed with deployment. Otherwise, if active partitions are found, the deploysysplan command will fails with an error message.
-v	Specifies that a list of identifiers that identify the steps of the validated system plan should be written to standard output (stdout). These steps are part of the plan but not yet implemented on the managed system. Otherwise, this list is not written out. When you specify the -dv or -d options, this parameter specifies that a list of log entries that record the steps performed as part of deploying the system plan be written to stdout. Otherwise, this list is not written out.
--plan <system plan name>	Specifies the which system plan files can contain more than one system definition. If the file contains more than one system, this flag specifies the name of the system within the system plan to deploy. If this name is not specified and there is more than one system defined, an error listing the system name is returned. If there is only one system plan in the file, this flag is ignored.
-clientinstall	Identifies the operating systems to be installed on the client logical partitions and performs an automatic installation of one or more of the clients, as defined in the system plan.
--help	Displays the help text for this command and exit.

Exit Status

See Exit status for Virtual I/O Server commands.

Examples

To deploy a system plan from file mysysplan.xml onto the managed system configured in the file. Run the following command to validate the plan against the managed system before deploying it:

deploysysplan -f mysysplan.sysplan -o dv

Deploy a system plan from file mysysplan.xml and specify the managed system mySystem. Validate the plan against the managed system before deploying it. Deploy the plan, if valid, even though there might be active client partitions on the managed system:

deploysysplan -f mysysplan.sysplan -o dv -m mySystem --force

Deploy a system plan from file mysysplan.xml onto a managed system by machine type, model number, and serial number of the managed system. Validate the plan against the managed system before deploying it. Write any errors found in validation or deployment to stdout:

deploysysplan -f mysysplan.sysplan -o dv -m 9406-570*34134888 -v

Validate the ability to deploy a system plan from file mysysplan.sysplan onto managed system mySystem. Validate the plan against the managed system to determine if that plan can be deployed there but do not actually deploy the plan. Write out the steps in the system plan that are part of the plan but not yet implemented to stdout. Write any errors found in validation or deployment to stdout:

deploysysplan -f mysysplan.sysplan -o v -m mySystem -v

Deploy a system plan from file mysysplan.sysplan onto managed system mySystem. Do not validate the plan against the managed system to determine if that plan can be deployed there. Write information about the steps performed in deployment to stdout. Write any errors found in validation or deployment to stdout. Deploy the plan, if valid, even though there might be active partitions on the managed system:

deploysysplan -f mysysplan.sysplan -o d -m mySystem -v -force

Deploy a system plan from file mysysplan.sysplan onto managed system mySystem. Validate the plan against the managed system before deploying it. Deploy the plan, if valid, even though there might be active partitions on the managed system. Only deploy those steps from the system plan that have been identified by the -i parameter:

deploysysplan -f mysysplan.sysplan -o dv -m mySystem -force -i "23 45 33 465 99 3 4"

Deploy a system plan from the mysysplan.sysplan file onto the managed system configured in the file. Type the following command to validate the plan against the managed system before deploying it, and install the client partitions with the operating systems specified in the system plan.

deploysysplan -f mysysplan.sysplan -o dv -clientinstall

Related Information

The lssysplan command, mksysplan command, and rmsysplan command.