clreserveip command

Purpose

PowerHA® SystemMirror® cluster can be configured by using virtual machines in IBM® Power® Virtual Server (VS) environment. PowerHA SystemMirror also supports service IP addresses in PowerVS environment. In such cases, you must avoid any duplication of IP addresses with other subnet IP addresses in the PowerVS environment.

The clreserveip utility is used to reserve any IP address in the PowerVS environment before using the IP address as a service in the PowerHA cluster configuration. This reservation prevents any virtual machine in the PowerVS workspace from using the reserved IP as a boot IP address.

Description

Using the clreserveIP utility, a user can reserve or unreserve the service IP address and list the reserved IP address.

Syntax


clreserveip -o add -a service_ip -s network_name -n description_name -f file_path
clreserveip -o list -s network_name -f file_path
clreserveip -o delete -s network_name -p port_id -f file_path

Note: A cloud environment requires an authentication. Use the following format while creating a -f file with APIKEY and CRN attributes.


APIKEY={API_KEY}
CRN={CRN}

Prerequisite

IBM PowerVS environment with its APIKEY and Workspace Cloud Resource Name (CRN) attributes.

Configuration

PowerVS instances with IBM AIX® operating system and PowerHA SystemMirror. Create a file and add the APIKEY and CRN attributes to that file.

Example: Config file


APIKEY=xxxxx 
CRN=xxxxxx

Functions

To reserve the IP address in a network, enter the following command:
```
clreserveip -o add -a service_ip -s network_name -n description_name -f file_path 
```
The add function reserves the IP address and requires -a service pi address, -n network name, and -f configuration file path.

The configuration file path has API_KEY and CRN attributes that are needed to connect the multiple cloud environment. This utility acquires IP address from different regions and cloud environment.
To list all reserved IP address for a sample network, enter the following command:
```
clreserveip -o list -s network_name -f file_path 
```
The list function requires -s network name and -f configuration file path. This command displays a list of reserved IP addresses for a sample network.
```
clreserveip -o list -s {network_name} -f file_path 
```
To unreserve an IP address from the network, enter the following command:
```
clreserveip -o delete -s network_name -p port_id -f file_path 
```
The list function requires -s network name, -p port id, and configuration -f file path. This command deallocates IP address of the network. Each IP address has a unique port ID that you can see in the list function.