13.3.1 Creating a Tenant Folder

This section explains how to create a tenant folder.

When creating tenant folders, perform the operation using the infrastructure administrator (infra_admin) or the administrator (administrator) role.

When registering a user from the ROR console menu, tenant registration in directory services must be prevented by Resource Orchestrator settings.
A definition file for directory service operations is used to define whether user information is registered in the directory service.
For details on the definition file for directory service operations, refer to "6.6.1 Settings for Tenant Management and Account Management" in the "Operation Guide CE".
This operation is not necessary when using internal authentication in Basic mode.
Check if user information is registered in the directory service. If no user information is registered, register it.
This operation is not necessary when using internal authentication in Basic mode.
Right-click the root folder in the orchestration tree, and select [Create]-[Tenant] from the popup menu.
The [Create a Tenant] dialog is displayed.
On the [Tenant] tab, set the following items.
Name
Enter a name for the tenant folder.
Enter up to 32 characters beginning with an alphanumeric character (upper or lower case), and including alphanumeric characters (upper or lower case), underscores ("_"), or hyphens ("-").
User information
User Groups
Enter the name of the user group to register to the tenant folder.
The specified user group is created.
Enter up to 32 characters beginning with an alphanumeric character (upper or lower case), and including alphanumeric characters (upper or lower case), underscores ("_"), or hyphens ("-").
The access scope and role type of the user group are set to the tenant_admin of the tenant to be created.
User ID
- When using directory service authentication or Single Sign-On authentication
Specify a user ID registered in the directory service.
- When using internal authentication
Enter a character string beginning with an alphabetic character and containing up to 32 alphanumeric characters, underscores ("_"), hyphens ("-"), and periods ("."). User group names are case-sensitive.
Password
For Basic mode, only when the internal authentication is used, the password will be displayed.
Enter the password corresponding to the user ID.
The string must be composed of alphanumeric characters (upper or lower case) and symbols, and can be up to 16 characters long.
Confirm password
For Basic mode, only when the internal authentication is used, the password will be displayed.
Enter the password again.
Label
Enter a label for the tenant folder.
Enter up to 32 alphanumeric characters or symbols.
Comment
Enter any comments for the tenant folder.
Enter up to 256 alphanumeric characters or symbols.
On the [Pool] tab, set the following items.
Local pool information
When using a local pool, create a local pool under the tenant folder.
Clicking <Add> displays the [Add a Local Pool] dialog.
Enter the following items:
- Name
- Type
- Priority
Available global pool information
When using a global pool, a global pool is created in a tenant folder.
Clicking <Add> displays the [Add Global Pools] dialog.
Select the pool type of the global pool to add from "Pool type", and select a global pool from the list.
Click <OK>.
The created tenant folder is displayed in the tree.

From the command-line, execute rcxadm tenant create.
For details on the rcxadm tenant create command, refer to "1.3.13 rcxadm tenant" of the "Reference Guide (Resource Management) CE".

Point

When creating a tenant folder, batch creation of resource pools, resource folders, users, and user groups are performed, but resources are not registered. Register resources, referring to "Chapter 7 Registering Resources in Resource Pools".

Note

You cannot specify a registered user for a user group and a user.
Tenants cannot be created when a folder belonging to a tenant is selected.

Changing the Default Value of the Role of the User Group Created During Tenant Creation

The default value of the user group role created when creating a tenant folder is tenant_admin.
To change the default value of roles to administrator, create an empty definition file as follows:

Location of the Definition File

[Windows]
Installation_folder\Manager\etc\customize_data

[Linux]
/etc/opt/FJSVrcvmr/customize_data

Definition File Name: tenant_owner_admin.rcxprop

Tenant Folder Creation Default Definition File

When creating a tenant folder using the ROR console, the default value can be changed.

To change the default value in tenant folder creation, modify the tenant folder creation default definition file.

Location of the Definition File

[Windows]
Installation_folder\Manager\etc\customize_data

