IBM PowerHA SystemMirror for AIX

https://www.ibm.com/docs/en/powerha-aix
Admin
IBM PowerHA SystemMirror for AIX provides high availability clustering and disaster recovery...
Tokens:276,588
Snippets:2,832
Trust Score:10
Update:3 days ago
Show doc for...
Tokens:
Raw
### Example: Bring node2 online

Source: https://www.ibm.com/docs/en/powerha-aix/7.2.x?topic=operations-online-node

An example command to bring the node named node2 online.

```bash
clvt online node node2
```

--------------------------------

### NETWORK_UP_LOCAL Example

Source: https://www.ibm.com/docs/en/powerha-aix/7.2.x?topic=tests-network-up-local-node-network-comments

An example of the NETWORK_UP_LOCAL command syntax, specifying the node, network, and a user-defined comment.

```text
NETWORK_UP_LOCAL, node6, hanet1, Start hanet1 on node 6
```

--------------------------------

### cllssvcpprc command usage examples

Source: https://www.ibm.com/docs/en/powerha-aix/7.2.x?topic=clusters-cllssvcpprc-command

Examples showing how to list all resources, a specific resource, and formatted output.

```bash
[/usr/es/sbin/cluster/svcpprc/cmds]> cllssvcpprc<
HASVC1
```

```bash
[/usr/es/sbin/cluster/svcpprc/cmds]> cllssvcpprc -n HASVC1
svcpprc_consistencygrp PrimaryCluster   AuxiliaryCluster relationships
HASVC1      svc78 svc9A svcrel1
```

```bash
[/usr/es/sbin/cluster/svcpprc/cmds]> cllssvcpprc -n HASVC1 -ca
#NAME:PRIMARY:AUXILIARY:RELATIONSHIPS
HASVC1:svc78:svc9A:svcrel1
```

--------------------------------

### cl_getsite Usage Example

Source: https://www.ibm.com/docs/en/powerha-aix/7.2.x?topic=api-cl-getsite-routine

Example demonstrating how to call cl_getsite and handle the returned status code.

```c
  int clusterid = 1113325332;
  int status;
  int siteid = 1;
  struct cl_site site;
  
  status = cl_getsite(clusterid, siteid, &site);
  if (status == CLE_OK) {
      printf("site %s (%d) has %d nodes and is priority %d\n",
  site.clsite_name,
  site.clsite_id,
  site.clsite_numnodes,
  site.clsite_priority);
  } else {
      cl_perror(status,"can't get site information");
  }
```

--------------------------------

### Application Controller Start Script Option

Source: https://www.ibm.com/docs/en/powerha-aix/7.2.x?topic=program-smit-general-application-smart-assist-modify-stanzas

Configuration for the required application start script path.

```text
sm_cmd_opt:
  id_seq_num = "40"
  id = "clsa_gasa_modify_opts"
  disc_field_name = "start"
  name = "Application Controller Start Script"
  name_msg_file = "cluster.cat"
  name_msg_set = 43
  name_msg_id = 4
  op_type = ""
  entry_type = "t"
  entry_size = 256
  required = "+"
  prefix = "-R"
  cmd_to_list_mode = ""
  cmd_to_list = ""
  cmd_to_list_postfix = ""
  multi_select = ""
  value_index = 0
  disp_values = ""
  values_msg_file = ""
  values_msg_set = 0
  values_msg_id = 0
  aix_values = ""
  help_msg_id = "30,4"
  help_msg_loc = "cluster_hlp.cat"
  help_msg_base = ""
  help_msg_book = ""
```

--------------------------------

### Example: Bind interface to network

Source: https://www.ibm.com/docs/en/powerha-aix/7.2.x?topic=operations-modify-interface

An example showing how to bind the interface named mylabel to the network ether2.

```bash
clvt modify interface mylabel NETWORKNAME=ether2
```

--------------------------------

### cl_getsitemap usage example

Source: https://www.ibm.com/docs/en/powerha-aix/7.2.x?topic=api-cl-getsitemap-routine

Example demonstrating the allocation, retrieval, and iteration of site information within a cluster.

