These notes detail procedures necessary to set up local and remote environments to use the tools discussed in this course.
Every student should follow these procedures once, at the beginning of the semester.
Obtain login credentials and delenn IP address
We will use the school’s “delenn” server for our work. You will also use your own computer.
Ask me for your login name and password. The address is
delenn.artifice.cc and the port is 2222. Take note of the port.
delenn serves various web interfaces on specific ports. Port 8080 is RStudio, while 9000 will be used for Hadoop services. These ports will only be accessible via a tunnel through SSH.
You must connect to delenn via SSH before you can use RStudio or Hadoop web interfaces. If you don’t connect with SSH first, the ports will not be available.
Add port forwarding for ports 8080 and 9000:
SSH (OS X, Linux)
Edit the file
~/.ssh/config and add this to the bottom:
Host delenn HostName delenn.artifice.cc User jeckroth <--------- replace Port 2222 LocalForward 8080 127.0.0.1:8080 # RStudio: http://127.0.0.1:8080/ LocalForward 9000 127.0.0.1:9000 # Hadoop web interface: http://127.0.0.1:9000/hadoop/
Now you can connect in the terminal with the command
Create a Bitbucket account
If you have not already, create a free Bitbucket account.
You’ll need to tell git your name and email. Every commit is recorded with a name and email. You should use the same email address you used when you created a Bitbucket account.
Log into delenn via SSH. Execute these commands (use your own name and email!):
git config --global user.name "Joshua Eckroth" <--- change to your name git config --global user.email "email@example.com" <--- change to your email
Configure RStudio & Bitbucket
After configuring SSH (see above) and logging in (so that the tunneling is active), visit http://localhost:8080 to access RStudio. Login with your delenn credentials.
We’ll need to set up an SSH key to use Bitbucket. We can do this from RStudio (which is cool!). In the Tools menu, click “Global Options…”
Click “Git/SVN” on the left menu.
Click “Create RSA Key…”
If desired, provide a password. Then click “Create”.
The public/private key pair will be generated. Click “Close”.
Next, we need to tell Bitbucket about your public key. Click “View public key”.
Copy the public key. We’ll soon paste it on the Bitbucket website.
Now, go to Bitbucket, and click your avatar on the top-right, then click “Manage account”.
Click “SSH keys” on the left menu.
Click “Add key”.
Paste your public key (copied earlier) and click “Add key”.
Now you should be ready to follow the RStudio workflow.