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.
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".
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)
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.
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 |
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)
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.
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.
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:
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.
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:
Specify this option to display the maintenance mode status of the virtual cloning images.
The following options can be specified for the set subcommand:
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.
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
OS Administrator
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)
When specifying a path for the image files folder that includes no blank spaces
[Windows Manager]
When changing to C:\temp
>rcxadm imagemgr set -attr imagedir=C:\temp <RETURN> |
[Linux Manager]
When changing to /tmp
# rcxadm imagemgr set -attr imagedir=/tmp <RETURN> |
When specifying a path for the image files folder that includes blank spaces
[Windows Manager]
When changing to C:\temp\Resource Orchestrator VE
>rcxadm imagemgr set -attr imagedir=C:\temp Resource Orchestrator VE" <RETURN> |
[Linux Manager]
When changing to \tmp\Resource Orchestrator VE
# rcxadm imagemgr set -attr imagedir="/tmp/Resource Orchestrator VE" <RETURN> |
Usage Example (Operations for virtual images of L-Servers)
To display image management information
>rcxadm imagemgr info -extend vm.clone.maintenance <RETURN> |
To configure maintenance mode of virtual cloning images
>rcxadm imagemgr set -attr vm.clone.maintenance=true <RETURN> |
Exit Status
This command returns the following values:
The command executed successfully.
An error has occurred.