Launching Graphistry in AWS Marketplace: Tutorial

Posted by Graphistry Team on Apr 29, 2019

Last Updated: 9/7/2019


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
  • 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: Search for P3 series (Nvidia V100)  on the EC2 instance comparison chart, with US East and Oregon as great options in the US.
    • 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"
  • 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"
  • 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
  • As a first-time user, create the initial admin account from the webpage, and be sure to record the email/user/pwd


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