...
| Info |
|---|
Last tested on: |
Installation Prerequisites
...
Next, create a system account for installing and managing CollectionSpace. Use the name "cspace" collectionspace for the account:
| Code Block |
|---|
sudo useradd -c "CollectionSpace admin linux account" -m -s /bin/bash cspacecollectionspace |
Next, set a password for the new "cspace" account collectionspace account. Do NOT use the following example password. Create your own password and record it somewhere secure:
| Code Block |
|---|
echo -e "cspaceExamplePassword\ncspacenExamplePassword" | sudo passwd cspacecollectionspace ### Replace 'cspaceExamplePassword' with a strong password |
Next, install the prerequisites using apt:
| Code Block | ||
|---|---|---|
| ||
sudo apt update sudo apt install ant maven imagemagick openjdk-8-jdk wget git |
...
| Code Block |
|---|
Processing triggers for systemd (245.4-4ubuntu3.211) ... Processing triggers for man-db (2.9.1-1) ... Processing triggers for ca-certificates (20201027ubuntu0.2020210119~20.04.1) ... Updating certificates in /etc/ssl/certs... 0 added, 0 removed; done. Running hooks in /etc/ca-certificates/update.d... done. done. Processing triggers for mime-support (3.64ubuntu1) ... Processing triggers for libc-bin (2.31-0ubuntu9.12) ... Processing triggers for libgdk-pixbuf2.0-0:amd64 (2.40.0+dfsg-33ubuntu0.2) ... |
If you think you've encountered an error, send an email to the CollectionSpace "Talk" list at talk@collectionspace.org. Include any error messages you've seen and give a detailed description of what steps you've already performed.
...
| Multiexcerpt macro | ||
|---|---|---|
| ||
Set up TomcatLogin Log in to your Ubuntu server using an account with CollectionSpace runs as a Tomcat 8 server application. A pre-configured version of Tomcat 8 is provided with the CollectionSpace distribution package. Start by downloading the CollectionSpace distribution package "tarball": Unpack the tarball: This will create an Next, make necessary files owned by the You can remove the tarball if you want/need: |
...
| Multiexcerpt macro | ||
|---|---|---|
| ||
Setting the CollectionSpace Environment VariablesFor the CollectionSpace server to install and run properly, it requires the following shell environment variables to be defined for the
By default, all but the "
Your CollectionSpace instance can be configured to fetch data from another CollectionSpace instance. For example, the Materials profile/tenant can be configured to fetch shared authority and vocabulary data from a CollectionSpace instance that is setup to share common authority data. The following environment variables can used to create a connection to that CollectionSpace instance.
The example below is for a Linux Bash shell. As the Now edit the Add the following lines of text to the end of the .bashrc file: Save your changes and exit the vim editor. Next, make sure to source your ~/.bashrc so the environment variables are set and available. The next time you login to the WARNING: Use difficult to guess values for the password environment variables above -i.e., the ones ending with " |
Now that we have the environment set up, we can grab the source code for CollectionSpace. The source code resides in two projects hosted on GitHub: services, and application. Logged in as the cspace user collectionspace user, enter the following commands:
...
To start the CollectionSpace server, login to the host machine as the cspace collectionspace user (or sudo su - cspace ) and run this command:collectionspace
| Code Block | ||
|---|---|---|
| ||
$CSPACE_JEESERVER_HOME/bin/startup.sh |
...
To see if the installation was successful and that the CollectionSpace server started up without problems. Try the following command:
| Code Block |
|---|
curl -i -u admin@core.collectionspace.org:Administrator http://localhost:8180/cspace-services/collectionobjects -u admin@core.collectionspace.org:Administratorsysteminfo |
If successful, you should see output that looks something like this:
| Code Block |
|---|
HTTP/1.1 200 OK ServerCache-Control: Apache-Coyote/1.1 Set-Cookie: JSESSIONID=745CD7316C77FF98D2474C0640009FDD; Path=/cspace-services/; HttpOnly Content-Type: application/xml Content-Length: 383 Date: Wed, 20 Jul 2016 22:24:00 GMTno-cache, no-store, max-age=0, must-revalidate Pragma: no-cache Expires: 0 X-XSS-Protection: 1; mode=block X-Frame-Options: DENY X-Content-Type-Options: nosniff Content-Type: application/xml Content-Length: 541 Date: Fri, 30 Oct 2020 03:37:16 GMT <?xml version="1.0" encoding="UTF-8" standalone="yes"?><ns2:system_info_common xmlns:ns2="http://collectionspace.org/services/systeminfo"><displayName>CollectionSpace Services v6.1</displayName><instanceId>_default</instanceId><version><major>6</major><minor>1</minor><patch>1</patch><build>1</build></version><javaVersionString>1.8.0_272</javaVersionString><host>Architecture:amd64 Name:Linux Version:5.4.0-52-generic</host><hostTimezone>UTC</hostTimezone><hostLocale>en</hostLocale><hostCharset>UTF-8</hostCharset></ns2:system_info_common> |
If you dont see "HTTP/1.1 200 OK" in the first line of the output, review the installation instructions to see if you missed a step. If you are not able to get past this error, contact the CollectionSpace community "Talk" list at talk@collectionspace.org. Please include as much detail as possible so someone in the community can try to help you.
...
Now that your CollectionSpace server is running, open a browser and go to http://<ip-address>:8180/cspace/core/login where <ip-address> is the hostname or IP address of the machine where you installed CollectionSpace. If you have a web browser running on the same server that you installed CollectionSpace on, you should be able to use this URL: http://localhost:8180/cspace/core/login
You should be able to log in to the default core tenant using the user admin@core.collectionspace.org and the password Administrator.
...
To properly shutdown the CollectionSpace, login to the host machine as the cspace collectionspace user and enter this command:
...
Now that you have a working system you may want to