Go to main content

Oracle® Solaris Cluster 4.3 Geographic Edition Installation and Configuration Guide

Exit Print View

Updated: February 2017
 
 

How to Create a Site


Note -  You can also use the Oracle Solaris Cluster Manager browser interface to perform this task. Click Sites, then click Create. For Oracle Solaris Cluster Manager log-in instructions, see How to Access Oracle Solaris Cluster Manager in Oracle Solaris Cluster 4.3 System Administration Guide.

Before You Begin

  • Determine which clusters the site will contain and whether each cluster will be a site controller or a site member. The cluster from which you create the new site is automatically configured as a site controller. To avoid a possible single point of failure, configure at least two clusters as site controllers.

  • If you use a role with Geo Management RBAC rights, ensure that the /var/cluster/geo ACLs are correct on each node of both partner clusters. If necessary, assume the root role on the cluster node and set the correct ACLs.

    # chmod A+user:username:rwx:allow /var/cluster/geo

    The /var/cluster/geo directory must have the correct access control lists (ACL) applied for compatibility between the Geo Management RBAC rights profile and data replication software.

    For more information about RBAC, see Securing Geographic Edition Software.

  1. From a node of a cluster that you want to be a controller of the new site, assume the root role or assume a role that is assigned the Geo Management RBAC rights profile.
  2. Ensure that all nodes in the cluster are online.
    phys-schost-1# cluster status -t node
    === Cluster Nodes ===
    
    --- Node Status ---
    
    Node Name                                       Status
    ---------                                       ------
    phys-schost-2                                   Online
    phys-schost-1 Online

    If any node is offline, wait until the node is back online before you create the new site. The creation of a new site, or the acceptance by invited members to join the site, will fail if any node in the issuing cluster is not online.

  3. Configure the new site.

    The issuing cluster is automatically configured as a site controller, so you do not have to specify that cluster name to the geosite create command. You can specify the –c option and the –m option in the same geosite create command.

    first-site-controller-cluster-node# geosite create [-c cluster[,…]] [-m cluster[,…]] site
    -c cluster

    The name of a cluster to configure as a site controller. You can specify multiple cluster names separated by commas (,).

    -m cluster

    The name of a cluster to configure as a site member. You can specify multiple cluster names separated by commas (,).

    site

    The name for the site that you are creating.

    The command issues an invitation to each cluster that is specified to the geosite create command. No site-based operations are accepted from a cluster until the cluster accepts the invitation to join the site.

  4. For each cluster that was invited, accept the invitation to join the new site.
    1. Ensure that the common agent container is enabled on all nodes of this cluster and all nodes of the cluster that this cluster is joining.
      # /usr/lib/cacao/bin/cacaoadm status
    2. If the common agent container is not running on any of the cluster nodes, start it.
      # /usr/lib/cacao/bin/cacaoadm start
    3. From one node, join the site.
      invited-cluster-node# geosite join first-site-controller-cluster site
      first-site-controller-cluster

      The name of the cluster that issued the invitation to join the site.

  5. Verify the site configuration.
    # geosite status site
Example 9  Creating a New Site

The following example creates a new site named europe. The issuing cluster, london, is automatically configured as a site controller. The cluster madrid is configured as a second site controller, and the clusters berlin and paris are configured as site members. The invited clusters accept the invitation from the london cluster to join the europe site.

phys-london-1# geosite create -c madrid -m berlin,paris europe

phys-madrid-1# geosite join london europe
phys-berlin-1# geosite join london europe
phys-paris-1# geosite join london europe

Next Steps

Go to How to Create a Multigroup.

See Also

To find out how to delete a site, see Deleting a Site in Oracle Solaris Cluster 4.3 Geographic Edition System Administration Guide.