3.2.2.1. Install: Multisite/Multimaster Clusters using Staging Configuration

Warning

The procedures in this section are designed for the pre-v6.x Multisite/Multimaster topology ONLY. Do NOT use these procedures with version 6.x Multisite Clusters.

For version 6.x Multisite Clustering, please refer to Deploying Composite Multimaster Clustering.

Creating the configuration requires two distinct steps, the first to create the two Continuent Tungsten deployments, and a second that creates the Tungsten Replicator configurations on different network ports, and different install directories.

  1. Install the Continuent Tungsten package or download the Continuent Tungsten tarball, and unpack it:

    shell> cd /opt/continuent/software
    shell> tar zxf continuent-tungsten-2.0.5-11.tar.gz
  2. Change to the Continuent Tungsten directory:

    shell> cd continuent-tungsten2.0.5-11
  3. Run tpm to configure the installation. This method assumes you are using the Section 9.3, “tpm Staging Configuration” method:

    shell> ./tools/tpm configure defaults \
    --user=tungsten \
    --install-directory=/opt/continuent \
    --replication-user=tungsten \
    --replication-password=password \
    --replication-port=13306 \
    --application-user=app_user \
    --application-password=secret \
    --application-port=3306 \
    --start-and-report \
    --profile-script=~/.bash_profile
    
    shell> ./tools/tpm configure east \
    --topology=clustered \
    --members=east1,east2,east3 \
    --connectors=east1,east2,east3 \
    --master=east1
    
    shell> ./tools/tpm configure west \
    --topology=clustered \
    --members=west1,west2,west3 \
    --connectors=west1,west2,west3 \
    --master=west1

    The description of each of the options is shown below; click the icon to hide this detail:

    Click the icon to show a detailed description of each argument.

    Note

    Do not include --start-and-report if you are taking over for MySQL native replication. See Section 3.8.1, “Migrating from MySQL Native Replication 'In-Place'” for next steps after completing installation.

  4. Run tpm to install the software with the configuration.

    shell > ./tools/tpm install

    During the startup and installation, tpm will notify you of any problems that need to be fixed before the service can be correctly installed and started. If the service starts correctly, you should see the configuration and current status of the service.

  5. Install the Tungsten Replicator package or download the Tungsten Replicator tarball, and unpack it:

    shell> cd /opt/continuent/software
    shell> tar zxf tungsten-replicator-3.0.0-524.tar.gz
  6. Change to the Tungsten Replicator directory:

    shell> cd tungsten-replicator-3.0.0-524
  7. Run tpm to configure the installation. This method assumes you are using the Section 9.3, “tpm Staging Configuration” method:

    shell> ./tools/tpm configure defaults \
    --user=tungsten \
    --install-directory=/opt/continuent \
    --replication-user=tungsten \
    --replication-password=password \
    --replication-port=13306 \
    --application-user=app_user \
    --application-password=secret \
    --application-port=3306 \
    --start-and-report \
    --profile-script=~/.bash_profile
    
    shell> ./tools/tpm configure defaults \
    --install-directory=/opt/replicator \
    --rmi-port=10002 \
    --executable-prefix=mm \
    --thl-port=2113
    
    shell> ./tools/tpm configure east \
    --topology=clustered \
    --members=east1,east2,east3 \
    --connectors=east1,east2,east3 \
    --master=east1
    
    shell> ./tools/tpm configure west \
    --topology=clustered \
    --members=west1,west2,west3 \
    --connectors=west1,west2,west3 \
    --master=west1
    
    shell> ./tools/tpm configure east_west \
    --topology=cluster-slave \
    --master-dataservice=east \
    --slave-dataservice=west
    
    shell> ./tools/tpm configure west_east \
    --topology=cluster-slave \
    --master-dataservice=west \
    --slave-dataservice=east

    The description of each of the options is shown below; click the icon to hide this detail:

    Click the icon to show a detailed description of each argument.

    Note

    Do not include --start-and-report if you are taking over for MySQL native replication. See Section 3.8.1, “Migrating from MySQL Native Replication 'In-Place'” for next steps after completing installation.

  8. Run tpm to install the software with the configuration.

    shell > ./tools/tpm install

    During the startup and installation, tpm will notify you of any problems that need to be fixed before the service can be correctly installed and started. If the service starts correctly, you should see the configuration and current status of the service.

  9. Initialize your PATH and environment.

    shell> source /opt/continuent/share/env.sh
    shell> source /opt/replicator/share/env.sh