Installing CollectionSpace
Installing CollectionSpace
CollectionSpace must be installed and run on a server and is accessed by users via a web browser like Chrome, Firefox, Safari, or Edge. CollectionSpace does not support the Internet Explorer web browser. No additional software needs to be installed on an end-user's computer.
Keep in mind that installing CollectionSpace on a server requires advanced knowledge and familiarity with command-line tools, networking settings, etc. If you don't have experience with these tools, consider engaging an experienced system administrator.
For detailed instructions on installing CollectionSpace onto an Ubuntu 22.04 LTS server, click on this link: Installing on Ubuntu LTS
Optional Configuration
Under Development
Elasticsearch (Experimental)
Beginning with version v4.3, you can configure CollectionSpace to work with an Elasticsearch cluster. Consult the Getting Started tutorial to learn more about Elasticsearch.
To use CollectionSpace with Elasticsearch, you'll first need to download and install Elasticsearch. Use the version of Elasticsearch required by your version of CollectionSpace:
- CollectionSpace 5.2 and above: Elasticsearch version 5.6.
- CollectionSpace 4.3 and above: Elasticsearch version 1.7.
Set up an Elasticsearch cluster following the documentation. The default configuration will create a cluster named "elasticsearch" which is the cluster CollectionSpace will attempt to work with by default.
To enable Elasticsearch indexing, edit the configuration file at '$CSPACE_JEESERVER_HOME/nuxeo-server/config/nuxeo.properties
', and set elasticsearch.enabled
to true
.
By default, CollectionSpace will attempt to connect to an Elasticsearch cluster named "elasticsearch" running on the same server. Â After you've done the basic installation of CollectionSpace, you can point CollectionSpace to a different cluster by changing the configuration file at '$CSPACE_JEESERVER_HOME/cspace/config/services/proto-elasticsearch-config.xml
' and restarting the CollectionSpace server.
Be sure your Elasticsearch cluster is running before you start the CollectionSpace server. This will ensure that all your CollectionSpace collection data will be indexed by Elasticsearch.
Related Documentation
- Configuring CollectionSpace to connect to a remote PostgreSQL database server
- Enabling access logging
- Initializing data
- Installing ImageMagick
- Naming a CollectionSpace system with an instance identifier
- PostgreSQL Installation under Linux
- PostgreSQL Installation - Windows, Mac OS X, Generic Linux
- Removing the Port Number from CollectionSpace URLs
- Shutting Down the CollectionSpace Server
- Starting Up the CollectionSpace Server
- Troubleshooting Installation Problems