This catalog contains records for items cataloged before 1980. Records are arranged alphabetically with authors, titles, and subjects interfiled.
This project uses asdf (see .tool-versions for the current ruby version)
bundle install
will install the dependencies for this project. Use bundle install
also when updating ruby gems for this project.
We use Postgres and run it via Lando in development.
Lando installation: [[https://github.com/lando/lando/releases]]
Startup: rake servers:start
Run the bin/rails server
or rails s
command, then in a browser connect to localhost:3000
bundle exec rspec <spec/**/*>
You may use Capistrano on the command line.
BRANCH=branch_name bundle exec cap staging deploy
BRANCH=branch_name bundle exec cap production deploy
Alternatively, you may deploy from ansible-tower.
We want to load in CSV files that contain GuideCard and SubGuideCard data, which was exported from the legacy version of this application. The data lives in the data
folder of this project.
To list all import services for the application: rake -T | grep import
To import the GuideCard records (takes about 3 minutes): rake import:import_guide_cards
To import the SubGuideCard records (takes about 2 minutes): rake import:import_sub_guide_cards
The CardImage records are the images that are included in the GuideCard and SubGuideCard records. There are 5,780,170 images. These are estimated to take about 9 minutes to import.
To import the CardImage records: rake import:import_card_images
Note: AWS configuration will be required for your local machine to access the images on AWS (puliiif-production s3 bucket where the images are stored).
- Go to https://princeton.edu/aws and log in with Princeton credentials.
- From the "Services" menu, select "IAM". (You might need to search for IAM in the search bar.) Under the "User" menu, create a new user. Use any user name you prefer, as long as it would be clear to your team mates that this name is associated with you.
- Add the user to the
iiifcloud
group. - Create the user, and click on it in the user list.
- click "Create access key"
- Select use case: Local code; give it a name
- Record the Access Key ID and the Secret access key you'll get on the
Success
screen. You will need to add these to your local user profile when you set up AWS command line access.
-
Install the aws cli: https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html
-
Configure it using the Access key ID and Secret Access key attached to your account. Do this by running
aws configure
or following instructions here.
-
Use default region
us-east-1
-
If you added the key to a new config stanza in your ~/.aws/credentials, you'll need to run aws commands with the --profile command line option
-
When cards were converted to OCLC records, there were quality assurance issues. These scanned cards allow us to correct these errors when they come up.
-
If we don’t correct the errors then people will be misled, e.g. notes about items held in another library, not at Princeton
-
There may be accession ids on the cards (used between 1900 and 1942 or 43) that match with entries in accession books, which have info about where we got the book and how much we paid for it. This is pertinent for rare books.
-
Call numbers may exist on the current site that weren’t transferred and that may need to be updated.
-
Law enforcement sometimes wants to know provenance -- proof of ownership and when we acquired an item.
-
Provides a historical view of library to a certain point in time, e.g. wrote an article about 3 millionth acquisition.
-
Grants the ability to print a single card and carry it into the stacks
To better understand how the SubGuide and GuideCard data relates to each other, we are able to use RDP to access the legacy code within a Windows virtual environment.
To access the code, you will need to have the Microsoft Remote Desktop application installed on your machine.
Click the 'add workspace or desktop' icon and add the following:
lib-dbserver.princeton.edu
will be the hostname- the user account will most likely be your CAS login (xxxxxx@princeton.edu)
- will need to request access to the server from a System Administrator in the Operations team
- click the 'Display' tab on the screen, and select the best resolution for your monitor, if desired
Once this is set up, right-click on lib-dbserver.princeton.edu
to connect
- press continue on the pop-up of the certificate warning to proceed
- Duo-enabled support required to access the server
During the initial launch, it may take longer for the server to boot up due to the configs being created.
Navigate to Computer
then C:/inetpub/wwwroot/ImageCat
to access the legacy files.