Top
ServerView Resource Orchestrator V2.3.0 Reference Guide
Chapter 1 Command Reference > 1.4 Image Operations > 1.4.1 rcxadm image
PreviousNext

1.4.1 rcxadm image

rcxadm image is an existing RCVE command.
For details, refer to "4.1 rcxadm image" in the "ServerView Resource Coordinator VE Command Reference".

This section explains the additional functions.


Name

[Windows]
Installation_folder\Manager\bin\rcxadm image - image operations

[Linux]
/opt/FJSVrcvmr/bin/rcxadm image - image operations


Format

rcxadm image create -server resource -name image [-comment comment] [-to pool] [-storage storagename] [-nowait]
rcxadm image delete -server resource -version version
rcxadm image delete -name image -version version
rcxadm image restore -server resource [-version version] [-nowait]
rcxadm image list -type cloning [-name image] [-detail]
rcxadm image list -type snapshot [-server resource] [-detail]
rcxadm image snapshot -server resource [-comment comment] [-online] [-nowait]
rcxadm image move -name image -to pool [-nowait]

Description

The additional functions of rcxadm image are indicated below.

Note

Cloning images with the same name can be stored up to the maximum of the versions.

When collecting cloning images using the create subcommand will cause a number exceeding the maximum to be collected, an error will occur.

Check the version of the cloning image name to be collected using the list subcommand, delete any unnecessary cloning image versions using the delete subcommand, and then perform collection of cloning images.

The maximum number of versions of the cloning images is 3 in default.

For details on how to change the number of cloning images versions, refer to "1.7.2 rcxadm imagemgr".


Subcommands

create

Collects a cloning image of the specified L-Server.

list

Displays the cloning images and snapshot images of the specified L-Server.

The following detailed information is displayed:

  • For cloning images

    Table 1.48 Cloning Image Information

    Item Name

    Description

    NAME

    Name of cloning images

    VERSION

    Version of cloning images

    CREATIONDATE

    Date and time of cloning image collection

    COMMENT

    Comments for cloning images

  • For snapshots

    Table 1.49 Snapshot Information

    Item Name

    Description

    SERVERNAME

    Name of the server (physical server/VM host) used to back up snapshot images

    VERSION

    Version of snapshot image

    BACKUPDATE

    Date and time of snapshot image collection

    COMMENT

    Comment for snapshot image

When the -detail option is specified, in addition to the information displayed by the list subcommand, the TYPE of the image or snapshot is displayed.

  • For cloning images

    Table 1.50 Detailed Information of Cloning Images

    Item Name

    Description

    NAME

    Name of cloning images

    VERSION

    Version of cloning images

    CREATIONDATE

    Date and time of cloning image collection

    TYPE

    VM type of a cloning image

    [VMware]
    VMware

    [Hyper-V]
    Hyper-V

    [Oracle VM]
    Oracle VM

    [Xen]
    Xen

    COMMENT

    Comments for cloning images

  • For snapshots

    Table 1.51 Detailed Information of Snapshots

    Item Name

    Description

    SERVERNAME

    Name of the server (physical server/VM host) used to back up snapshot images

    VERSION

    Version of snapshot image

    BACKUPDATE

    Date and time of snapshot image collection

    TYPE

    VM type of a snapshot

    [VMware]
    VMware

    [Hyper-V]
    Hyper-V

    [Oracle VM]
    Oracle VM

    [Xen]
    Xen

    COMMENT

    Comment for snapshot image

delete

In addition to the RCVE functions, an L-Server snapshot can be deleted with the delete subcommand.

restore

In addition to the RCVE functions, an L-Server snapshot can be restored with the restore subcommand.

snapshot

Collects a snapshot of the specified L-Server.
Setting is only possible for virtual L-Servers.

move

Images registered in the orchestration tree are moved between resource pools.


Options

-server resource

Specify the name of the target L-Server to operate in resource.

For the L-Server allocated in the resource folder, specify the resource folder name using slashes ("/").

Example

When specifying the L-Server directly under the TopFolder:

/TopFolder/L-Server_name

-nowait

Use this option to return directly to the command prompt without waiting for the operation specified in the subcommand to complete its execution.

-to pool

Specify the name of the resource pool for storing the cloning image or the name of the destination resource pool.
If omitted, it is assumed that the resource pool with the highest priority from the resource pools with update rights has been specified.

For the resource pool located in the resource folder, specify the resource folder name using slashes ("/").

Example

When specifying the resource pool directly under the TopFolder:

/TopFolder/Resource_pool_name

-storage storagename

Enter the name of the virtual storage or the library shared folder for storing the collected cloning image.
If omitted, it is assumed that the virtual storage resource containing the L-Server for collecting cloning images has been specified.

[Hyper-V]
It is assumed that the name of the regulated shared library folder on the SCVMM server is specified.

[Xen]
If omitted when using RHEL5-Xen, virtual storage is automatically selected from the same storage pool as the virtual storage used by the target L-Server to collect from.

-type cloning|snapshot

Specify the type of image. If you specify snapshot, a snapshot image is displayed.

-detail

To display the detailed information for the type of image.

-comment comment

In comment, enter a comment that identifies the snapshot.
Enter up to 128 alphanumeric characters or symbols.
However, use of percent signs ("%"), back slashes ("\"), and double quotes (") is not allowed in comment.

Note

If blank spaces are included in comment, enclose the comment character string using double quotes ( " ).

-online

Specify when executing a snapshot, regardless of the status of the L-Server.

-name image

In image, enter a name to identify the collected cloning image.

When the subcommand is list, delete, or move, if cloning images are registered in resource pools, specify images including the resource folder in the path name. When the subcommand is not registered in resource pools, specify it using the cloning image name.

-version version

In version, specify the version of the cloning image or snapshot.

Note

  • When creating an image, a template is created in the server virtualization software with the following name:

    Table 1.52 Name in Server Virtualization Software

    Server Virtualization Software

    Name in Server Virtualization Software

    VMware
    Hyper-V
    Oracle VM

    Cloning_image_name[_index]@version_number

    When creating a template in the server virtualization software, do not use a name with the above format.

  • When creating a template from a VM guest in the server virtualization software, set the system disk of the VM guest as indicated below.

    Table 1.53 Settings for System Disks

    Server Virtualization Software

    System Disk

    VMware

    Disk with SCSI controller: 0, ID:0

    Hyper-V

    Device, Primary channel (0)

    Oracle VM

    When the L-Server is an HVM(Hardware Virtualized Machine): hda
    When the L-Server is a PVM(Para-Virtualized Machine): xvda

  • Make sure the name image specified when creating an image does not conflict with the name of the cloning image for the physical server. For details on the cloning image of the physical server, refer to "Chapter 8 Cloning [Windows/Linux]" in the "ServerView Resource Coordinator VE Setup Guide".

    [VMware] [Hyper-V]
    For a cloning image name, enter a character string beginning with an alphabetic character and containing up to 32 alphanumeric characters and underscores ("_").

    [Xen]
    For a cloning image name, enter a character string beginning with an alphabetic character and containing up to 22 alphanumeric characters and underscores ("_").


Examples

PreviousNext
Copyright FUJITSU LIMITED 2011