Name
[Windows]
Installation_folder\Manager\bin\rcxadm folder - resource folder operations
[Linux]
/opt/FJSVrcvmr/bin/rcxadm folder - resource folder operations
Format
rcxadm folder create -file file.xml [-nowait] rcxadm folder create -name name [-type type] [-label label] [-comment comment] [-nowait] rcxadm folder list [-name name] [-type type] rcxadm folder show -name name [-type type] rcxadm folder modify -name name [-type type] {[-new_name name] [-label label] [-comment comment]} [-nowait] rcxadm folder move -name name [-type type] [-to folder] [-nowait] rcxadm folder delete -name name [-type type] [-nowait]
Description
rcxadm folder is the command used to manage resource folders. Use resource folder management to group resources when the number of resources managed by Resource Orchestrator becomes large or when you want to manage resources in work units. Since the resource folders can be arranged in a hierarchy, you can perform detailed categorization for resources.
The resource folder management function improves operability by grouping resources so operations can be performed on them together.
Resource folders can be used with user/role management to ensure folder level security.
Resource folders are categorized into the following three types, depending on the resources to register:
Orchestration
Registers L-Servers, network resources, disk resources, and resource pools.
Servers
Registers server tree blade chassis and rack mount servers.
Storage
Registers virtual storage resources.
Subcommands
Creates a new resource folder. Use the -file option to create the specified resource folder with resources included. If the resource folder specified in the XML file already exists, only the specified resources are created.
Displays the list of resource folders and the resources and subfolders included in the resource folders.
If you specify the -name argument, the specified resource folder and a list of the resources and subfolders included in the folder are displayed. If you do not specify the -name argument, the list of top level resource folders is displayed.
Displays the detailed information for a resource folder.
Modifies the name, label, comment, and priority of the specified resource folder.
Moves a resource folder to the specified resource folder. If the destination resource folder is not specified, the folder is moved to the home folder.
Deletes a resource folder.
Options
In file.xml, specify the XML file that specifies the resource folder to create and the resources to include in the resource folder. For details on the XML file definition, refer to "H.5 Resource Folders".
Use this option to return directly to the command prompt without waiting for the operation of the resource folder specified in the subcommand to complete its execution.
In name, specify the resource folder name. If the resource folders are arranged in a hierarchy, specify the resource folder name connected with slashes ("/").
Example
To specify SecondFolder directly below TopFolder:
/TopFolder/SecondFolder
In type, specify a resource folder type for the resource folder. Specify either "server" or "lserver" for the resource folder type. If omitted, "lserver" is set.
In label, specify the label for the resource folder.
In comment, specify any comments for the resource folder.
In name, specify a new name for the target resource folder to perform an operation with.
Specify the destination resource folder in folder. When omitted, the folder is moved to the home folder.
Examples
To display the list of resource folders and the resources and subfolders included in the resource folders:
>rcxadm folder list <RETURN>
TYPE NAME LABEL
---- ---- -----
Folder TenantA -
Folder TenantB -
Pool ImagePool -
Pool ImgPool -
Pool NetworkPool -
Pool StoragePool -
Pool VMPool - |
To display the list of the resources and subfolders included in the specified resource folder:
>rcxadm folder list -name TenantA <RETURN>
TYPE NAME LABEL
---- ---- -----
Folder testA -
LServer test4 - |
To display the detailed information for a resource folder:
>rcxadm folder show -name TenantA <RETURN>
name : TenantA
label :
comment : |