```c
  int clusterid = 1113325332;
  int status;
  int i,j;
  int nbr_sites;
  struct cl_site *sitemap;

  cl_alloc_sitemap(&sitemap);
  nbr_sites = cl_getsitemap(clusterid, sitemap);
  printf("dumping sitemap with %d sites for cluster %d\n\n",
      nbr_sites, sitemap->clsite_clusterid);
  for (i=0; i<nbr_sites; i++)
  {
      printf("info for site %s (%d)\n",
      sitemap[i].clsite_name, sitemap[i].clsite_id);
      printf(" priority = %d \n", sitemap[i].clsite_priority);
      printf(" backup = %d \n", sitemap[i].clsite_backup);
      printf(" state = %d \n", sitemap[i].clsite_state);
      printf(" number of nodes = %d\n", sitemap[i].clsite_numnodes);
      for (j=0; j<sitemap[i].clsite_numnodes; j++)
      {
  printf(" node id = %d\n",
  sitemap[i].clsite_nodeids[j]);
      }
  }
  cl_free_sitemap(sitemap);
```

--------------------------------

### Example clchdev execution

Source: https://www.ibm.com/docs/en/powerha-aix/7.2.x?topic=networks-configuring-application-service-interface

An example of running the clchdev utility for NodeA to reconfigure the IP address.

```bash
clchdev -n NodeA -w net_ip -a '10.10.10.1=192.3.42.1'.
```

--------------------------------

### Example disk migration command

Source: https://www.ibm.com/docs/en/powerha-aix/7.2.x?topic=css-configuring-powerha-systemmirror-node-use-in-band-communication-hyperswap

An example of migrating primary disk hdisk1 to auxiliary disk hdisk2.

```bash
chdev –a san_rep_cfg=migrate_disk –l hdisk1 –U
```

--------------------------------

### cl_isaddravail Usage Example

Source: https://www.ibm.com/docs/en/powerha-aix/7.2.x?topic=api-cl-isaddravail-routine

An example demonstrating how to initialize the required parameters and call cl_isaddravail to check interface availability.

```c
  int clusterid = 1113325332;
  int status;
  char ifaddr[CL_MAXNAMELEN] = "9.57.28.23";
  char nodename[CL_MAXNAMELEN] = "node1";
  struct sockaddr_in addr;
  
  addr.sin_family = AF_INET;
  addr.sin_addr.s_addr = inet_addr (ifaddr);
  status = cl_isaddravail (clusterid, nodename, &addr);
  if (status != CLE_OK) {
      cl_perror(status,"interface not available");
  } else {
      printf ("interface address for %s is available\n",
inet_ntoa (addr.sin_addr.s_addr));
  }
```

--------------------------------

### CL_netif::CL_getifname example: get interface name from cluster ID and node name

Source: https://www.ibm.com/docs/en/powerha-aix/7.2.x?topic=api-cl-netifcl-getifname-routine

Shows how to call CL_getifname with a cluster ID and node name. It sets cli_addr.sin_addr.s_addr to NULL, sets the cluster ID and node name, then calls the routine. If the status is negative, it prints an error message; otherwise it prints the interface name.

```cpp
// CL_netif::CL_getifname get interfacename given clusterid and nodename

  CL_status status;
  char cbuf[CL_ERRMSG_LEN];
  CL_ifname ifname;
  CL_netif netif;

  netif.cli_addr.sin_addr.s_addr = NULL;
  netif.cli_clusterid = 1113325332;
  strcpy (netif.cli_nodename.name, "node1");
  ifname = netif.CL_getifname(status);
  if (status < 0) {
     cl_errmsg(status);
  } else {
     printf("ifname = %s\n", ifname.name);
  }
```

--------------------------------

### Check and start clinfoES

Source: https://www.ibm.com/docs/en/powerha-aix/7.2.x?topic=problems-snmp-based-status-commands-issues

Verify if the clinfoES daemon is running and start it if necessary.

```bash
lssrc -s clinfoES
```

```bash
startsrc -s clinfoES
```

--------------------------------

### Example: Bring node2 offline

