Versions Compared

Key

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

...

This guide will help you manually install CollectionSpace on a Linux server running a recent Ubuntu LTS release.  If you decide not to use the Automated Installer, you'll need to be very comfortable with the Linux bash shell and with using common Linux command-line tools to install and configure CollectionSpace.  You You will also need to have an account on the targeted Ubuntu server that has elevated (i.e., sudo) privileges/permissions.

After finishing the installation, you will have a fully functioning CollectionSpace instance that contains a working default "core" tenant tenant/profile.  The "The core" profile  profile is a generic/general-purpose instance of CollectionSpace.  There are a handful of more There are additional domain-specific profiles that you can configure and use in CollectionSpace -see the demo site for more details at http://demo.collectionspace.org.

Info
titleRECOMMENDED: Get the default profile working first
The instructions on this page will help you install the core/default CollectionSpace profile. Before trying to select one of the domain-specific profiles or trying to customize your CollectionSpace instance, we strongly recommend getting the "core" profile  profile installed and running first.

...

Ideally, the Ubuntu server you're going to try to install CollectionSpace onto has been setupset up/created solely for the purpose of running CollectionSpace.  If If the server is an existing system that is being used or has been used to host other software, you may encounter problems that will require advanced system administration and support.  

If you want to create a new Ubuntu 1820.04 LTS server solely for running CollectionSpace, here are a few options:

...

Info

Last tested on:
2020: Ubuntu 1820.04.41

Installation Prerequisites

Before attempting to install CollectionSpace, please review the system requirements here: the System Requirements for a CollectionSpace Server.  FirstFirst, login log in to your Ubuntu server and make sure you have sudo (super user) privileges. Try the following command:

...

Next, create a system account for installing and managing CollectionSpace.  Use name "cspace" to create for the account:

Code Block
sudo useradd -c "CollectionSpace admin linux account" -m -s /bin/bash cspace

...

Next, install the prerequisites available via the using apt manager:

Code Block
languagebash
sudo apt-get update
sudo apt-get install ant maven imagemagick openjdk-8-jdk wget git

If all went well, you should see a message something like:

Code Block
SettingProcessing triggers upfor mavensystemd (3245.0.5-14-4ubuntu3.2) ...
update-alternatives: using /usr/share/maven/bin/mvn to provide /usr/bin/mvn (mvn) in auto mode
Processing triggers for man-db (2.9.1-1) ...
Processing triggers for libcca-bincertificates (2.19-0ubuntu6.720201027ubuntu0.20.04.1) ...
ProcessingUpdating triggerscertificates for libgdk-pixbuf2.0-0:amd64 (2.30.7-0ubuntu1.2) ..in /etc/ssl/certs...
0 added, 0 removed; done.
Running hooks in /etc/ca-certificates/update.d...

done.
done.
Processing triggers for camime-certificatessupport (20141019ubuntu0.14.04.13.64ubuntu1) ...
UpdatingProcessing certificatestriggers in /etc/ssl/certs... 0 added, 0 removed; done.
Running hooks in /etc/ca-certificates/update.d....
donefor libc-bin (2.31-0ubuntu9.1) ...
Processing triggers for libgdk-pixbuf2.0-0:amd64 (2.40.0+dfsg-3) ...

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.

...