TRACE

Trace is a University of Tennessee digital archive that showcases and preserves published and unpublished works by faculty, departments, programs, research ...

TRAC-1029e to install code to satisfy JIRA Ticket TRAC-1029.

What is the Institutional Repository Project?

The Libraries is currently investigating open source IR systems with the intention to select and implement a new institutional repository platform to replace the hosted Bepress Digtial Commons instance of Trace.

The TRACE project in github is a virtual platform for the DI programmers to investigate the most effective solutions for the IR Project.

This virtual platform should support

• Creation of a migration plan
• Determination of hardware requirements
• An agile software development environment
• A secure testing environment
• The ability to demonstrate the look and behavior of the site to our peers outside of the DI programming group

Introduction

The is a development environment virtual machine for Islandora 7.x-1.x. It should work on any operating system that supports VirtualBox and Vagrant.

N.B. This virtual machine should not be used in production.

Requirements

1. VirtualBox
2. Vagrant
3. git

Setup on OS X

Video on how to Open Terminal on a MAC

Install brew, virtualbox, vagrant, and git

Copy and Paste this into terminal and hit enter

sh -c "`curl -fsSL https://gist.githubusercontent.com/DonRichards/d5674631e20c2e7c946712883e2caa81/raw/770436972b11a7a8a62698e5f8d5939c93511abb/remote-setup.sh`"

This is a breakdown on what this code does (Skip if you did previous step)

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
brew tap caskroom/cask
brew install homebrew/completions/brew-cask-completion
brew cask install virtualbox
brew cask install vagrant
brew cask install vagrant-manager
brew install git
cd ~/desktop
git clone https://github.com/utkdigitalinitiatives/TRACE
cd islandora_vagrant
vagrant up

Windows Setup

1. Install VirtualBox
2. Install Vagrant
3. 32bit Install git
   64bit Install git <-- most likely this one

Note: To open "terminal" in windows
Hold Windows Key and type r

This will open a run window. Type cmd and click OK

Linux

install git install VirtualBox install vagrant clone repo cd repo vagrant up

Download it to the desktop

Windows

cd %UserProfile%\Desktop\
git clone https://github.com/utkdigitalinitiatives/TRACE/
vagrant up

Daily Use

To Start

Open Terminal
OSX

cd ~/desktop/TRACE
vagrant up

Windows

cd %UserProfile%\Desktop\TRACE
vagrant up

To Stop when done using TRACE

Open Terminal
OSX

cd ~/desktop/islandora_vagrant
vagrant halt

Windows

cd %UserProfile%\Desktop\TRACE
vagrant halt

Oops. Messed up?

Just reset/delete everything in TRACE
Open Terminal
OSX

cd ~/desktop/islandora_vagrant
vagrant halt
vagrant destroy
vagrant up

Windows

cd %UserProfile%\Desktop\TRACE
vagrant destroy
vagrant up

Open browser: http://localhost:8000

No login: simulates general anonymous user

Authenticated login - any netid login, can submit, but it is held in workflow. If it is a ETD, it follows ETD forms and workflows.

• username: authUser

• password: authUser

• username: userA

• password: userA

• username: userB

• password: userB

Priviledged User login - a netid login that can submit outside of the workflow, like faculty.

• username: privUser
• password: privUser

Manager login - can assign users to roles, can approve submissions. - username: manager - password: manager

Collection Manager login - can manage a certain collection.

• username: thesis_manager
• password: thesis_manager

root Admin login: - for maintaining system, has all permissions.

• username: admin
• password: islandora

---

Developer Notes

PhpMyAdmin was added to allow database work during development

phpmyadmin login:

• username: root
• password: islandora

MySQL:

• username: root
• password: islandora

Tomcat Manager:

• username: islandora
• password: islandora

Fedora:

• username: fedoraAdmin
• password: fedoraAdmin

GSearch:

• username: fgsAdmin
• password: fgsAdmin

ssh, scp, rsync:

• username: vagrant
• password: vagrant
• Examples
  • ssh -p 2222 vagrant@localhost or vagrant ssh
  • scp -P 2222 somefile.txt vagrant@localhost:/destination/path
  • rsync --rsh='ssh -p2222' -av somedir vagrant@localhost:/tmp

Notes

Check out the Wiki for instructions and troubleshooting

Travis Lint Failure

Install: https://github.com/koalaman/shellcheck

shellcheck yourscript

CAS Setup Information

CAS Module phpCAS library Managing CAS Users