BackupVIOS_VirtualServer Job

The BackupVIOS job takes the full Virtual I/O Server (VIOS) backup and saves the backup in the Management Console file system. Internally, the job runs the backupios VIOS command.

Resource

/rest/api/uom/VirtualIOServer/{VirtualIOServer_UUID}/do/BackupVIOS

Request

Table 1. Request Parameters
Request parameter Description
FileName Name of the backup file that is saved in the HMC.
NoNIMOL Flag to indicate whether the backup can include NIMOL content:
  • true: NIMOL content is not included (VIOS command is backupios –mksysb).
  • false: NIMOL content is included in the backup.
NoMediaRepo Flag to indicate whether the backup can include media repository content:
  • true: Media repository content is not included (VIOS command is backupios –nomedialib).
  • false: Media repository content is included in the backup.
NoVGStrusture Flag to indicate whether the backup can include VG strusture:
  • true: VG strusture is not included (VIOS command is backupios –nosvg).
  • false: VG strusture is included in the backup.
OverwriteFile Flag to indicate whether the existing file with the same name can be overwritten:
  • true: Overwrite the existing file.
  • false: Do not overwrite the existing file and throw an error message to the user.

Response

None

Sample Job Request(s)

 <JobRequest:JobRequest
 xmlns:JobRequest="http://www.ibm.com/xmlns/systems/power/firmware/web/mc/2012_10/"
 xmlns="http://www.ibm.com/xmlns/systems/power/firmware/web/mc/2012_10/"
 xmlns:ns2="http://www.w3.org/XML/1998/namespace/k2" schemaVersion="V1_1_0">
    <Metadata>
        <Atom/>
    </Metadata>
    <RequestedOperation kb="CUR" kxe="false" schemaVersion="V1_1_0">
        <Metadata>
            <Atom/>
        </Metadata>
        <OperationName kb="ROR" kxe="false">BackupVIOS</OperationName>
        <GroupName kb="ROR" kxe="false">VirtualIOServer</GroupName>
    </RequestedOperation>
    <JobParameters kb="CUR" kxe="false" schemaVersion="V1_1_0">
        <Metadata>
            <Atom/>
        </Metadata>
        <JobParameter schemaVersion="V1_0">
		    <Metadata>
		        <Atom/>
		    </Metadata>
		    <ParameterName kb="ROR" kxe="false">FileName</ParameterName>
		    <ParameterValue kxe="false" kb="CUR">full_backup1</ParameterValue>
		</JobParameter>
        <JobParameter schemaVersion="V1_0">
		    <Metadata>
		        <Atom/>
		    </Metadata>
		    <ParameterName kb="ROR" kxe="false">NoNIMOL</ParameterName>
		    <ParameterValue kxe="false" kb="CUR">true</ParameterValue>
		</JobParameter>
        <JobParameter schemaVersion="V1_0">
		    <Metadata>
		        <Atom/>
		    </Metadata>
		    <ParameterName kb="ROR" kxe="false">NoMediaRepo</ParameterName>
		    <ParameterValue kxe="false" kb="CUR">true</ParameterValue>
		</JobParameter>
        <JobParameter schemaVersion="V1_0">
		    <Metadata>
		        <Atom/>
		    </Metadata>
		    <ParameterName kb="ROR" kxe="false">NoVGStrusture</ParameterName>
		    <ParameterValue kxe="false" kb="CUR">true</ParameterValue>
		</JobParameter>
        <JobParameter schemaVersion="V1_0">
		    <Metadata>
		        <Atom/>
		    </Metadata>
		    <ParameterName kb="ROR" kxe="false">OverwriteFile</ParameterName>
		    <ParameterValue kxe="false" kb="CUR">true</ParameterValue>
		</JobParameter>
    </JobParameters>
</JobRequest:JobRequest>