Moka5
Moka5


Configuring Mirrored Primary Image Stores   « Go Back
The Mirrored Primary Image Store is a configuration with two Primary Image Stores in a cluster. This arrangement allows for high availability in a configuration with two active nodes. A Mirrored Primary Image Store configuration is not for everyone, but if you’re running a Moka5 installation behind an external load balancer, this arrangement could work for you. You can also run a Mirrored Primary Image Store with DNS load-balancing, but we recommend an external load balancer.

There are some weaknesses in this configuration:
  • Publishing content to Mirrored Primary Image Stores is slower due to automatic replication.
  • Publishing content to Mirrored Primary Image Stores is successful only after both Primary Image Stores receive all uploaded files.
There are three major benefits of this configuration:
  • You can distribute download load between the two Image Stores.
  • Mirroring minimizes Primary Image Store downtime.
  • The end user is still able to download the installer or LivePC in case one of the Image Stores fails.

Adding Mirrored Primary Image Stores to an Existing Infrastructure

  1. Set up DNS for the Load Balancer and Image Stores. For example:
    Existing Image Store DNS Record
    Instance FQDN IP
    Moka5 Image Store istore.mydomain.com 192.168.0.1

    Updated DNS records for Load Balancer and Mirrored Image Store
    Instance FQDN IP
    Load Balancer istore.mydomain.com 192.168.1.1
    Moka5 Image Store 1 istore1.mydomain.com 192.168.0.1
    Moka5 Image Store 2 istore2.mydomain.com 192.168.0.2
  2. Set up the Load Balancer.
  3. Install the Mirrored Primary Image Store (istore2).
  4. Configure the Moka5 Image Stores:
    1. Change the host name for the existing Primary Image Store to istore1.
    2. Sync the iconfig settings on the Mirrored Primary Image Store (istore2 host).
    3. Restart the Moka5 server.
    4. Identify the other Image Store on both Image Stores:
      1. Open https://localhost/iconfig on both Image Stores.
      2. Navigate to Settings > Advanced.
      3. Click Add Server.
      4. On Moka5 Image Store 1, add host: https://istore2.mydomain.com.
      5. On Moka5 Image Store 2, add host: https://istore1.mydomain.com.
      6. Select Key IDs.
      7. Click Test to test the current configuration.
  5. On both Image Store instances, stop the M5ES service.
  6. Manually copy the m5fs directory's content from the existing Primary Image Store to the Mirrored Primary Image Store.
    Note: Files added prior to configuration of the Mirrored Image Store must be copied manually so that both Primary Image Stores have an identical set of files.
  7. Start the M5ES service.
  8. For monitoring purposes, register https://istore1.mydomain.com and https://istore2.mydomain.com in the Management Server list of infrastructure components. You can do this by using the Desktop Administrator’s login credentials on the Management Server.
  9. Point the Management Server at one of the two Primary Image Stores. This can be done by setting the Management Server’s “hosts” file to point the Primary Image Store’s URL to one Primary Image Store’s IP address.
    Note: In pre-4.0.3 configurations, you must point the Management Server at one Primary Image Store, or replica pushes will fail.

Setting Up Mirrored Primary Image Stores on a Newly Installed Infrastructure

  1. Set up DNS for the Load Balancer and Image Stores. For example:
    Instance FQDN IP
    Load Balancer istore.mydomain.com 192.168.1.1
    Moka5 Image Store 1 istore1.mydomain.com 192.168.0.1
    Moka5 Image Store 2 istore2.mydomain.com 192.168.0.2
  2. Set up the Load Balancer.
  3. Install two Moka5 Image Stores:
    1. Prepare hosts with required DNS settings.
    2. Launch the Moka5 Image Store installers.
    3. On each instance, set the DNS name to: istore.mydomain.com
  4. Configure the Moka5 Image Stores:
    1. Open https://localhost/iconfig on both Image Stores.
    2. The configuration of each Image Store should be identical: certificates, access keys, network, and security settings. You can use iconfig > Sync to synchronize the configurations.
    3. Identify the other Image Store on both Image Stores:
      1. Open https://localhost/iconfig on both Image Stores.
      2. Navigate to Settings > Advanced.
      3. Click Add Server.
      4. On Moka5 Image Store 1, add host: https://istore2.mydomain.com.
      5. On Moka5 Image Store 2, add host: https://istore1.mydomain.com.
      6. Select Key IDs.
      7. Click Test to test the current configuration.
  5. On both Image Store instances, stop the M5ES service.
  6. Add the Image Stores to the Management Server.
    1. Add the https://istore.mydomain.com Image Store. You can do this by using the bootstrap admin's login credentials on the Management Server.
    2. For monitoring purposes, register https://istore1.mydomain.com and https://istore2.mydomain.com in the Management Server list of infrastructure components. You can do this by using the Desktop Administrator’s login credentials on the Management Server.
    3. Point the Management Server at one of the two Primary Image Stores. This can be done by setting the Management Server’s “hosts” file to point the Primary Image Store’s URL to one Primary Image Store’s IP address.
      Note: In pre-4.0.3 configurations, you must point the Management Server at one Primary Image Store, or replica pushes will fail.