Launching Graphistry in AWS Marketplace: Tutorial

Posted by Graphistry Team on Apr 29, 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

  • Accept terms, wait through "Pending" period, Continue to Configuration


2. Configure

  • Region: Pick one close to your users
  • Continue to Launch


3. Launch

  • Instance: We recommend p3.2xlarge
  • 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