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

14.3.23 UpdateLServerAttributes (Updates the Attributes of a Server)

Name

[Windows Manager]
Installation_folder\RCXCFMG\bin\UpdateLServerAttributes - Updates the Attributes of a Server

[Linux Manager]
/opt/FJSVcfmg/bin/UpdateLServerAttributes.sh - Updates the Attributes of a Server

Synopsis

[Windows Manager]

UpdateLServerAttributes -version version_ID -locale the_language_for_communicating -userId user_ID -password password -orgId tenant_name -lplatformId L-Platform_ID -lserverId server_ID [-lserverName server_name] [-hostName the_host_name_of_the_server]

[Linux Manager]

UpdateLServerAttributes.sh -version version_ID -locale the_language_for_communicating -userId user_ID -password password -orgId tenant_name -lplatformId L-Platform_ID -lserverId server_ID [-lserverName server_name] [-hostName the_host_name_of_the_server]

Function description

This command updates the attributes of a server.

The attributes that can be updated are the server name and the host name. Either the server name or the host name must be specified.
When "host-name-method=2(server name)", if only the server name is specified the host name will be changed to the same name as the server name. When the host name is specified, it will be changed to the specified name.

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:

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.

-lserverName (optional)

Specify the server name.

-hostName (optional)

Specify the host name of the server.

Requirements

Permissions

User with OS administrator privilege

Location

Admin server

Example

[Windows Manager]
> UpdateLServerAttributes -version 2.0 -locale en -userId user3 -password password -orgId tenantA -lplatformId tenantA-M3PGGWCFX -lserverId tenantA-M3PGGWCFX-S-0001 -lserverName testserver2
<?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]
# UpdateLServerAttributes.sh -version 2.0 -locale en -userId user3 -password password -orgId tenantA -lplatformId tenantA-M3PGGWCFX -lserverId tenantA-M3PGGWCFX-S-0001 -lserverName testserver2
<?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.