14.3.22 UpdateIPAddress (Updates a Server IP Address)

Name

[Windows Manager]
Installation_folder\RCXCFMG\bin\UpdateIPAddress - Updates a Server IP Address

[Linux Manager]
/opt/FJSVcfmg/bin/UpdateIPAddress.sh - Updates a Server IP Address

Synopsis

[Windows Manager]

UpdateIPAddress -version version_ID -locale the_language_for_communicating -userId user_ID -password password -orgId tenant_name -lplatformId L-Platform_ID -lserverId server_ID -nicNo NIC_serial_number -ipAddress IP_address_after_update

[Linux Manager]

UpdateIPAddress.sh -version version_ID -locale the_language_for_communicating  -userId user_ID -password password -orgId tenant_name -lplatformId L-Platform_ID -lserverId server_ID  -nicNo NIC_serial_number -ipAddress IP_address_after_update

Function description

This command updates the IP address allocated to the server.

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.
The target server is a physical server.
The target NIC is the distribution target of an SLB.

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.

-lserverId: Specify the server ID.

-nicNo: Specify the NIC sequential number (an integer equal to or greater than "1") to update the IP address of.

-ipAddresse: Specify the IP address after update.

Requirements

Permissions: User with OS administrator privilege

Location: Admin server

Example

[Windows Manager]

> UpdateIPAddress -version 2.0 -locale en -userId user3 -password password -orgId tenantA -lplatformId tenantA-M3PGGWCFX -lserverId tenantA-M3PGGWCFX-S-0001 -nicNo 2 -ipAddress 192.168.10.10
<?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]

# UpdateIPAddress.sh -version 2.0 -locale en -userId user3 -password password -orgId tenantA -lplatformId tenantA-M3PGGWCFX -lserverId tenantA-M3PGGWCFX-S-0001 -nicNo 2 -ipAddress 192.168.10.10
<?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.