Creating a Rapid Home Provisioning Client

Users operate on a Rapid Home Provisioning Client to perform tasks such as requesting deployment of Oracle homes and querying gold images.

To create a Rapid Home Provisioning Client:

If there is no highly available VIP (HAVIP) on the Rapid Home Provisioning Server, then, as the root user, create an HAVIP, as follows:
```
# srvctl add havip -id id -address {host_name | ip_address}
```
You can specify either a host name or IPv4 or IPv6 IP address. The IP address that you specify for HAVIP or the address that is resolved from the specified host name must not be in use when you run this command.
Note:

The highly available VIP must be in the same subnet as the default network configured in the Rapid Home Provisioning Server cluster. You can obtain the subnet by running the following command:
```
srvctl config network -netnum network_number
```
See Also:

Oracle Real Application Clusters Administration and Deployment Guide for more information about these SRVCTL commands
On the Rapid Home Provisioning Server as the Grid home owner, create the client data file, as follows:
```
$ rhpctl add client -client client_cluster_name -toclientdata path
```
RHPCTL creates the client data file in the directory path you specify after the -toclientdata flag. The name of the client data file is client_cluster_name.xml.

Note:

The client_cluster_name must be unique and it must match the cluster name of the client cluster where you run step 4.

See Also:

Rapid Home Provisioning and Server Control Command Reference for more information about the rhpctl add client command
Copy the client data file that you created in the previous step to a directory on the client cluster that has read/write permissions to the Grid home owner on the Rapid Home Provisioning Client.
Create the Rapid Home Provisioning Client by running the following command as root on the client cluster:
```
# srvctl add rhpclient -clientdata path_to_client_data
   [-diskgroup disk_group_name -storage base_path]
```
If you want to provision working copies to Oracle ACFS storage on this cluster, and you have already created a disk group for this purpose, then specify this disk group in the preceding command. In this case, also specify a storage path which will be used as a base path for all mount points when creating Oracle ACFS file systems for storing working copies.

Note:

Once you configure a disk group on a Rapid Home Provisioning Client, you cannot remove it from or change it in the Rapid Home Provisioning Client configuration. The only way you can do either (change or remove) is to completely remove the Rapid Home Provisioning Client using the srvctl remove client command, and then add it back with a different disk group, if necessary. Before you remove a Rapid Home Provisioning Client, ensure that you remove all registered users from this cluster and all working copies provisioned on this cluster.
Start the Rapid Home Provisioning Client, as follows:
```
$ srvctl start rhpclient
```
Check the status of the Rapid Home Provisioning Client, as follows:
```
$ srvctl status rhpclient
```