3.2.2.2. Install: Multisite/Multimaster Clusters using INI 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 full topology requires two distinct install steps, the first creates the Continuent Tungsten cluster dataservices, and a second that creates the Tungsten Replicator services on different network ports and install directories.

  1. Create the combined configuration file /etc/tungsten/tungsten.ini on all cluster hosts:

    
    [defaults]
    user=tungsten
    install-directory=/opt/continuent
    replication-user=tungsten
    replication-password=secret
    replication-port=3306
    profile-script=~/.bashrc
    start-and-report=true
    application-user=app_user
    application-password=secret
    skip-validation-check=MySQLPermissionsCheck
    start-and-report=true
    
    [defaults.replicator]
    home-directory=/opt/replicator
    rmi-port=10002
    executable-prefix=mm
    
    [east]
    topology=clustered
    connectors=east1,east2,east3
    master=east1
    members=east1,east2,east3
    
    [west]
    topology=clustered
    connectors=west1,west2,west3
    master=west1
    members=west1,west2,west3
    
    [east_west]
    topology=cluster-slave
    master-dataservice=east
    slave-dataservice=west
    thl-port=2113
    
    [west_east]
    topology=cluster-slave
    master-dataservice=west
    slave-dataservice=east
    thl-port=2115
    

    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=true 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.

  2. Create the two clusters:

    1. Install the Continuent Tungsten package (.rpm), or download the compressed 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 staging directory:

      shell> cd continuent-tungsten2.0.5-11
    3. Run tpm to install the Clustering software with the INI-based configuration:

      shell > ./tools/tpm install

      During the installation and startup, 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.

  3. Install the cluster-to-cluster bi-directional replication:

    1. 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
    2. Change to the Tungsten Replicator staging directory:

      shell> cd tungsten-replicator-3.0.0-524
    3. Run tpm to install the Tungsten Replicator software with the INI-based configuration:

      shell > ./tools/tpm install

      During the installation and startup, 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.

  4. Initialize your PATH and environment:

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

The MSMM clustering should be installed and ready to use.