14.3.8 DestroyNic (Delete Specified NIC from Server)

Name

[Windows Manager]
Installation_folder\RCXCFMG\bin\DestroyNic - Delete Specified NIC from Server

[Linux Manager]
/opt/FJSVcfmg/bin/DestroyNic.sh - Delete Specified NIC from Server

Synopsis

[Windows Manager]

DestroyNic -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_number [-force forced_deletion]

[Linux Manager]

DestroyNic.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_number [-force forced_deletion]

Function description

This commandI deletes a specified NIC from 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 deletion cannot be done.

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.

Note

If a NIC being deleted has been configured on the guest OS, the deletion on the L-Platform tab does not delete the configuration from the guest OS.
Delete the configuration of the NIC from the guest OS beforehand.

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

-force: Specify whether NICs that are distribution targets for the server load balancer will be forcibly deleted.

Requirements

Permissions: User with OS administrator privilege

Location: Admin server

Example

[Windows Manager]

> DestroyNic -version 2.0 -locale en -userId user3 -password password -orgId tenantA -lplatformId tenantA-M3PGGWCFX -lserverId tenantA-M3PGGWCFX-S-0001 -nicNo 2
<?xml version="1.0" encoding="UTF-8"?>
<DestroyNicResponse xmlns="http://cfmg.systemwalker.jp.fujitsu.com">
  <responseMessage>PAPI00000 Processing was completed.</responseMessage>
  <responseStatus>SUCCESS</responseStatus>
</DestroyNicResponse>

[Linux Manager]

# DestroyNic.sh -version 2.0 -locale en -userId user3 -password password -orgId tenantA -lplatformId tenantA-M3PGGWCFX -lserverId tenantA-M3PGGWCFX-S-0001 -nicNo 2
<?xml version="1.0" encoding="UTF-8"?>
<DestroyNicResponse xmlns="http://cfmg.systemwalker.jp.fujitsu.com">
  <responseMessage>PAPI00000 Processing was completed.</responseMessage>
  <responseStatus>SUCCESS</responseStatus>
</DestroyNicResponse>

Exit Status

This command returns the following values:

0: The command executed successfully.

non-zero: An error has occurred.