Configuring the CP server using the configuration utility


Configuring the CP server using the configuration utility
Prev	Setting up the CP server	Next

The CP server configuration utility (configure_cps.pl) is part of the VRTScps package.

Perform one of the following procedures:

For CP servers on single-node VCS cluster:	See “To configure the CP server on a single-node VCS cluster”.
For CP servers on an SFHA cluster:	See “To configure the CP server on an SFHA cluster”.

To configure the CP server on a single-node VCS cluster

Verify that the VRTScps package is installed on the node.
Run the CP server configuration script on the node where you want to configure the CP server:
```
# /opt/VRTScps/bin/configure_cps.pl
```
Enter 1 at the prompt to configure CP server on a single-node VCS cluster.
The configuration utility then runs the following preconfiguration checks:
- Checks to see if a single-node VCS cluster is running with the supported platform.
  
  The CP server requires VCS to be installed and configured before its configuration.
- Checks to see if the CP server is already configured on the system.
  
  If the CP server is already configured, then the configuration utility informs the user and requests that the user unconfigure the CP server before trying to configure it.
Enter the name of the CP server.
```
Enter the name of the CP Server: mycps1
```

Enter valid virtual IP addresses on which the CP server process should depend on:

Enter the number of virtual IP addresses you want to configure:
```
Enter the number of virtual IP(s) to configure : 2
```

Enter valid virtual IP addresses:

Enter a valid IP address for Virtual IP - 1 which the CP Server
process should depend on : 10.209.83.85
Enter a valid IP address for Virtual IP - 2 which the CP Server
process should depend on : 10.209.83.87

You can also use IPv6 address.

Enter the CP server port number or press Enter to accept the default value (14250).

Enter a port number for virtual IP 10.209.83.85 in range [49152,
65535], or press enter for default port (14250) :

Using default port: 14250

Enter a port number for virtual IP 10.209.83.87 in range
[49152, 65535], or press enter for default port (14250) :

Using default port: 14250

Choose whether the communication between the CP server and the SFCFSHA clusters has to be made secure.

If you have not configured the CP server cluster in secure mode, enter n at the prompt.

Warning:

If the CP server cluster is not configured in secure mode, and if you enter y, then the script immediately exits. You must configure the CP server cluster in secure mode and rerun the CP server configuration script.

Veritas recommends secure communication between the CP server and
application clusters. Enabling security requires Symantec Product
Authentication Service to be installed and configured on the cluster.
   
Do you want to enable Security for the communications? (y/n) 
(Default:y) :

Enter the absolute path of the CP server database or press Enter to accept the default value (/etc/VRTScps/db).

CP Server uses an internal database to store the client information.
    
Note: As the CP Server is being configured on a single node VCS,
the database can reside on local file system.

Enter absolute path of the database (Default:/etc/VRTScps/db):

Verify and confirm the CP server configuration information.

Following is the CP Server configuration information:
-------------------------------------------------
(a)CP Server Name: mycps1
(b)CP Server Virtual IP(s): 10.209.83.85 10.209.83.87
(c)CP Server Port(s): 14250 14250
(d)CP Server Security : 1
(e)CP Server Database Dir: /etc/VRTScps/db
-------------------------------------------------

Press b if you want to change the configuration, <enter> to continue :

The configuration utility proceeds with the configuration process, and creates a vxcps.conf configuration file.

Successfully generated the /etc/vxcps.conf configuration file.
Successfully created directory /etc/VRTScps/db.

Configuring CP Server Service Group (CPSSG) for this cluster
----------------------------------------------

Enter the number of NIC resources that you want to configure. You must use a public NIC.
```
Enter how many NIC resources you want to configure [1 to 2]: 2
```
Answer the following questions for each NIC resource that you want to configure.

Enter a valid network interface for the virtual IP address for the CP server process.

Enter a valid network interface for virtual IP 10.209.83.85 
on mycps1.symantecexample.com: bge0
Enter a valid network interface for virtual IP 10.209.83.87 
on mycps1.symantecexample.com: bge0

Enter the NIC resource you want to associate with the virtual IP addresses.

Enter the NIC resource you want to associate with the 
virtual IP 10.209.83.85 [1 to 2] : 1
Enter the NIC resource you want to associate with the 
virtual IP 10.209.83.87 [1 to 2] : 2

Enter networkhosts information for each NIC resource.

Symantec recommends configuring NetworkHosts attribute to ensure 
NIC resource to be online always.
Do you want to add NetworkHosts attribute for the NIC device 
bge0 on system mycps1? [y/n] : y
Enter a valid IP address to configure NetworkHosts for 
NIC bge0 on system mycps1 : 10.209.83.86
Do you want to add another Network Host ?[y/n] : n

Enter the netmask for each virtual IP address. For example:
```
Enter the netmask for virtual IP 10.209.83.85 :
255.255.252.0
Enter the netmask for virtual IP 10.209.83.87 :
255.255.252.0
```
If you entered an IPv6 address, enter the prefix details at the prompt.

After the configuration process has completed, a success message appears. For example:

Successfully added the Quorum Agent Type to VCS configuration.
Successfully added the CPSSG service group to
VCS configuration. Bringing the CPSSG service
group online. Please wait...

The Veritas Coordination Point Server has been
configured on your system.

Run the hagrp -state command to ensure that the CPSSG service group has been added.
For example:
```
# hagrp -state CPSSG

#Group   Attribute   System                      Value
CPSSG     State      mycps1.symantecexample.com   |ONLINE|
```
It also generates the configuration file for CP server (/etc/vxcps.conf).

The configuration utility adds the vxcpserv process and other resources to the VCS configuration in the CP server service group (CPSSG).

For information about the CPSSG, refer to the Veritas Storage Foundation Cluster File System High Availability Administrator's Guide.

In addition, the main.cf samples contain details about the vxcpserv resource and its dependencies.

To configure the CP server on an SFHA cluster

Verify that the VRTScps package is installed on each node.
Make sure that you have configured passwordless ssh or rsh on the CP server cluster nodes.
Run the CP server configuration script on any node in the cluster:
```
# /opt/VRTScps/bin/configure_cps.pl [-n]
```
The CP server configuration utility uses ssh by default to communicate between systems. Use the -n option for rsh communication.
Enter 2 at the prompt to configure CP server on an SFHA cluster.
The configuration utility then runs the following preconfiguration checks:
- Checks to see if an SFHA cluster is running with the supported platform.
  
  The CP server requires SFHA to be installed and configured before its configuration.
- Checks to see if the CP server is already configured on the system.
  
  If the CP server is already configured, then the configuration utility informs the user and requests that the user unconfigure the CP server before trying to configure it.
Enter the name of the CP server.
```
Enter the name of the CP Server: mycps1
```