Top
ServerView Resource Orchestrator Cloud Edition V3.1.2 Reference Guide (Command/XML)
FUJITSU Software

14.3.4 CreateLServer (Creates a New Server)

Name

[Windows Manager]
Installation_folder\RCXCFMG\bin\CreateLServer - Creates a New Server

[Linux Manager]
/opt/FJSVcfmg/bin/CreateLServer.sh - Creates a New Server


Synopsis

[Windows Manager]

CreateLServer -version version_ID -locale the_language_for_communicating -userId user_ID -password password -orgId tenant_name -lplatformId L-Platform_ID -lserverName server_name -serverType server_type [-lserverType server_type] -diskImageId disk_image_ID -controlNetworkId the_ID_of_the_network_connected_to_the_control_NIC [-networkId the_ID_of_a_network_other_than_the_control_NIC] [-pool the_resource_name_of_the_VM_pool_or_server_pool] [-storagePool the_resource_name_of_the_storage_pool] [-cpuPerf CPU_performance] [-numOfCpu number_of_CPUs] [-cpuReserve reserved_CPU_performance] [-cpuShare CPU_allotment_ratio] [-memorySize amount_of_memory] [-memoryReserve reserved_memory_capacity] [-memoryShare memory_allotment_ratio] [-macAddress address_set_resource_name_of_the_MAC_address] [-priority priority_startup_levels_when_performing_batch_power_supply_controls] [-diskResourceId disk_resource_ID]

[Linux Manager]

CreateLServer.sh -version version_ID -locale the_language_for_communicating -userId user_ID -password password -orgId tenant_name -lplatformId L-Platform_ID -lserverName server_name -serverType server_type [-lserverType server_type] -diskImageId disk_image_ID -controlNetworkId the_ID_of_the_network_connected_to_the_control_NIC [-networkId the_ID_of_a_network_other_than_the_control_NIC] [-pool the_resource_name_of_the_VM_pool_or_server_pool] [-storagePool the_resource_name_of_the_storage_pool] [-cpuPerf CPU_performance] [-numOfCpu number_of_CPUs] [-cpuReserve reserved_CPU_performance] [-cpuShare CPU_allotment_ratio] [-memorySize amount_of_memory] [-memoryReserve reserved_memory_capacity] [-memoryShare memory_allotment_ratio] [-macAddress address_set_resource_name_of_the_MAC_address] [-priority priority_startup_levels_when_performing_batch_power_supply_controls] [-diskResourceId disk_resource_ID]

Function description

This command creates a server within an L-Platform. The user must always specify the ID of the disk image that is used as the initial content required for the startup disk.

This command is executed asynchronously. After the command is successfully executed, the status of the L-Platform changes to Reconfiguring (RECONFIG_ING) during the execution of the operation, and changes back to Operating Normally (NORMAL) when the operation is completed.
When the status of an L-Platform is Reconfiguring, the L-Platform cannot be operated. Use GetLPlatformStatus to check the status of the L-Platform, and execute subsequent operations after waiting for the status to change to Operating Normally.

This command cannot be executed in the following cases:

Note

When creating a physical server, only two commands can be simultaneously executed, due to the limitations of the hardware that is set.
When creating more than two physical servers, leave some time between the executions of this command.

Options

-version

Specify the version ID of the L-Platform API.

-locale

Specify the language used to communicate with the L-Platform API.

-userId

Specify the user ID for executing the L-Platform API.

-password

Specify the password for the user ID for executing the L-Platform API.

-orgId

Specify the tenant name of the user for executing the L-Platform API.

-lplatformId

Specify the L-Platform ID.

-lserverName

Specify the server name.

-serverType

Specify the server type.

-lserverType (optional)

This option does not need to be specified.

-diskImageId

Specify the disk image ID.

-controlNetworkId

Specify the network ID connecting the control NIC.

-networkId (optional)

Specify a network ID other than the control NIC.

-pool (optional)

Specify the VM pool or server pool resource name.

-storagePool (optional)

Specify the storage pool resource name.

-cpuPerf (optional)

Specify CPU performance.

-numOfCpu (optional)

Specify the number of CPUs.

-cpuReserve (optional)

Specify CPU reserve performance.
When using Resource Orchestrator and server virtualization software, if the recognized physical CPU performance values are different, specify a value less than the smaller of the two.

-cpuShare (optional)

[When VM type is VMware]

Specify the CPU share.

[When VM type is Hyper-V]

Specify CPU weight.

-memorySize (optional)

Specify memory size.

-memoryReserve (optional)

[When VM type is VMware]

Specify memory reserve size.

[When VM type is Hyper-V]

Specify memory reserve size.

-memoryShare (optional)

[When VM type is VMware]

Specify memory share.

[When VM type is Hyper-V]

Specify memory weight.

-macAddress (optional)

Specify the address set resource name of the MAC address.

-priority (optional)

Specify the startup priority when using batch power control.

-diskResourceId (optional)

Specify the resource ID of an existing disk that is to be used as the system disk.


Requirements

Permissions

User with OS administrator privilege

Location

Admin server


Example

[Windows Manager]
> CreateLServer -version 2.0 -locale en -userId user3 -password password -orgId tenantA -lplatformId tenantA-M3PGGWCFX -lserverName server02 -serverType economy -lserverType Virtual -diskImageId image-13820fa6e3e -controlNetworkId M3PGGWCFX-N-seg -pool /VMHostPool -storagePool /StoragePool -cpuPerf 1.0 -numOfCpu 1 -cpuReserve 0.7 -cpuShare 1000 -memorySize 1.0 -memoryReserve 0.5 -memoryShare 1000 -priority 64
<?xml version="1.0" encoding="UTF-8"?>
<CreateLServerResponse xmlns="http://cfmg.systemwalker.jp.fujitsu.com">
  <responseMessage>PAPI00000 Processing was completed.</responseMessage>
  <responseStatus>SUCCESS</responseStatus>
  <lserverId>tenantA-M3PGGWCFX-S-0002</lserverId>
</CreateLServerResponse>
[Linux Manager]
# CreateLServer.sh -version 2.0 -locale en -userId user3 -password password -orgId tenantA -lplatformId tenantA-M3PGGWCFX -lserverName server02 -serverType economy -lserverType Virtual -diskImageId image-13820fa6e3e -controlNetworkId M3PGGWCFX-N-seg -pool /VMHostPool -storagePool /StoragePool -cpuPerf 1.0 -numOfCpu 1 -cpuReserve 0.7 -cpuShare 1000 -memorySize 1.0 -memoryReserve 0.5 -memoryShare 1000 -priority 64
<?xml version="1.0" encoding="UTF-8"?>
<CreateLServerResponse xmlns="http://cfmg.systemwalker.jp.fujitsu.com">
  <responseMessage>PAPI00000 Processing was completed.</responseMessage>
  <responseStatus>SUCCESS</responseStatus>
  <lserverId>tenantA-M3PGGWCFX-S-0002</lserverId>
</CreateLServerResponse>

Exit Status

This command returns the following values:

0

The command executed successfully.

non-zero

An error has occurred.