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 rcxadm imagemgr set -attr imagedir=dir rcxadm imagemgr set -attr {backup|clone}.maxversion=value
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)" or "6.5 Changing the Maximum Number of Cloning Image Versions (Virtual 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".
Subcommands
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.
Options
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 should match 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.
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.
Examples
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> |
Exit Status
This command returns the following values:
The command executed successfully.
An error has occurred.
This section explains the additional functions of the Cloud Edition.
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 set -attr {vm.clone|vm.snapshot}.maxversion=value
Description
The additional functions of rcxadm imagemgr are indicated below.
You can specify vm.clone and vm.snapshot in attributes used for controlling the number of image versions.
rcxadm imagemgr set -attr {vm.clone|vm.snapshot}.maxversion=max_version
Options
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.
