Installation on cloud provider
This section applies to installing Dash Enterprise on a single server on a supported cloud provider. For installing the Kubernetes version of the software, see Dash Enterprise Kubernetes installation using cloud provider's Kubernetes cluster.
Currently we support a simplified installation on Amazon Web Services using an EC2 virtual server and a custom AMI (similar support for other cloud providers is in development). To install on a different cloud provider, simply provision a compute instance that meets our requirements, then follow the instructions in Dash Enterprise Single Server: On-Premise Installation on Own Server.
With the current release, your cloud instance must be able to access the Internet, either directly or via a proxy, to use our automated installation process. If your instance does not have Internet access, skip ahead to Dash Enterprise Single Server: fully offline installation.
Dash Enterprise can be installed by launching an Amazon Machine Image as follows:
1 - Log into your AWS console and visit the EC2 Management Console in the region of your choice; in this example, we have chosen the ca-central-1 region:
2 - Click Launch Instance
3 - At Step 1: Choose an Amazon Machine Image (AMI), select Community AMIs (circle 1) from the menu on the left, then enter plotly in the search box (circle 2):
4 - Ensure the ID of the AMI (circle 3) matches the ID in the below table for the region you’re using:
5 - After verifying the AMI ID, click Select to choose the AMI
6 - In Step 2: Choose an Instance Type, select an appropriate instance type and click Next: Configure Instance Details
- t2.2xlarge is a good option, but you can choose a larger instance type if you want higher performance
7 - On Step 3: Configure Instance Details, set Auto-assign public IP to Disable, then click Next: Add Storage
8 - On Step 4: Add Storage, set the Size (GiB) of the root volume, then click Next: Add Tags
- We recommend 2000 GiB
- This number may be increased or decreased depending on the size of the active team, but should never be less than 200 GiB
- We currently do not support splitting your server’s directory structure across multiple block devices; please add only one storage volume of the required size
9 - On Step 5: Add Tags, you may optionally add a Name tag of plotly-on-premise and any other tags you require for your organization purposes
- When done, click Next: Configure Security Group
10 - On Step 6: Configure Security Group, select Create a new security group, give it a descriptive name such as plotly-on-premise, and configure entries as below:
- The Custom TCP 3022 rule is only needed for Dash Enterprise; all others are required
- To restrict access to Dash Enterprise to a single IP address (or range of IPs) replace the default Source values (0.0.0.0/0, ::/0) with the address or range
- Once you have configured the security group, click Review and Launch
11 - On Step 7: Review Instance Launch, carefully review the information and especially confirm that the security groups match the ones shown below:
- If any information is incorrect, use the Edit links to go back and correct it.
12 - After verifying, click Launch and choose a key pair you have access to, or create a new key pair and download it * This step is extremely important! Without this key pair, you will not be able to SSH into your server and the key pair is very difficult to reset.
13 - On the Launch Status screen, click View Instances at the bottom right
To ensure your instance’s IP address does not change when the instance is rebooted or undergoes other maintenance, associate an Elastic IP address with the instance as follows:
1 - In your AWS console, select Elastic IPs from the menu on the left
2 - Select Allocate new address, leave the Scope set to VPC, then choose Allocate
3 - On the New address request succeeded screen, note the new address (in this case 18.104.22.168) and then click the address
4 - In the Elastic IPs screen, ensure your new IP address is selected, then click Actions > Associate address
5 - Click Select an instance and choose your new instance from the list
6 - Click the Associate button at the bottom right, then Close
To administer your instance via SSH, you may log in using the
plotlyusername and the SSH key you selected or uploaded when launching your new instance.
If your system requires a proxy to access the Internet,configure as follows:
2 - Run the Plotly installation script:
curl -sSL https://get.plot.ly | sudo bash
3 - When asked if your machine requires a proxy to access the internet, enter y and provide your proxy details when prompted