Skip to main content

Installing Service Workbench using EC2 instance

  1. Download the Service Workbench on AWS source code using this link and then run the following commands:
sudo yum install -y git
git clone https://github.com/awslabs/service-workbench-on-aws-cn.git

  1. Create a main Service Workbench on AWS configuration file for your installation. To do this:

    a. Create an environment variable holding the stage name of your installation. The stage name is included in the name of the Amazon S3 storage bucket. Hence, it must be S3-compatible.

    Example: export STAGE_NAME=dev

    Note: Set the environment variable when you open a new terminal window.

    b. In the main configuration directory (main/config/settings), make a copy of the example configuration file using the suggested stage name demo. This creates the dev.yml file.

    cp example.yml ${STAGE_NAME}.yml

    c. In the newly created configuration file, uncomment and set values for the following values:

    • awsRegion (for example: us-east-1 or eu-west-2): Ensure that you use the same Region when you are using the AWS Management Console.
    • solutionName (for example: sw): The solutionName is used in S3 bucket names so must be S3-compatible.
      Note: Ensure that there is no leading space before the value name.

  2. Run the main installation script. This takes around 20 minutes. ./scripts/environment-deploy.sh ${STAGE_NAME}

  3. Once the preceding step has completed, capture the root password and website URL. You can display the URL and root password again by running the following command: scripts/get-info.sh ${STAGE_NAME}

  4. Verify that Service Workbench is running by using the URL and root password, using the user root@example.com.