C.6.4 Transferring Tenants and Tenant Administrators

The tenant management role cannot operate tenants and L-Servers in tenants that were operated on ROR V2.3.

To enable the tenant management role to operate tenants that were operated with ROR V2.3, use either of the following procedures to transfer the tenant according to the position in which the tenant was created.

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 role.

When the tenant is created directly under the orchestration tree

Create user groups.
The user group must have the same name as the tenant name, the tenant name must be in the access scope, and tenant_admin (tenant administrator) must be set for the role.
Create user groups according to the following procedure.
```
>rcxadm usergroup create -name tenant_name -role tenant_name=tenant_admin
```
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
```
For details on the rcxadm usergroup command, refer to "7.2 rcxadm usergroup" in the "Reference Guide (Command/XML) CE".
Modify tenants.
The tenants which were operated with ROR V2.3 are displayed in the [Tenants] tab of the ROR console.
Set the following information 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".
Perform the "Common Procedures".

When the tenant is not created directly under the orchestration tree

Transfer the tenant data 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.

Create tenants.
In the [Tenants] tab of the ROR console, create a Tenant.
Move resources.
In the [Resources] 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.
Perform the "Common Procedures".
Delete the old tenant.
Delete the old tenant using the rcxadm tenant delete command.
```
>rcxadm tenant delete -name /OldTenant
```

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.
1. 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".
2. 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:
  - E-mail address
  - First name
  - Family name
  For details on the XML definition of tenant administrators, refer to "15.10.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>
```
3. 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".