Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

TabMove Lite will be made available on the AWS Marketplace in the future.

Note

These current instructions relate to TabMove Lite with a BYOL subscription model. Future versions may be made updated to process the payment directly through AWS Marketplace and include the license in the deliverable.

Deploying TabMove Lite from the AWS Marketplace can be done through the following steps, explained in detail below:

Table of Contents
minLevel1
maxLevel2
include
outlinefalse
indent
styledefault
exclude
typelist
class
printabletrue

1. Review Requirements and Eligibility

Before anything else, it is recommended to review both the requirements and eligibility criteria for the user of TabMove Lite:

2. Purchase TabMove Lite from the AWS Marketplace

  • Ensure you are signed in to AWS in your browser.

  • Find TabMove Lite on the AWS Marketplace.

  • Subscribe to the offering.

  • Once you’re subscribed, continue to the configuration step of the process. Select the following options:

    • Fulfilment option: Container

    • Software version: latest

  • Proceed to the launch step. There are two possible options going forward:

    • 3a: Launch and use TabMove Lite directly with Docker, locally or where you already deploy Docker containers.

    • 3b: Launch and use TabMove Lite on AWS ECS.

3a. Launch and Use TabMove Lite Directly with Docker

Using a container purchased from the AWS Marketplace involves using the AWS CLI to first authenticate to the container registry, and then obtain the image for running it locally.

  1. Ensure you have the AWS CLI installed:
    https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html

  2. Test the authentication of the AWS CLI to your AWS environment in which the container was purchased.

    1. Consult these instructions for the general approach.

    2. Work with your AWS admin(s) in case you need any help determining the correct authentication method, or if you need help setting it up.

  3. Authenticate to the AWS ECR private registry that contains the container that you just purchased.

    1. These are the general instructions on how authentication works:
      https://docs.aws.amazon.com/AmazonECR/latest/userguide/registry_auth.html

    2. Find the Docker command specific to the TabMove Lite Marketplace ECR registry, for pulling the relevant image(s). It will be displayed on the launch page of your product subscription/fulfilment in the AWS Marketplace. It will look like this:

      Code Block
      aws ecr get-login-password \
          --region us-east-1 | docker login \
          --username AWS \
          --password-stdin 709825985650.dkr.ecr.us-east-1.amazonaws.com
          
      CONTAINER_IMAGES="709825985650.dkr.ecr.us-east-1.amazonaws.com/cronos-scale/biztory:tabmove"    
      
      for i in $(echo $CONTAINER_IMAGES | sed "s/,/ /g"); do docker pull $i; done


      Depending on how you configured the AWS CLI during the authentication step, if you’ve used profiles, you may have to specify that profile in the command. That would involve a single change on the second line, like this:

      Code Block
      aws ecr get-login-password \
          --region us-east-1 --profile <your_profile_name> | docker login \
          --username AWS \
          --password-stdin 709825985650.dkr.ecr.us-east-1.amazonaws.com
          
      CONTAINER_IMAGES="709825985650.dkr.ecr.us-east-1.amazonaws.com/cronos-scale/biztory:tabmove"    
      
      for i in $(echo $CONTAINER_IMAGES | sed "s/,/ /g"); do docker pull $i; done

    3. Use that command to pull the container.

    4. Get the Docker compose file that can be used to launch the container with the right configuration and environment variables: https://drive.google.com/file/d/1wlmF4pwC2kNi4WCwpHXtia2eYAtS_b9e/view?usp=sharing

    5. Launch the container with the following command in the directory where docker-compose.yml was saved: docker compose up.

3b. Launch and Use TabMove Lite on AWS ECS

Steps here.