cpsadm - command that is used to perform coordination point server (CP server) administrative and maintenance tasks
cpsadm -s cp server -a action [-p port num] [-c cluster name] [-u uuid] [-e username@domain.com] [-f user role] [-g domain type] [-h hostname] [-n nodeid] [-o victims hostname1[,hostname2,...]] [-v victims nodeid1[,nodeid2,...]]
cpsadm [-help]
VRTScps
The cpsadm command is used to perform CP server administrative and maintenance tasks.
-a This option is used to specify action (one of the following actions: add_clus, rm_clus, add_node, rm_node, add_user, rm_user,add_clus_to_user, rm_clus_from_user, reg_node, unreg_node, preempt_node, list_membership, list_nodes, list_users, list_ports, add_port, rm_port, halt_cps, db_snapshot, ping_cps, server_security) -c This option is used to specify client cluster name -e This option is used to specify user to be added to CP server (username@domain.com) -f This option is used to specify user role (cps_admin or cps_operator) -g This option is used to specify a domain type (nis, nisplus, ldap, or unixpwd) -h This option is used to specify hostname -n This option is used to specify nodeid of client cluster node -o This option is used to specify one or more victim nodes hostname -p This option is used to specify the port number to connect to the CP server -s This option is used to specify the CP server fqdn/vip -u This option is used to specify the UUID of the client cluster -v This option is used to specify one or more victim nodes nodeid
The following are cpsadm command examples using the various options.
Add a client cluster to the CP server configuration. cpsadm -s cp server -a add_clus -c cluster name -u uuid Remove a client cluster from the CP server configuration. cpsadm -s cp server -a rm_clus -u uuid List nodes in the CP server configuration. cpsadm -s cp server -a list_nodes Add a node to a client cluster for the CP server configuration. cpsadm -s cp server -a add_node-u uuid -n nodeid -h hostname Remove a node from a client cluster for the CP server configuration. cpsadm -s cp server -a rm_node -u uuid -n nodeid List users in the CP server configuration. cpsadm -s cp server -a list_users Add a user to the CP server configuration. cpsadm -s cp server -a add_user -e username -f user role -g domain type -u uuid Remove a user from the CP server configuration. cpsadm -s cp server -a rm_user -e user name -g domaintype List all the ports that the CP server is configured to listen on. cpsadm -s cp server -a list_ports Add a new port (IP:port) for the CP server to listen on without restarting the CP server. cpsadm -s cp server -a add_port -i ip_address -r port_number Stop the CP server from listening on a port (IP:port) without restarting the CP server. cpsadm -s cp server -a rm_port -i ip_address -r port_number List the membership of all nodes registered in a given client cluster. cpsadm -s cp server -a list_membership -u uuid Register a node within a client cluster for the CP server configuration. cpsadm -s cp server -a reg_node -u uuid -n nodeid Unregister a node from a client cluster for the CP server configuration. cpsadm -s cp server -a unreg_node -c cluster name -n nodeid Preempt a node within a client cluster. cpsadm -s cp server -a preempt_node -u uuid -n nodeid -v victims nodeid1[,victims nodeid2,...] Enable access for a user to a specific client cluster. cpsadm -s cp server -a add_clus_to_user -c cluster name -e username@domain -g domain type -f user role Disable access for a user to a specific client cluster. cpsadm -s cp server -a rm_clus_from_user -u uuid -e username@domain -g domain type Stop the CP server. cpsadm -s cp server -a halt_cps Ping the CP server. cpsadm -s cp server -a ping_cps Take a snapshot of the CP server database. cpsadm -s cp server -a db_snapshot Know the security settings of the CP server. cpsadm -s cp server -p port number -a server_security
The following are cpsadm command usage examples.
1. Add a client cluster to the CP server configuration. usage: cpsadm -s cp server -a add_clus [-p port num] -c cluster name -u uuid
where:
o -a is used to specify action o -c is used to specify cluster name o -p is to specify the port number o -s is used to specify virtual IP/virtual hostname of the CP server o -u is used to specify UUID 2. Remove a client cluster from the CP server configuration. usage: cpsadm -s cp server -a rm_clus [-p port num] {−c cluster name | −u uuid}
where:
o -a is used to specify action o -p is used to specify the port number o -c is used to specify cluster name o -s is used to specify virtual IP/virtual hostname of the CP server o -u is used to specify UUID 3. List the nodes in a client cluster for the CP server configuration. usage: cpsadm -s cp server -a list_nodes [−c cluster name | −u uuid]
where:
o -a is used to specify action o -s is used to specify virtual IP/virtual hostname of the CP server o -c is used to specify cluster name o -u is used to specify UUID 4. Add a node to a client cluster for the CP server configuration. usage: cpsadm -s cp server -a add_node {−c cluster name | −u uuid} −n nodeid -h hostname
where:
o -a is used to specify action o -c is used to specify cluster name o -h is used to specify fully qualified hostname o -n is used to specify a hosts nodeid o -s is used to specify virtual IP/virtual hostname of the CP server o -u is used to specify UUID 5. Remove a node from a client cluster for the CP server configuration. usage: cpsadm -s cp server -a rm_node {−c cluster name | −u uuid} −n nodeid [−h hostname]
where:
o -a is used to specify action o -c is used to specify cluster name o −h is used to specify fully qualified hostname o -n is used to specify a hosts nodeid o -s is used to specify virtual IP/virtual hostname of the CP server o -u is used to specify UUID 6. Prempt a node within a client cluster. usage: cpsadm -s cp server -a preempt_node {−c cluster name | -u uuid} -n nodeid -v victims nodeid1[,victims nodeid2,...]
where:
o -a is used to specify action o -c is used to specify cluster name o -n is used to specify a hosts nodeid o -s is used to specify virtual IP/virtual hostname of the CP server o -u is used to specify UUID o -v is used to specify victim nodes nodeid 7. Register a node to a client cluster for the CP server configuration. usage: cpsadm -s cp server -a reg_node {−c cluster name | −u uuid} −n nodeid [−h hostname]
where:
o -a is used to specify action o -c is used to specify cluster name o −h is used to specify fully qualified hostname o -n is used to specify a hosts nodeid o -s is used to specify virtual IP/virtual hostname of the CP server o -u is used to specify UUID 8. Unregister a node within a client cluster for the CP server configuration. usage: cpsadm -s cp server -a unreg_node {−c cluster name | −u uuid} −n nodeid [−h hostname]
where:
o -a is used to specify action o -c is used to specify cluster name o −h is used to specify fully qualified hostname o -n is used to specify a hosts nodeid o -s is used to virtual IP/virtual hostname of the CP server o -u is used to specify UUID 9. List membership of all registered nodes in a given client cluster. usage: cpsadm -s cp server -a list_membership {−c cluster name | −u uuid}
where:
o -a is used to specify action o -c is used to specify cluster name o -s is used to virtual IP/virtual hostname of the CP server o -u is used to specify UUID 10. List users in CP server configuration. usage: cpsadm -s cp server -a list_users [−c cluster name | −u uuid]
where:
o -a is used to specify action o -s is used to virtual IP/virtual hostname of the CP server o -c is used to specify cluster name o −u is used to specify UUID 11. Add user to the CP server configuration. Enable access for the user to CP server. usage: cpsadm -s cp server -a add_user [-e username@domain.com] [-g domain type]
where:
o -a is used to specify action o -e is used to specify user to be added to CP server (username@domain.com) o -g is used to specify a domain type (nis, nisplus, ldap, or unixpwd) o -s is used to virtual IP/virtual hostname of the CP server 12. Remove user from the CP server configuration. Disable access for the user to CP server. usage: cpsadm -s cp server -a rm_user -e username@domain.com [-g domain type]
where:
o -a is used to specify action o -e is used to specify user to be added to CP server (username@domain.com) o -g is used to specify a domain type (nis, nisplus, ldap, or unixpwd) o -s is used to virtual IP/virtual hostname of the CP server 13. Add user to the client cluster. Enable access to a client cluster for a user. usage: cpsadm -s cp server -a add_clus_to_user {−c cluster name | −u uuid} -e username@domain.com -g domain type -f user role
where:
o -a is used to specify action o −c is used to specify cluster name o −e is used to specify user to be added to CP server (username@domain.com) o −f is used to specify user role (cps_admin or cps_operator o -g is used to specify a domain type (nis, nisplus, ldap, or unixpwd) o -s is used to virtual IP/virtual hostname of the CP server o - u is used to specify UUID 14. Remove user from the client cluster. Disable access for a user to a specific client cluster. usage: cpsadm -s cp server -a rm_clus_from_user {−c cluster name | −u uuid} -e username@domain.com -g domain type -f user role
where:
o -a is used to specify action o −c is used to specify cluster name o −e is used to specify user to be added to CP server (username@domain.com) o −f is used to specify user role (cps_admin or cps_operator o -g is used to specify a domain type (nis, nisplus, ldap, or unixpwd) o -s is used to virtual IP/virtual hostname of the CP server o -u is used to specify UUID 15. List all the ports that the CP server is configured to listen on. usage: cpsadm -s cp server -a list_ports
where:
o -a is used to specify action o -s is used to virtual IP/virtual hostname of the CP server If the CP server has not been able to successfully listen on a given port at least once, then the Connect History in the output shows never. IP addresses are down when the vxcpserv starts. When the addresses come up later, the vxcpserv binds to them. If the CP server successfully listens on any IP:port at least once, then the Connect History for that IP:port shows once even if the port goes down later during CP servers lifetime. CP server does not actively monitor port health. You can obtain the latest status of the IP address from the corresponding IP resource state that is configured under VCS. 16. Add a new port (IP:port) for the CP server to listen on without restarting the CP server. usage: cpsadm -s cp server -a add_port -i ip_address -r port_number
where:
o -s is used to virtual IP/virtual hostname of the CP server o -a is used to specify action o -i us used to specify the IP address o -r is used to specify the port number Note that adding an IP:port at runtime does not change the vxcps.conf configuration file. So, after restart, CP server listens only on the ports specified in the vxcps.conf file. 17. Stop the CP server from listening on a port (IP:port) without restarting the CP server. usage: cpsadm -s cp server -a rm_port -i ip_address -r port_number
where:
o -a is used to specify action o -s is used to virtual IP/virtual hostname of the CP server o -i us used to specify the IP address o -r is used to specify the port number Note that removing an IP:port at runtime does not change the vxcps.conf configuration file. So, after restart, CP server listens only on the ports specified in the vxcps.conf file. 18. Stop the CP server. usage: cpsadm -s cp server -a halt_cps
where:
o -a is used to specify action o -s is used to virtual IP/virtual hostname of the CP server 19. Ping the CP server. usage: cpsadm -s cp server -a ping_cps
where:
o -a is used to specify action o -s is used to virtual IP/virtual hostname of the CP server 20. Take a CP server database snapshot. usage: cpsadm -s cp server -a db_snapshot
where:
o -a is used to specify action o -s is used to virtual IP/virtual hostname of the CP server
VCS 8.0.0 | CPSADM(1M) |