Name
[Windows Manager]
Installation_folder\RCXCFMG\bin\cfmg_importlserver - Import L-Server
[Linux Manager]
/opt/FJSVcfmg/bin/cfmg_importlserver - Import L-Server
Synopsis
cfmg_importlserver -user User_ID -org Tenant_name [-lplatform L-Platform_ID] -lserver L-Server_name [-image Cloning_image_ID] [-os Software_ID] [-vmpool VM pool_name | Server_pool_name] [-sparepool Spare_server_pool_name] [-storagepool Storage_pool_name] [-host Host_name]
Functional Description
This command imports the L-Server with the specified L-Server name as an L-Platform.
This command creates an L-Platform in the tenant specified in the -org option and moves the L-Server specified in the -lserver option to the created L-Platform.
The following L-Servers can be imported to an existing L-Platform by specifying the -lplatform option:
New L-Platforms created in the ROR console L-Platform management window
L-Platforms created with the L-Platform API and L-Platform API related operation commands
L-Platforms created when the -lplatform option in this command is not specified
Note
When an L-Server for infrastructure administrator is imported to an L-Platform, the operation privileges of the L-Server are transferred to the tenant administrator or the tenant user.
When this L-Server is released from the L-Platform by the cfmg_deletelserver command, the L-Server is changed back to the one for infrastructure administrator.
An L-Platform template is generated when this command is executed. An L-Platform template that has been generated by this command will not be displayed in the Template Management window. Specifying the -a option in the cfmg_listtemplate command or the cfmg_listimageinfo command will allow an L-Platform template that has been generated by this command to be displayed.
L-Servers without network interface cards (NICs) cannot be imported.
An L-Server that exists under a tenant cannot be imported to another tenant.
If an L-Server exists in a location other than under a tenant is to be imported, the power of the L-Server to be imported must be switched off.
Do not import physical L-Servers that have VM hosts installed. Refer to "Appendix D Installing VM Hosts on Physical L-Servers" in the "Setup Guide CE" for information on installing VM hosts on a physical L-Server.
When Solaris zones are constructed on the guest domain and the guest domain is registered as a VM host, virtual L-Server linked with the guest domain cannot be taken into L-Platform.
Only L-Servers located within a single-tenant or resource folder can be imported.
To import L-Servers located within a multi-tenant or resource folder, move them to single level or lower using the ROR Console for the resource management.
Refer to "Chapter 21 Resource Folder Operations" in the "User's Guide for Infrastructure Administrators (Resource Management) CE" for information on tenants and resource folders.
When using accounting, snapshots collected before import are not subject to accounting
When importing an L-Server that does not use an L-Server template, it is necessary to register a usable L-Server template in the L-Platform beforehand.
When you want to specify a particular L-Server template in the L-Server being imported, register image information that specifies the L-Server template beforehand, then specify that image information with the -image option. When image information is not specified, then any L-Server template of those registered will be set.
Options
Specifies the user ID of the tenant administrator, tenant user or dual-role administrator who will be configured as the owner of the imported L-Platform.
Specifies the tenant ID to be set in the L-Platform to be imported.
Specify the L-Platform ID of the L-Platform that is the destination for the import.
A new L-Platform is created for the import if this is omitted.
Specify the L-Server name of the L-Server that is to be imported.
Specify as follows:
For L-Servers deployed in a resource folder or tenant
Specify by using the resource folder name and tenant name separated by a "/".
For example: /folder1/server1
For L-Servers that are not deployed in a resource folder or tenant
The "/" at the beginning may be omitted.
For example: server2
Specifies the image ID if image information is to be set in the L-Server to be imported.
If this option has not been specified, default image information will be used.
To manage software information or patch information, register image information in advance, and then specify it in this command.
If a cloning image does not exist, specify the -n option in the cfmg_addimageinfo command to register image information.
To set the "Type" of a server displayed on the L-Platform management window, specify this option too. If it has not been specified, the "Type" will be set to the name of an arbitrary registered L-Server template.
If the server virtualization software is OVM for SPARC, L-Server templates cannot be registered, and therefore image information cannot be registered. Accordingly, the "Type" will not be set.
If ordinary image information has been specified, to delete it, the L-Platform that has been imported must be returned.
Specifies the software ID of the software information of the operating system to be set in the L-Server to be imported.
If the -image option has been specified, this option will be ignored even if it is specified.
Software information other than that of the operating system cannot be specified.
If both this option and the -image option have been omitted, the software ID "SW00000001" information will be set.
The default will be the following operating system information:
- "Windows Server 2008 Standard (32bit)"
The cfmg_listsoft command can be used to reference the software IDs.
Specifies the VM or server pool name to be set for the L-Server to be imported.
Specify as follows:
For VM pools deployed in a resource folder or tenant
Specify by using the resource folder name and tenant name separated by a "/".
Example: /folder1/VMPool
For VM pools that are not deployed in a resource folder or tenant
The "/" at the beginning is required.
Example: /VMPool
Neither CPU nor memory size can be changed when reconfiguring L-Platform that is in use.
If the accounting is being used and this option has not been specified, accounting calculations cannot be performed for CPU and memory in relation to the VM or server pool.
Specifies the spare server pool name to be set for a physical L-Server to be imported.
Specify as follows:
If the server pool is located in a resource folder or tenant:
Specify by using the resource folder name and tenant name separated by a "/".
Example: /folder1/ServerPool
Otherwise:
The "/" at the beginning is required.
Example: /ServerPool
This option will be ignored if anything other than a physical server is specified.
Specifies the storage pool name to be set in the L-Server to be imported.
Specify as follows:
For storage pools deployed in a resource folder or tenant
Specify by using the resource folder name and tenant name separated by a "/".
Example: /folder1/StoragePool
For storage pools that are not deployed in a resource folder or tenant
The "/" at the beginning is required.
Example: /StoragePool
If there are a number of disks, specify the storage pool names in order of disk number, with each delimited by a comma.
If the number of disks is larger than that of the specified storage pool names, the storage pool name specified at the end will be set for the excess disks.
If this option has not been specified, a storage pool name will not be set. Disk size cannot be changed when reconfiguring L-Platforms in use.
If the accounting is being used and this option has not been specified, accounting calculations cannot be performed for disks in relation to the storage pool.
Specifies the host name to be set in the L-Server to be imported.
If this option has not been specified, a host name will be generated automatically according to the host name generation method.
Requirements
Infrastructure administrator with OS administrator privilege
Admin server
Example
> cfmg_importlserver -user user3 -org div3 -lplatform tenant1-123 -lserver lsv3
<?xml version="1.0" encoding="Windows-31J"?>
<result>
<templateId>template-12fe41c4b58</templateId>
<vsysId>tenant1-123</vsysId>
</result>Remarks: Encoding will be "UTF-8" with the Linux Manager.
Exit Status
This command returns the following values:
Outputs the L-Platform ID and template ID.
An error has occurred.