Source: https://www.ibm.com/docs/en/powerha-aix/7.2.x?topic=operations-offline-node

An example command to bring node2 offline.

```bash
Clvt offline node node2
```

--------------------------------

### netmon.cf configuration for all adapters and specific overrides

Source: https://www.ibm.com/docs/en/powerha-aix/7.2.x?topic=conditions-virtual-networks-in-powerha-systemmirror

This example shows how to use the !ALL keyword to apply targets to all adapters, while also specifying an additional target for a specific adapter and a health check override.

```text
!REQD !ALL 100.12.7.9
!REQD !ALL 110.12.7.9
!REQD !ALL 111.100.1.10
!REQD en1 9.12.11.10
!REQD 100.12.7.20 host5.ibm 8080 NO_PING
```

--------------------------------

### CL_cluster::CL_getallinfo Usage Example

Source: https://www.ibm.com/docs/en/powerha-aix/7.2.x?topic=api-cl-clustercl-getallinfo-routine

Example demonstrating how to initialize the cluster object, call CL_getallinfo, and iterate through the returned node information.

```cpp
CL_cluster cluster;
CL_status status;
CL_node nodes[8];
CL_node *ret = &nodes[0];
int numnodes;

cluster.clc_clusterid = 1113325332;
numnodes = cluster.CL_getallinfo(ret, status);
if (status < 0) {
  cl_perror(status, progname);
} else {
  printf("number of nodes in cluster: %d\n", numnodes);
  for (int i=0; i<numnodes; i++) {
      printf("[%d] clusterid %d", i, ret[i].cln_clusterid);
      printf(" nodeid %d", ret[i].cln_nodeid);
      printf(" state %d", ret[i].cln_state);
      printf(" interfaces %d\n", ret[i].cln_nif);
  }
}
```

--------------------------------

### Delete network example

Source: https://www.ibm.com/docs/en/powerha-aix/7.2.x?topic=operations-delete-network

An example command to delete a network named ether1 from the cluster.

```bash
clvt delete network ether1
```

--------------------------------

### cl_getsitebypriority usage example

Source: https://www.ibm.com/docs/en/powerha-aix/7.2.x?topic=api-cl-getsitebypriority-routine

An example demonstrating how to call cl_getsitebypriority and check the returned status.

```c
  enum cl_site_priority priority = CL_SITE_PRI_PRIMARY;
  int clusterid = 1113325332;
  int status;
  struct cl_site site;

  status = cl_getsitebypriority(clusterid, priority, &site);
  if (status == CLE_OK)
      printf("site %s (%d) has %d nodes and is priority %d\n",
site.clsite_name,
site.clsite_id,
site.clsite_numnodes,
site.clsite_priority);
```

--------------------------------

### Run the clchipdev utility

Source: https://www.ibm.com/docs/en/powerha-aix/7.2.x?topic=networks-configuring-application-service-interface

Execute the sample utility to configure the application service interface.

```bash
/usr/es/sbin/cluster/samples/appsvclabel/clchipdev
```

--------------------------------

### Examples of query resource_group usage

Source: https://www.ibm.com/docs/en/powerha-aix/7.2.x?topic=class-query-resource-group

Examples showing how to list all resource groups and how to query the detailed attributes of a specific resource group named RG1.

```bash
clvt query resource_group 
  rg1 
  rg2 
  rg3 

clvt query resource_group RG1 
  DISK= "hdisk3" 
  EXPORT_FILESYSTEM="/FSa1" 
  FALLBACK="FBHPN" 
  FALLOVER="FNPN" 
  FILESYSTEM="/FSa1" 
  FORCED_VARYON="false" 
  FSCHECK_TOOL="fsck" 
  FS_BEFORE_IPADDR="true" 
  MOUNT_FILESYSTEM="/mnt1;/FSa1" 
  NAME="RG1" NFS_NETWORK="" 
  NODES="regaa11 regaa12" 
  RECOVERY_METHOD="sequential" 
  SERVICE_LABEL="alias_svc1" 
  SSA_DISK_FENCING="false" 
  STARTUP="OHN" STATE="" 
  VG_AUTO_IMPORT="true" 
  VOLUME_GROUP="vg1"
```