[Linux]
/etc/opt/FJSVrcvmr/customize_data

Definition File Name: tenant_config.xml

Definition File Format

<?xml version='1.0' encoding='utf-8'?>
<Tenant>
  <Pools>
    <Pool name="Resource Pool Name" type="Resource Pool Type">
      <Priority>Priority</Priority>
    </Pool>
  </Pools>
  <GlobalPoolLinks>
    <GlobalPoolLink>Global pool name</GlobalPoolLink>
  </GlobalPoolLinks>
</Tenant>

Table 13.2 List of Items Specified in Initial Values of Definition File for Tenant Folder Creation
Element Name	Description	Remarks (Possible Values, Examples)
Resource pool name (Pool name)	Name of the resource pool to create in the tenant folder	Specify the name of the resource pool to create in the tenant folder. For the resource pool name, enter a character string beginning with an alphanumeric character, and containing up to 32 alphanumeric characters, underscores ("_"), and hyphens ("-"). If other values are configured, an error occurs when <OK> is clicked in the tenant creation window.
Resource pool types (Pool type)	Resource pool types	Specify the type of the resource pool to create in the tenant folder. It can be specified using the following methods: vm (VM pool) server (Server pool) storage (Storage pool) network (Network pool) address (Address pool) image (Image pool) If other values are configured, "undefined" is displayed on the tenant creation window, and an error occurs when <OK> is clicked.
Priority (Priority)	Resource pool priority	Specify the priority for the resource pool. For the priority order, specify a number between 1 and 10. If the other values are configured, an error occurs when <OK> is clicked in the tenant creation window.
Global pool name (GlobalPoolLink)	Name of the global pool	Specify the name of the global pool to use inside the tenant folder, using the hierarchy described as follows: /Resource_folder_name/Global_pool_name The global pool names are not displayed in the tenant creation window, in the following cases: When a resource pool which does not exist is specified When something other than a resource pool is specified

Example Definition File

An example definition file is indicated below.

<?xml version='1.0' encoding='utf-8'?>
<Tenant>
  <Pools>
    <Pool name="TenantVMHostPool" type="vm">
      <Priority>5</Priority>
    </Pool>
    <Pool name="TenantServerPool" type="server">
      <Priority>5</Priority>
    </Pool>
    <Pool name="TenantStoragePool" type="storage">
      <Priority>5</Priority>
    </Pool>
    <Pool name="TenantNetworkPool" type="network">
      <Priority>5</Priority>
    </Pool>
    <Pool name="TenantAddressPool" type="address">
      <Priority>5</Priority>
    </Pool>
    <Pool name="TenantImagePool" type="image">
      <Priority>5</Priority>
    </Pool>
  </Pools>
  <GlobalPoolLinks>
    <GlobalPoolLink>/VMHostPool</GlobalPoolLink>
    <GlobalPoolLink>/ServerPool</GlobalPoolLink>
    <GlobalPoolLink>/StoragePool</GlobalPoolLink>
    <GlobalPoolLink>/NetworkPool</GlobalPoolLink>
    <GlobalPoolLink>/AddressPool</GlobalPoolLink>
    <GlobalPoolLink>/ImagePool</GlobalPoolLink>
  </GlobalPoolLinks>
</Tenant>

Sample Definition File

Sample definition files that have appropriate resource pools configured for each operation form are provided.

Copy the sample definition files relevant to the tenant operations, to the storage location for the definition files.

Installation Directories
[Windows]
Installation_folder\Manager\etc\files\tenant_config_samples
[Linux]
/etc/opt/FJSVrcvmr/files/tenant_config_samples
Sample Definition File
- Tenants where combinations of virtual and physical L-Servers are operated
  lserver_multi/tenant_config.xml
- Tenants on which physical L-Servers are operated
  lserver_physical/tenant_config.xml
- Tenants on which virtual L-Servers are operated
  lserver_vm/tenant_config.xml
- Tenants which do not use resource pools
  pool_nothing/tenant_config.xml