Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


This tutorial was first developed for an Indiana University Scholar Commons event (see announcement), hosted on 9/15/2014 at IU Wells Library. Now it is used as a general tutorial for a hands-on session for HTRC Data Capsule tool. 

Short link for the page http://bit.ly/1whzT6H

Table of Contents

Preparation

Sign Up for an Account, and Sign In

First

of all

, register an account on HTRC portal on the production stack, from where you will access the HTRC Data Capsule. 

click the link

Software Installation

Install a VNC Client on your computer to enable the communication between your computer and the capsule, which is a virtual machine, to be created. You can choose any VNC client you prefer.

We use VNC View for Google Chrome in this tutorial so also recommend people install the same. Install and launch the app.

click the link

Getting Familiar with the Data Capsule

Create a Capsule on HTRC Data Capsule

Log in to the HTRC portal where you just created an account and sign in. Create a capsule by clicking on the "HTRC Data Capsule"

->

and then "Create Virtual Machine" on the top of the page. You will be asked to provide information about the capsule you would like to create.

click the link

Start the Capsule

Start the capsule you were assigned by clicking on the "Start VM" button on the Virtual Machines list page (make sure you have logged in the portal in order to see the page). 

click the link

Interact with the Capsule via VNC Client

After starting the capsule, you can connect to and operate on the capsule via the VNC Client you just installed. Use the "Host Name" and "VNC port" fields of the capsule as input to the VNC Client: put them the "Address" field of the VNC Viewer, separated by a semicolon. 

click the link

Switching Between Maintenance and Secure Modes

Each capsule is designed to have 2 modes: maintenance node and secure modes. Under the "Virtual Machines" page, click on "Switch to Secure Mode" or "Switch to Maintenance Mode" buttons to switch between modes.

Under maintenance mode, user is allowed to access network freely except for HTRC corpus repository and install whatever software she wants. In secure mode, network access is restricted. User is only allowed to access a few network addresses e.g., HTRC corpus repository and search service.

click the link

Run Experiments, Release Results

Run text analysis experiments in the capsule. Details of conducting experiments are demonstrated in the 4 use cases below. If users want to export results out of the capsule, they can release the result in the capsule's secure mode.

click the link

Finishing up

Stop or delete your capsule. The next time you sign in to the Portal, you can restart the capsule and continue working within the same environment.
click the link

Questions?