--------------------------------

### Delete application controller example

Source: https://www.ibm.com/docs/en/powerha-aix/7.2.x?topic=use-delete-application

Example command to delete the application controller named MyApp.

```bash
clvt delete application MYApp
```

--------------------------------

### Example syslog configuration entries

Source: https://www.ibm.com/docs/en/powerha-aix/7.2.x?topic=cluster-aix-files-modified-by-powerha-systemmirror

Sample entries for syslog configuration files defining log destinations and rotation policies.

```text
mail.debug           /usr/spool/mqueue/syslog
  *.debug              /dev/console
  *.crit                       *
  *.debug              /tmp/syslog.out     rotate size 100k files 4
  *.crit               /tmp/syslog.out     rotate time 1d
local0.crit /dev/console
local0.info /var/hacmp/adm/cluster.log
user.notice /var/hacmp/adm/cluster.log
daemon.notice /var/hacmp/adm/cluster.log
```

--------------------------------

### Example configuration for agentAddress property

Source: https://www.ibm.com/docs/en/powerha-aix/7.2.x?topic=configuring-restricting-use-ip-address-in-gui

A practical example showing how to map multiple cluster IDs and their respective node labels to specific IP addresses in the configuration-server.json file.

```json
“agentAddress” : {
    “1358561171” {
        “nodeA”: “192.168.10.123”,
        “nodeB”: “192.168.10.127”
    },
    “1351137691” {
        “MyNode”: “192.168.10.214”,
        “YourNode” : “192.168.10.226”
    }
},
```

--------------------------------

### Create the certificates directory

Source: https://www.ibm.com/docs/en/powerha-aix/7.2.x?topic=configuring-enabling-third-party-certificate

Create the directory to store certificate files.

```bash
mkdir /tmp/certificates
```

--------------------------------

### cl_isnodeavail Usage Example

Source: https://www.ibm.com/docs/en/powerha-aix/7.2.x?topic=api-cl-isnodeavail-routine

An example demonstrating how to call cl_isnodeavail and handle the returned status code.

```c
  int clusterid = 1113325332;
  int status;
  char nodename[CL_MAXNAMELEN] = "node1";

  status = cl_isnodeavail (clusterid, nodename);
  if (status != CLE_OK) {
      cl_perror(status,"node is unavailable");
  } else {
      printf ("node %s on cluster %d is available\n",
     nodename, clusterid);
  }
```

--------------------------------

### CL_netif::CL_getifaddr6 Usage Example

Source: https://www.ibm.com/docs/en/powerha-aix/7.2.x?topic=api-cl-netifcl-getifaddr6-routine

Example demonstrating how to initialize the CL_netif object, call CL_getifaddr6, and handle the returned status and address.

```cpp
CL_status status;
CL_ifaddr6 ifaddr; 
CL_netif netif; 
char cbuf[CL_ERRMSG_LEN]; 
char *addr;
netif.cli_clusterid = 1113325332; 
strcpy(netif.cli_name.name, "geotest9"); 
ifaddr = netif.CL_getifaddr6(status); 
if (status < 0)
{
cl_errmsg(status);
}
else
{
printf("ifaddr = %s\n", inet_ntop(AF_INET6, 
&((struct sockaddr_in6 *)&ifaddr->sin6_addr), addr, INET6_ADDRSTRLEN); 
}  
```

--------------------------------

### cl_getifaddr Usage Example

Source: https://www.ibm.com/docs/en/powerha-aix/7.2.x?topic=api-cl-getifaddr-routine

An example demonstrating how to call cl_getifaddr and handle the returned status code.

```c
  int clusterid = 1113325332;
  int status;
  char* interfacename = "geotest9";
  struct sockaddr_in addr;

  status = cl_getifaddr (clusterid, interfacename, &addr);
  if (status != CLE_OK) {
      cl_perror (status, "Can't find interface address");
  } else {
      printf ("interface address w/ name %s is %s\n",interfacename,
      inet_ntoa (addr.sin_addr.s_addr));
  }
```
Tokens:
Raw