12.1 rcxadm role

Name

[Windows Manager]
Installation_folder\SVROR\Manager\bin\rcxadm role - role operations

[Linux Manager]
/opt/FJSVrcvmr/bin/rcxadm role - role operations

Format

rcxadm role create -name name -base base_rolename [-label label -comment comment]
rcxadm role create -name name -init
rcxadm role modify -name name -file file.xml
rcxadm role delete -name name
rcxadm role list
rcxadm role show -name name -format {text|xml} [-outfile outfile]

Description

rcxadm role is the command used to manage role definitions.

Subcommands

create: Creates a role based on a basic role.
or The deleted basic role is restored.

modify: Modifies the role definition.

delete: Deletes the role.

list

Displays a list of roles in text format.

Table 12.1 Role Information
Item Name	Description
NAME	Role name
LABEL	Label for the role
COMMENT	Comment for the role

show

Displays the detailed information for the specified role definition in text format or XML format.
In text format, the following information is displayed.

Table 12.2 Detailed Role Information
Item Name	Description
NAME	Role name
LABEL	Label for the role
COMMENT	Comment for the role
OPERATION AUTHORITY	Operation authority Displays operations that can be performed.

For XML format, the information in "15.8 Roles" is displayed.

Options

-name name: Specify the role name.

-base base_rolename: Specify the name of the basic role that has been copied.

-label label: Specify the label for the role.

-comment comment: Specify the comment for the role.

-init: Use the option the basic role is restored.

-file file.xml: Specify the XML file that defines the role to change.
When changing the operation authority, specify all operation names the role has permission for.
For details on the XML file definition, refer to "15.8 Roles".

-format {text|xml}: Specify the display format. When -format is omitted, it is displayed in text format.
It is possible to change role definitions using the output results in XML format.

-outfile outfile: Specify the file that stores the output information. Information is output in UTF-8 format.
Set it when changing the role definition using the output results in XML format with multi-byte characters included.
When the specified file already exists, an error occurs.

Requirements

Permissions

OS Administrator
Infrastructure administrator
Administrator

Location: Admin server

Examples

To display the list of roles:

>rcxadm role list <RETURN>

NAME                 LABEL                  COMMENT
------------------   -------------------    -----------------------
administrator        -                      -
operator             -                      -
...
infra_admin_custom   infra_admin custom1    infra admin for tenantA

To display the detailed information for the specified role:

>rcxadm role show -name administrator <RETURN>
NAME:         administrator
LABEL:        administrator
COMMENT:      administrator
OPERATION AUTHORITY:
LPlatform
  create
  modify
  ...
LServer
  create
  ...
  ...

Exit Status

This command returns the following values:

0: The command executed successfully.

non-zero: An error has occurred.