Top
ServerView Resource Orchestrator Cloud Edition V3.1.2 Reference Guide (Command/XML)
FUJITSU Software

5.9 rcxadm imagemgr

Name

[Windows Manager]
Installation_folder\SVROR\Manager\bin\rcxadm imagemgr - Image management settings

[Linux Manager]
/opt/FJSVrcvmr/bin/rcxadm imagemgr - Image management settings


Format

rcxadm imagemgr info [-extend vm.clone.maintenance]
rcxadm imagemgr set -attr imagedir=dir
rcxadm imagemgr set -attr {backup|clone|vm.clone|vm.snapshot}.maxversion=value
rcxadm imagemgr set -attr vm.clone.maintenance={true|false}

Description

rcxadm imagemgr is the command used to change the image files folder location, or the maximum number of image versions that can be kept in Resource Orchestrator.

Operations for system images and cloning images of servers

For details on changing the maximum number of system image versions, refer to "6.3 Changing the Maximum Number of System Image Versions" in the "User's Guide for Infrastructure Administrators (Resource Management) CE".

For details on changing the maximum number of cloning image versions, refer to "6.4 Changing the Maximum Number of Cloning Image Versions (Physical Servers)" in the "User's Guide for Infrastructure Administrators (Resource Management) CE".

A new folder should be created when changing the location of the image file storage folder.

For details on changing the path for the image file storage folder, refer to "6.7 Changing the Image Folder Location" in the "User's Guide for Infrastructure Administrators (Resource Management) CE".

Operations for virtual images for L-Servers

vm.clone and vm.snapshot can be specified in attributes used for controlling the number of virtual image versions.

The maintenance mode of virtual cloning images can be configured and released.

The following is displayed:

  • The number of virtual image versions

  • The status of the maintenance mode of virtual cloning images.


Subcommand (Operations for system images and cloning images of servers)

info

Displays current image settings (the maximum number of image versions and the location of the image files folder).
The following properties are displayed for each server.

Table 5.1 info Subcommand Display Parameters

Item Name

Description

backup.maxversion

Maximum number of system image versions

clone.maxversion

Maximum number of cloning image versions

imagedir

Location of the image files folder

set

Sets a new location for the image files folder, or sets a new limit for the number of image versions.


Subcommand (Operations for virtual images of L-Servers)

info

Displays current image settings (the maximum number of system images, cloning images, virtual cloning images, and snapshot versions, image file storage folder paths, and the maintenance mode status of virtual images).
The following properties are displayed for each server.

Table 5.2 info Subcommand Display Parameters

Item Name

Description

backup.maxversion

Maximum number of system image versions

clone.maxversion

Maximum number of cloning image versions

vm.clone.maxversion

Maximum number of virtual cloning image versions

vm.snapshot.maxversion

Maximum number of snapshot versions

imagedir

Location of the image files folder

vm.clone.maintenance (*)

The status of the maintenance mode of virtual cloning images.

* Note: This is displayed when -extend vm.clone.maintenance is specified for the option.


set

The maintenance mode of virtual cloning images is configured or released.


Option (Operations for system images and cloning images of servers)

The following options can be specified for the set subcommand:

-attr imagedir=dir

Specify a new location (path) for the image files folder in dir.
The specified folder path must match all of the following requirements.

  • The specified path should be no more than 100 characters long

  • The specified path should include none of the following characters

    """, "|", "*", "?", "/", "<", ">", ",", "%", "&", "^", "=", "!", ";"

    [Windows Manager]
    "/"

    [Linux Manager]
    "\"

  • Only local folder paths are allowed (UNC paths are not permitted)

  • Folders must be created beforehand

  • When using blank spaces in the specified path, enclose the whole specified path in double quotes ( " )

  • Do not add "\" to the end of the specified path

  • The specified path should not point to any of the following folders

    [Windows Manager]
    Installation_folder\SVROR\Manager

    [Linux Manager]
    /opt/FJSVrcvmr

    /etc/opt/FJSVrcvmr

    /var/opt/FJSVrcvmr

  • The specified folder is empty

    [Linux]
    If a partition (file-system) was specially created to store image files, this partition will include a "lost+found" folder, and therefore cannot be considered as empty.

    In that case, be sure to create and use a dedicated directory to store image files within that partition.

  • The specified path should have proper security settings

    [Linux]
    For safer administration, it is recommended to use either the following permissions settings for each ancestor directory of the image files directory.

    • Give write permissions only to system administrators

    • Use the sticky bit to prevent other users from renaming or deleting image files

    If permissions are not set as above, this command may fail to change the image files folder location.

When changing the image files folder location, image files are copied to the new location, which may take some time to complete.

-attr {backup|clone}.maxversion=value

Changes the maximum number of image file versions.

  • To change the maximum number of system image versions

    Specify backup.

  • To change the maximum number of cloning image versions

    Specify clone.
    Specify a new maximum number of image file versions in value.
    Enter a numerical value between 1 and 10 in value.


Option (Operations for virtual images of L-Servers)

The following options can be specified for the info subcommand:

-extend vm.clone.maintenance

Specify this option to display the maintenance mode status of the virtual cloning images.

The following options can be specified for the set subcommand:

-attr {vm.clone|vm.snapshot}.maxversion=max_version

Specify the maximum number of image file versions.

  • For the number of cloning image versions

    Specify "vm.clone".

  • For the number of snapshot versions

    Specify "vm.snapshot".

In max_version, specify the maximum number of image file versions to change. The values that can be specified for max_version are any value between 1 and 10.

-attr vm.clone.maintenance={true|false}

The maintenance mode of virtual cloning images is configured or released.

  • When configuring maintenance mode

    Specify "true".

  • When releasing maintenance mode

    Specify "false".

Note

  • It is not necessary to restart the services of managers of Resource Orchestrator after modifying the maintenance mode settings.

  • When configuring maintenance mode of virtual cloning images, take caution regarding the following points:

    • When creating, modifying, or deleting cloning images in VM management software, the information is reflected on the ROR console after releasing maintenance mode of the virtual cloning images.

    • Even if server management software is updated, virtual cloning images are not updated.

    • Do not import DR.

      The information of virtual cloning images is not imported during DR import, import will fail.
      Import DR after releasing the maintenance mode of virtual cloning images.


Requirements

Permissions

OS Administrator

Location

Admin server

The manager should be stopped when changing the image files folder location. For information on stopping managers, refer to "2.1 Starting and Stopping Managers" in the "Operation Guide CE".

If the ROR console was opened, the Web browser should be refreshed after changing the maximum number of image file versions.


Usage example (Operations for system images and cloning images of servers)

Usage Example (Operations for virtual images of L-Servers)

Exit Status

This command returns the following values:

0

The command executed successfully.

non-zero

An error has occurred.