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

14.3.5 CreateNic (Add NIC to Server)

Name

[Windows Manager]
Installation_folder\RCXCFMG\bin\CreateNic - Add NIC to Server

[Linux Manager]
/opt/FJSVcfmg/bin/CreateNic.sh - Add NIC to Server


Synopsis

[Windows Manager]

CreateNic -version version_ID -locale the_language_for_communicating -userId user_ID -password password -orgId tenant_name -lplatformId L-Platform_ID -lserverId server_ID -networkId network_ID [-ipAddress IP_address]

[Linux Manager]

CreateNic.sh -version version_ID -locale the_language_for_communicating -userId user_ID -password password -orgId tenant_name -lplatformId L-Platform_ID -lserverId server_ID -networkId network_ID [-ipAddress IP_address]

Function description

This command adds an NIC to a 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 can only be executed when the server virtualization software on the server is VMware, Hyper-V, RHEL-KVM, or OVM for SPARC.
If the target server has snapshots, NIC addition cannot be done.

When NIC is added, the automatic setting of Internet Protocol address on guest OS is not done.
Log in guest OS after adding NIC, and set IP address displayed in detailed information of L-Server to guest OS manually.
Confirm added NIC can be correctly communicated with the external instrument after IP address is set.
When two or more NIC is added, it is recommended to add it one by one.

If the target server is an OVM for SPARC server, only the management information for this product is added or deleted. The actual NIC of the VM guest is not added or deleted.
Add or delete the actual NICs with the server virtualization software.

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.

-networkId

Specify the network ID connecting the added NIC.

-ipAddress (optional)

Specify the IP address to be allocated to the added NIC.
Specifying an IP address does not automatically set the IP address to a guest OS.

Requirements

Permissions

User with OS administrator privilege

Location

Admin server


Example

[Windows Manager]
> CreateNic -version 2.0 -locale en -userId user3 -password password -orgId tenantA -lplatformId tenantA-M3PGGWCFX -lserverId tenantA-M3PGGWCFX-S-0001 -networkId M3PGGWCFX-N-seg1 -ipAddress 192.xxx.xxx.xxx
<?xml version="1.0" encoding="UTF-8"?>
<CreateNicResponse xmlns="http://cfmg.systemwalker.jp.fujitsu.com">
  <responseMessage>PAPI00000 Processing was completed.</responseMessage>
  <responseStatus>SUCCESS</responseStatus>
</CreateNicResponse>
[Linux Manager]
# CreateNic.sh -version 2.0 -locale en -userId user3 -password password -orgId tenantA -lplatformId tenantA-M3PGGWCFX -lserverId tenantA-M3PGGWCFX-S-0001 -networkId M3PGGWCFX-N-seg1 -ipAddress 192.xxx.xxx.xxx
<?xml version="1.0" encoding="UTF-8"?>
<CreateNicResponse xmlns="http://cfmg.systemwalker.jp.fujitsu.com">
  <responseMessage>PAPI00000 Processing was completed.</responseMessage>
  <responseStatus>SUCCESS</responseStatus>
</CreateNicResponse>

Exit Status

This command returns the following values:

0

The command executed successfully.

non-zero

An error has occurred.