Install Datalore Enterprise on AWS
The instruction below explains how to install Datalore on-premises in your AWS infrastructure.
To install Datalore on-premises in AWS, you need the following tools installed on your machine:
You also need to download this repository to your computer and configure AWS CLI.
Deploy your AWS infrastructure
Go to the aws/terraform directory in the downloaded repository.
Change the parameters in the terraform.tfvars file if needed. It is important to use the name of your AWS key pair in ssh_keypair.
terraform applyto get the following important information:
datalore_ip is the ip address of the machine where Datalore will be installed. This IP will be used for accessing Datalore.
init_script is the script which you will need to execute on the machine which the terraform script made for you.
SSH to the machine with the IP (datalore_ip) from the previous step. Use ubuntu as a user and the private key from your AWS key pair that you specified in ssh_keypair.ssh -i <path_to_my_key> ubuntu@<datalore_ip>
Log into the Hub respository:sudo docker login -u datalorecustomer
Download the datalore.sh script:wget https://raw.githubusercontent.com/JetBrains/datalore-configs/main/aws/datalore.sh chmod +x datalore.sh
- Execute the
init_scriptcommand from Step 2.4 (eg ./datalore.sh <a_lot_of_params> ).
Execute the following command to start Datalore:./datalore.sh start-datalore
Now you have access to Datalore at http://<datalore_ip>:8080 and Hub at http://datalore_ip>:8082. Your admin account in Hub is admin/changeme.
(Optional) Set up a hostname
If you don't want to access Datalore via ip and want to assign a human readable DNS name for it and add a load balancer with https, update the configuration using the steps belows.
Go to http://<datalore_ip>:8082/hub/services (as admin user) and replace the ip addresses in Home URL, Base URLs, and Redirect URIs with a DNS name for both Datalore and Hub services.
- Go to the /home/ubuntu/datalore/datalore.env file and change the values of HUB_PUBLIC_BASE_URL and FRONTEND_URL.
Use the following commands:
To stop Datalore and Hub:
To start Datalore and Hub:
To check Datalore logs:
sudo docker logs datalore
To check Hub logs:
sudo docker logs hub
Admin user and licenses
Set up an admin user
To use the admin panel feature, you need a user with admin rights. Use the admin API token to create the first admin user.
Start Datalore using the following command:./datalore.sh --admin-token <ADMIN_API_TOKEN> start
Send a POST request to http://<datalore_ip>:8080/api/admin/user/role?email=<EMAIL_OF_ADMIN_USER>&role=<NEW_USER_ROLE> with the header
Authorization: <ADMIN_API_TOKEN>to change the user role.
- Choose of the following user roles:
REGULAR: regular user. Can be used to demote the user from the admin role.
ADMIN: admin user with access to the admin panel.
SUPER_ADMIN: admin user who can also change other users' roles via the admin panel.
Add a license
To use Datalore, you need to activate your license (provided in license.key ). Only with an activated license, you can start computations and create more than one user. Add a license for your Datalore installation in one of the following ways:
- (Recommended) Use the admin panel:
license.keyin the Add new license field.
Once submitted and verified, the license will be immediately activated (no restart needed). Licenses are persisted in the database, so they will work even after restart.
- Use the admin REST API as an alternative to the admin panel:
Send a POST request to http://<datalore_ip>:8080/api/admin/license with the header
Authorization: <ADMIN_API_TOKEN>(token from this procedure ).
license.keyin the request body.
- Add a license to your Datalore installation as a file. To do so, define the
LICENSE_PATHSenvironment variable with the comma-separated path to the respective file inside the Datalore container.