14.3.24 UpdateLServerConfiguration (Changes the Performance of a Server)

Name

[Windows Manager]
Installation_folder\RCXCFMG\bin\UpdateLServerConfiguration - Changes the Performance of a Server

[Linux Manager]
/opt/FJSVcfmg/bin/UpdateLServerConfiguration.sh - Changes the Performance of a Server

Synopsis

[Windows Manager]

UpdateLServerConfiguration -version version_ID -locale the_language_for_communicating -userId user_ID -password password -orgId tenant_name -lplatformId L-Platform_ID -lserverId server_ID [-cpuPerf CPU_performance] [-numOfCpu number_of_CPUs] [-cpuReserve CPU_reserve_performance] [-cpuShare CPU_share] [-memorySize memory_size] [-memoryReserve memory_reserve_size] [-memoryShare memory_share] [-serverType server_type] [-priority startup_priority_when_using_batch_power_control]

[Linux Manager]

UpdateLServerConfiguration.sh -version version_ID -locale the_language_for_communicating -userId user_ID -password password -orgId tenant_name -lplatformId L-Platform_ID -lserverId server_ID [-cpuPerf CPU_performance] [-numOfCpu number_of_CPUs] [-cpuReserve CPU_reserve_performance] [-cpuShare CPU_share] [-memorySize memory_size] [-memoryReserve memory_reserve_size] [-memoryShare memory_share] [-serverType server_type] [-priority startup_priority_when_using_batch_power_control]

Function description

This command changes the performance of a virtual server.

This command cannot be executed for a physical server.
Always specify any one of the following:

cpuPerf
numOfCpu
cpuReserve
cpuShare
memorySize
memoryReserve
memoryShare
serverType
priority

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:

The target L-Platform has Solaris Zones servers not managed by BladeLogic.
The target server is an OVM for SPARC server not managed by BladeLogic.

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.

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

-serverType (optional): Specify the server type.

-priority (optional): Specify the startup priority when using batch power control.

Requirements

Permissions: User with OS administrator privilege

Location: Admin server

Example

[Windows Manager]

> UpdateLServerConfiguration -version 2.0 -locale en -userId user3 -password password -orgId tenantA -lplatformId tenantA-M3PGGWCFX -lserverId tenantA-M3PGGWCFX-S-0001 -cpuPerf 1.4 -cpuReserve 1.0 -memorySize 2.0 -memoryReserve 1.0 -priority 128
<?xml version="1.0" encoding="UTF-8"?>
<UpdateLServerConfigurationResponse xmlns="http://cfmg.systemwalker.jp.fujitsu.com">
  <responseMessage>PAPI00000 Processing was completed.</responseMessage>
  <responseStatus>SUCCESS</responseStatus>
</UpdateLServerConfigurationResponse>

[Linux Manager]

# UpdateLServerConfiguration.sh -version 2.0 -locale en -userId user3 -password password -orgId tenantA -lplatformId tenantA-M3PGGWCFX -lserverId tenantA-M3PGGWCFX-S-0001 -cpuPerf 1.4 -cpuReserve 1.0 -memorySize 2.0 -memoryReserve 1.0 -priority 128
<?xml version="1.0" encoding="UTF-8"?>
<UpdateLServerConfigurationResponse xmlns="http://cfmg.systemwalker.jp.fujitsu.com">
  <responseMessage>PAPI00000 Processing was completed.</responseMessage>
  <responseStatus>SUCCESS</responseStatus>
</UpdateLServerConfigurationResponse>

Exit Status

This command returns the following values:

0: The command executed successfully.

non-zero: An error has occurred.