A Pretty Good Jacktrip Toolkit — Getting started — the long version with screenshots

This version of the installation instructions is intended for people who doing this for the first few times or would like to refresh their memory with screenshots.  There is a short step by step version that is intended for those who are familiar with the process and would like a short reminder of what to do.

Step1: Provision a Linode server

Log into Linode and provision a server with this StackScript (A Pretty Good Jacktrip Toolkit).  Select a region that is the best geographic compromise between participants.  Select a server based on use — the lowest level server works fine for experimentation, higher levels (more cores/memory) will work better for more demanding applications.  Provide a password for the Root account.

Here is what the server looks like once it’s provisioned.

“A” is the IP address of the server (to be used in jacktrip command strings, etc.) and “B” is the string to log into it from the terminal.  “C”, logging into the LISH Console, is coming up in a step or two.

Step2: SSH into server

I prefer to log into the server from the terminal on my local computer.  One advantage is that I will have a complete log of what happens, in case something goes wrong.

Step3: run  ~/create_jacktrip_server.sh

This is the odd part (which I hope goes away soon) — right now a second script (which has been created by the first one) needs to be run in order to complete this process because I haven’t yet figured something out.

Copy and paste ~/create_jacktrip_server.sh command to run the script.  The StackScript runs for a while after Linode has provisioned the server — wait a few minutes for it to complete if there are “command not found” errors.

Step4: Answer “yes” to the prompt in the script

This will come fairly early in the script.  Use the left-arrow key to select “yes” and hit Return/Enter to resume/finish the script.

Step5: Wait for that second script to complete

Soon, some form of a message like this will display when the script completes.  That’s it!  The server is ready to use.  This message is a set of next-step shortcuts.  Keep reading for a more detailed explanation.

The server is ready. This is version 1.4

NEXT STEPS:

Log out of this session (some of the settings won't appear until the next log in)
     type:  logout

Graphical interfaces:

GLISH -- Linode's web based interface
     Log into Glish in Linode
     type:  startxfce4

VNC -- a client/server interface

     Start the server on the Linode:

          Log back into the server with a new SSH session in a new terminal window.

     Here are some useful commands: 
     type: vncpasswd 

          (to set the VNC-session password - only needed the first time,
           Note: no more than 8 characters will be captured)

     type: vncserver -geometry 1600x900 

          (to start the server - needed every time. This example sets 
          screen-dimensions to 1600x900 but try other options)

     type: vncserver -kill :1 
          (to stop the server, perhaps to try a different geometry)

     Start the client on your local machine

     Here's good client:
          https://www.realvnc.com/en/connect/download/viewer/

     Start a session by connecting to the Linode's IP address on port 5901
          (formatted like this: 128.66.123.456:5901 )

Info/complaints/suggestions page: 
https://www.haven2.com/index.php/a-pretty-good-jacktrip-toolkit


* * * * * * * * * * * * *

Here are the steps to log into the graphical interface.

– Option 1:  Through a web browser

Return to the StackScript screen and click “Launch LISH Console”

Click the “Glish” tab, and…

… log into the server (look at the picture below).  Once logged in, type in…

startxfce4

– Option 2:  Log in with a VNC client on your local computer

First time the server is started, set a password for the VNC session (maximum 8 characters long) with ” vncpasswd ” at the command line.  It will prompt for the password and a confirmation.

Log into the server from your local computer and type ” vncserver -geometry 1600×900 ” to launch the VNC process on the Linode server.  Note that typing ” vncserver ” alone without the geometry parameter is fine — I prefer to make the desktop dimensions a little bigger than the default.

Log into the server with a VNC client app on your computer.  Here’s an example using the viewer from RealVNC.  Note that the port ( “:5901” ) must be included in the IP address.

 

Here’s what appears in either case (GLISH or VNC).  Select the default config.  You are on your way.

This is an excellent time to create a “Basecamp” image of the server.  It’s built, but absolutely nothing has been changed or configured.  A great starting point for new projects, or rebuilding projects that have gone wrong.  Go to the “Images” tab on Linode to create the image.

Navigation:

Home page

Installation — Getting started — the short version

Installation — Getting started — the long version with screenshots

FAQ — A collection of hints and tips