Launching Graphistry in AWS Marketplace: Tutorial

Posted by Graphistry Staff on April 29, 2019

Last Updated: 1/13/2020

For Azure Marketplace, see original Microsoft Azure announcement

AWS Marketplace makes it easy to launch Graphistry. This tutorial shares a visual guide of launching Graphistry, trying your first notebook, and help with common configuration options and occasional error handling. When you’re ready, head to AWS Marketplace! And, if you haven’t heard about Graphistry’s AWS launch, learn about why we did it and what’s new.

Launch a private Graphistry instance from AWS Marketplace

1. Subscribe Screen

  • If prompted, accept terms and wait through ‘Pending’ period
    • Do not configure the annual contract discounted prepay option: Total contract price should be $0
    • Pricing occurs later when you pick the type of GPU, e.g., the g4dn.xlarge Individual/Startup configuration vs. larger Team-level servers
  • Continue to Configuration

2. Configure Screen

  • Version: Default – the latest Graphistry version
  • Region: Pick a GPU-capable region close to your users or data
    • Tip: Teams – Search for G4DN (Nvidia T4) and P3 series (Nvidia V100) on the EC2 instance comparison chart, with US East and Oregon as great options in the US.
      • Choose 1 GPU / 4 vCPUs for an individual (g4dn.xlarge)
      • Choose 1+ GPUs and > 4 CPUs for running concurrent users
    • Do not configure the annual contract discounted prepay option: Total contract price should be $0
  • Continue to Launch

3. Launch Screen

  • Action: Default – Launch from Website
  • Instance: Default is recommend – p3.2xlarge is the smallest Nvidia-RAPIDS-compatible GPU
  • Security group: We recommend ‘Create new based on Seller Settings’ – 22 (SSH for admins), 80 (initial web port), and 443 (automatic/custom TLS once you assign a domain)
  • Key pair: Use existing if you have a copy of the files, else create new (and save), and likely `chmod 400 myfile.pem` (or chmod 644 myfile.pem)
  • Launch
  • Wait till ‘Status Checks: 2/2 checks’
  • Note the `i-YourInstanceID` value, which you will use as a password
  • Follow the public IP / DNS link from your EC2 console to start your first Graphistry session!

Login & launch your first visualization & notebook

1. Login

  • In a browser, go to the public DNS provided by the EC2 console
  • Upon starting the system, you need to wait ~5 minutes, and until then, may see 5XX errors or otherwise incomplete page loads
  • AWS Marketplace images create the initial admin with unguessable credentials `admin` / `i-YourAWSInstanceID`. Upon login, we recommend changing the password, and to aid resets, email address… and then save them in a password manager.

    NOTE: Non-AWS-Marketplace users will create the initial admin account on first load, after which the system closes.

2. Open a notebook

  • ‘Analyst Getting Started’ -> ‘See Notebook’
  • In sequence, run each code cell by clicking on it and entering ‘shift-enter’
  • On cell ‘g.plot()’, on the upper right of the graph where it says ‘workbook’, click the left-most icon for ‘Open in a new window’, and click the Graphistry logo to begin
  • Follow the UI guide on how to interact with the notebook

3. Try more notebooks

  • Try other notebooks: for developers, CSV upload of your own data, various DBs, …
  • Make a copy of a notebook you want to use as a template
  • You can always edit any notebook cell, re-run it, and save your changes/outputs
  • Best practice is to make sure you can ‘run-all’ in a notebook and it gives the full results

Recommended additional config & troubleshooting:

See the Graphistry AWS Marketplace FAQ:

  • Errors: Handle common AWS issues like no available GPUs
  • IP/Domain: Set an elastic IP or domain to have a stable URL across restarts
  • Enable Graphistry notebooks to communicate with secure databases
    • If `pip install` does not have your package, SSH into the instance, and then the Docker container as root
    • Make sure the Graphistry IP is permitted by the security group for your DB
  • Create accounts for your users
  • Setup TLS and restrict server access to your VPN


Next steps & further reading

Get started