Moka5
Moka5


Setup a MokaFive Replica Image Store with the Amazon S3 Storage Service   « Go Back

Table of Contents
- Summary
- Pre-Requisites
- Steps



Summary
This article describes how to setup and manage a MokaFive Replica Image Store with the Amazon S3 storage service.


Pre-Requisites

  • MokaFive 3.18 or above. This process is supported on older versions of MokaFive, but is most efficient on MokaFive 3.18 and above.
  • Amazon S3 account with an Access Key ID and Secret Access Key
  • Desktop Administrator and bootstrap Admin access to the MokaFive Management Server


Steps

Go through the following sections to configure your Amazon S3 account with MokaFive.

1. Set-up Amazon S3 Account
2. Configure Replica Image Store
3. Push Client Pack and LivePC Image to Amazon S3 Replica Image Store
4. Assign Players to the Amazon S3 Replica Image Store
5. Client Pack and LivePC Images Updates after Initial Set-up

Setup Amazon S3 Account

  1. Sign up for an Amazon S3 account if you do not already have one at http://aws.amazon.com/s3/
  2. After you sign up for an account, you will get an Access Key ID and Secret Access Key. It is IMPORTANT that you keep this information in a secure place. We will need this information to configure the MokaFive Replica Image Store with Amazon S3.
  3. Create a Bucket in Amazon S3 to use with the MokaFive Replica Image Store. "Buckets" are Amazon's term for directories in S3.
    • When creating a Bucket, you can select the region for optimal performance based on the client access requirements for your MokaFive Replica Image Store.

Configure Replica Image Store

Before configuring the MokaFive Replica Image Store, you will need to have the Amazon S3 setup information available (Bucket Name, Access Key ID, and Secret Access Key). Use the following instructions configure MokaFive to use Amazon S3 as a Replica Image Store.

  1. Login to your MokaFive Management Server using the bootstrap Admin account.
  2. Go to Settings -> Infrastructure.
  3. Click on Add.
  4. Enter the following information in the Add Image Store window.
  5. Click on Test to confirm the connection.

Push Client Pack and LivePC Image to Amazon S3 Replica Image Store

Before MokaFive Players can download from the Amazon S3 Replica Image Store, the client pack and LivePC bits need to be pushed out to the replica image store. Use the following instructions to perform this task.

Push the Client Pack

  1. Login to your MokaFive Management Server using an account with the Desktop Administrator role.
  2. Go to Settings -> Client Installers
  3. Under Action on the Client Pack that you want to make available on the Amazon S3 Replica Image Store, click on Push to Replicas. This will open a "Push installers" window.
  4. Select the Amazon S3 Replica Image Store that was created earlier.
  5. Click on Push.
  6. Monitor the status for completion of the push.
  7. You can close the status window and return back to it later by clicking on Push to Replicas.

Push the MokaFive LivePC Image

  1. Login to your MokaFive Management Server using an account with the Desktop Administrator role.
  2. Click on LivePC Images
  3. Click on the LivePC image version that you want to push to the Amazon S3 Replica Image Store.
  4. Under Action, select Push to Replicas on the LivePC version that you want to push. This will open a "Push <LivePC Image Name>" window.
  5. Select the Amazon S3 Replica Image Store that was created earlier.
  6. Click on Push.
  7. Monitor the status for completion of the push.
  8. You can close the status window and return back to it later by clicking on Push to Replicas.

Assign Players to the Amazon S3 Replica Image Store

Players need to be assigned to the Amazon S3 Replica Image Store before they can access the files in the store.

There are two types of image store assignments: default image stores and IP range-based image stores. MokaFive will first check for IP range-based image stores. If none are assigned through IP ranges, then the default image store will be used.

Before configuring the image store assignments, consider your use case with using the Amazon S3 Replica Image Store and determine which setup meets your requirements.

Configure Default Image Stores

Default image stores are applied to specific groups. To configure a group of users (e.g. remote salespeople) to access a specific image store, use the following process to set the group to use the Amazon S3 Replica Image Store. Players with this assignment will always go to the Amazon S3 Replica Image Store to download Client Packs and LivePC images.

  1. Login to your MokaFive Management Server using an account with the Desktop Administrator role.
  2. Go to Policies -> Player Policies -> Custom tab.
  3. Select the Group of users to target with the Replica Image Store.
  4. Modify the "Image store to use" policy to point to the Amazon S3 Replica Image Store that was configured earlier.
  5. Click on Save Changes.

Configure IP range-based Image Stores (Optional)

IP range assignments are effective across ALL groups. IP range assignments are useful for assigning Players to go to specific image stores based on where the user may be (Office A, Office B, home, etc.).

IP range assignments are optional. If no IP range-based image stores are configured, MokaFive will use the user's default image store configured in the Player policy.

  1. Login to your MokaFive Management Server using an account with the Desktop Administrator role.
  2. Go to Settings -> Infrastructure -> IP Ranges tab (Image Store IP Range Assignments)
  3. Click on Add. This will open the Add IP Range window.
  4. Enter an IP address of the subnet you wish to specify (please note that CIDR-based addressing is not currently supported).
  5. Enter a subnet mask to define the range.
  6. Select the Amazon S3 Replica Image Store that was configured earlier.
  7. Click on Save to save the settings.

Client Pack and LivePC Images Updates after Initial Setup

After the initial configuration, you will need to use the following instructions for publishing updated Client Packs and LivePC images on the Amazon S3 Replica Image Store.

Important!
You must PUSH out a new Client Pack or a new LivePC Image version to the Amazon S3 Replica Image Store BEFORE the update is targeted to a MokaFive Player. Otherwise, the Player will not find the expected files on the replica image store and will display a download error.

  1. Follow the normal process of uploading a new Client Pack or creating a new LivePC Image version through Creator.
    • Note: If any Customizations updates such as branding, label changes, etc. are made on the Management Server at Settings -> Customizations, an existing Client Pack needs to be re-pushed to the replica image store for the new customizations to take effect.
  2. Follow the instructions in the previous section, Push Client Pack and LivePC Image to Amazon S3 Replica Image Store, to push out a new Client Pack or LivePC Image version.
  3. After the push has completed successfully, follow the normal upgrade process for targeting the new Client Pack or LivePC to the Players that are assigned to the Amazon S3 Replica Image store. For full general instructions on deploying updated Client Packs and LivePCs, refer to the MokaFive Administrator's Guide.