Top
ServerView Resource Orchestrator Cloud Edition V3.0.0 Reference Guide for Infrastructure Administrators (Resource Management)

1.3.9 rcxadm folder

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] [-detail]
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]
rcxadm folder start -name name [-nowait]
rcxadm folder stop -name name
rcxadm folder restart -name name [-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.

Resources can be grouped using the resource folder management functions. Grouping resources enables users to perform operation of multiple resources together and improve operability.
Resource folders can be used with user/role management to ensure folder level security.

Resource folders are categorized into the following two types, depending on the resources to register:

Subcommands

create

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.

list

Displays the list of resource folders and the resources and subfolders included in the resource folders.

  • When specifying -name for the option

    Displays the list of the resources and subfolders included in the specified resource folder.

  • When not specifying -name for the option

    Displays the list for the top-level resource folders.

The following detailed information is displayed:

Table 1.42 Resource Folder Information

Item Name

Description

TYPE

Type of resource folder, resource pool, or each resource

NAME

Name of the resource folder, resource pool, or each resource

FOLDER_TYPE (*1)

Type of the folder

One of the following is displayed:

  • For tenants

    "TENANT" is displayed.

  • For L-Platforms

    "LPLATFORM" is displayed.

  • Other folder types

    A hyphen ("-") is displayed.

LABEL

Label of the resource folder, resource pool, or each resource

*1: When specifying -detail for the option, it is displayed.

show

Displays the detailed information of a resource folder.

The following detailed information is displayed:

Table 1.43 Detailed Information for Resource Folders

Item Name

Description

NAME

Resource folder name

LABEL

Resource folder label

COMMENT

Comment for the resource folder

modify

Modifies the following items of the specified resource folder:

  • Resource Folder Name

  • Label

  • Comment

  • Priority

move

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.

delete

Deletes a resource folder.

start

Starts an L-Server in a resource folder.

stop

Stops an L-Server in a resource folder.

restart

Restarts an L-Server in a resource folder.


Options

-file file.xml

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 "2.7 Resource Folders".

-detail

Use this option to display the detailed information for a desired resource folder.

-nowait

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.

This option also executes subsequent operations for L-Servers to which resources are not allocated without waiting for resource allocation.

-name name

In name, specify the resource folder name. For the hierarchized resource folder, specify the resource folder name using slashes ("/").

Example

To specify SecondFolder directly below TopFolder:

/TopFolder/SecondFolder

-type type

In type, specify a resource folder type for the resource folder. Specify one of the following for the resource folder type:

  • "server"

  • "lserver"

If omitted, "lserver" is set.

-label label

In label, specify the label for the resource folder.

-comment comment

In comment, specify any comments for the resource folder.

-new_name name

In name, specify a new name for the target resource folder to perform an operation with.

-to folder

Specify the destination resource folder in folder. For the hierarchized resource folder, specify the resource folder name using slashes ("/"). When omitted, the folder is moved to the home folder.

When executed by a user who has multiple access scopes specified, it cannot be omitted. Specify a resource folder.


Examples