| Excerpt |
|---|
View step-by-step tutorials for common Data Capsule functions. |
| Info |
|---|
Once you have your Capsule running, you may find it useful to open this guide in an internet browser in your Capsule so you can copy and paste commands. The short link for this page is: https://wiki.htrc.illinois.edu/x/TQFRAQ. |
Overview of Generic Research Workflow in a Capsule
- Register and sign in to your HTRC account.
- Create and start a Capsule in the HTRC.
- View your Capsule using the Remote Desktop view/Terminal view, or SSH into your Capsule in Maintenance mode.
- Configure the software environment of the Capsule as needed. Download the scripts or programs you plan to use in your analysis.
- Switch Capsule to Secure mode through HTRC.
- Run your analysis against the secure HTRC corpus repository.
- Move your results to the secure volume storage on the Capsule.
- Switch Capsule back to Maintenance mode to regain normal network access.
Step-by-Step Instructions
Note: You will need to create an HTRC account if you don't already have one.
From the Analytics homepage, create a Capsule by clicking on Data Capsules on the top menu, then select Create a Capsule from the dropdown menu. You will be asked to provide information about the Capsule you would like to create. This step also explains how to create or convert an existing Capsule to one with access to the full HathiTrust corpus, for HathiTrust members only.
| Expand |
|---|
|
| Include Page |
|---|
| Create or Convert a Capsule |
|---|
| Create or Convert a Capsule |
|---|
|
|
Start the Capsule you created by clicking the Start Capsule button on the Capsules page.
| Expand |
|---|
|
| Include Page |
|---|
| Start the Capsule |
|---|
| Start the Capsule |
|---|
|
|
Interact with the Capsule either via Remote Desktop viewer or Terminal viewer.
| Expand |
|---|
| title | Interact with the capsule |
|---|
|
| Include Page |
|---|
| Interact with the Capsule |
|---|
| Interact with the Capsule |
|---|
|
|
Alternatively, you can SSH into your Capsule when it is in Maintenance mode only.
| Expand |
|---|
| title | SSH access in Maintenance mode |
|---|
|
| Include Page |
|---|
| SSH Access in Maintenance Mode |
|---|
| SSH Access in Maintenance Mode |
|---|
|
|
Switch between Maintenance and Secure mode.
| Expand |
|---|
| title | Switch Capsule modes |
|---|
|
| Include Page |
|---|
| Switch Capsule modes |
|---|
| Switch Capsule modes |
|---|
|
|
Share your Research Data Capsule with up to 5 other researchers.
| Expand |
|---|
| title | Managing Data Capsule Collaborators |
|---|
|
| Include Page |
|---|
| Managing Data Capsule Collaborators |
|---|
| Managing Data Capsule Collaborators |
|---|
|
|
Change your data capsule resource amounts.
| Expand |
|---|
| title | Updating data capsule resources |
|---|
|
| Include Page |
|---|
| Updating data capsule resources |
|---|
| Updating data capsule resources |
|---|
|
|
Bring text data into your Capsule.
| Expand |
|---|
|
| Include Page |
|---|
| Fetching Volume OCR Content in HTRC Data Capsule (Secure Mode) |
|---|
| Fetching Volume OCR Content in HTRC Data Capsule (Secure Mode) |
|---|
|
|
Perform your analysis. See the following use cases for examples of how to perform text analysis in the Capsule.
| Expand |
|---|
| title | See example use cases |
|---|
|
|
If you will need more than one session to complete your research, save your interim data to the Secure Volume.
| Expand |
|---|
| title | Save data to Secure Volume |
|---|
|
| Include Page |
|---|
| Save Data to the Secure Volume |
|---|
| Save Data to the Secure Volume |
|---|
|
|
Between sessions, stop the Capsule via the HTRC using the web browser on your personal desktop. The next time you log in, you can restart the same Capsule and continue your work.
| Expand |
|---|
|
| Include Page |
|---|
| Stop the Capsule |
|---|
| Stop the Capsule |
|---|
|
|
When you are finished with your research, request to export your non-consumptive results. When you no longer need the Capsule, delete it via the HTRC.
| Expand |
|---|
| title | Export non-consumptive results |
|---|
|
|
How to create a data Capsule template:
| Expand |
|---|
| title | Creating and Using a Data Capsule Template |
|---|
|
| Include Page |
|---|
| Creating and Using a Data Capsule Template |
|---|
| Creating and Using a Data Capsule Template |
|---|
|
|
What to do if you need help troubleshooting problems with your data Capsule:
| Expand |
|---|
| title | Request help directly from your Data Capsule |
|---|
|
| Include Page |
|---|
| Request Data Capsule Help |
|---|
| Request Data Capsule Help |
|---|
|
|