F.6.6 Transferring Tenants and Tenant Administrators

Upgrading from V3.0

Tenants, tenant administrators, and tenant users of the previous version are transferred as is. The transfer operation is unnecessary.

Upgrading from V2.3

The tenant management role cannot operate tenants and L-Servers in tenants that were operated on V2.3.
To make the tenant management role operate tenants that were operated with V2.3, transfer the tenant according to the position in which the tenant was made according to either following procedures.

Use the multiple roles and operate tenants when the transfer is unnecessary. When one user operates two or more tenants, it is necessary to use the multiple roles.

When the tenant is made right under the orchestration tree
1. Create user groups.
  The user groups should be the same names as the tenant name, the tenant name be set in the access scope, and tenant_admin (tenant administrator) be set to the role.
  Create user group according to the following procedures.
  > rcxadm usergroup create -name tenant_name -role tenant_name=tenant_admin <RETURN>
  Modify user groups according to the following procedures when user groups of the same name as the tenant name already exist.
  > rcxadm usergroup modify -name tenant_name -role tenant_name=tenant_admin <RETURN>
  For details on the rcxadm usergroup command, refer to "7.2 rcxadm usergroup" in the "Reference Guide (Command/XML) CE".
2. Modify tenants.
  The tenant which is operating it with V2.3 is displayed in the [Tenant] tab of the ROR console.
  Set the following information by using the [Modify Tenant] window.
  - Tenant display name
  - E-mail address
  For details on the [Modify Tenant] window, refer to "11.4 Modifying a Tenant" in the "User's Guide for Infrastructure Administrators CE".
3. Do the "Common Procedures".
When the tenant is made besides right under the orchestration tree
You need to transfer the tenant to the newly created tenant.
Transferred Data of Tenants
- Users (users who operate the tenant as tenant administrators, tenant operators, and tenant monitors)
- Resources in local pools of tenants
- L-Server
Use the following procedure to transfer tenants and tenant administrators.
1. Create tenants.
  In the [Tenant] tab of the ROR console, create a Tenant.
2. Move resources.
  In the [Resource] tab of ROR console, move the following resources in the old tenant to the new tenant. If the L-Server has been started, move the resources after stopping it.
  - Resources in the local pool
    Move them to a local pool or a global pool of the newly created tenant.
  - L-Server
    Move it to the newly created tenant.
3. Do the "Common Procedures".
4. Delete the old tenant.
  Delete the old tenant using the rcxadm tenant delete command.
  >rcxadm tenant delete -name /OldTenant <RETURN>

Common Procedures

Modify tenant users.

Allocate appropriate roles to the users operating as tenant administrators, tenant operators, or tenant monitors among users who operated the earlier versions.

Use the following procedure to allocate roles to users.

Output the user information in files in XML format.
>rcxadm user list -format xml > myusers.xml
For details on the rcxadm user command, refer to "7.1 rcxadm user" in the "Reference Guide (Command/XML) CE".

Edit the XML files.

Delete the information of other users from the XML file, so that only the users operating as tenant administrators, tenant operators, and tenant monitors remain.

Define the tenant administrator roles to allocate.

Add the following information:

Email address
First name
Family name

For details on the XML definition of tenant administrators, refer to "15.8.1 Tenant Management Roles and Tenant User Role" in the "Reference Guide (Command/XML) CE".

Example

Example of the XML definition in which the tenant administrator role of "NewTenant" is allocated to the user "john"

<?xml version="1.0" encoding="utf-8"?>
<Users>
  <User name="john">
    <Roles>
      <Role name="tenant_admin">
        <Scopes>
          <Scope>NewTenant</Scope>
         </Scopes>
      </Role>
    </Roles>
    <MailAddress>john@mail.example.com</MailAddress>
    <ActualName>
      <FirstName>john</FirstName>
      <LastName>fujitsu</LastName>
    </ActualName>
 </User>
</Users>

Allocate the tenant administrator roles to the user by specifying the XML file edited in the rcxadm user command.
>rcxadm user modify -file my_tenantadmins.xml

Import L-Servers to the L-Platform.
Import L-Servers to the L-Platform using the cfmg_importlserver command.
>cfmg_importlserver -user john -org NewTenant -lserver /NewTenant/lserverA
For details, refer to "7.2.3.2 Importing L-Servers" in the "Operation Guide CE".