Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin

...

Info
titleSet Linux/Mac script file permissions

Under Linux, Mac OS X, and other Unix-like operating systems, you will need to set the permissions of several Tomcat script files to executable for the user or group that will start the CollectionSpace servers. If you are in the directory in which you've just unpacked the tar.gz file, do this using the following command:

Code Block
chmod u+x apache-tomcat-7.0.57/bin/*.sh

SUMMARY — DOWNLOAD

You have now downloaded and unpacked the files you need to use to install the CollectionSpace server. The next section provides instruction on how to install and deploy CollectionSpace.

...

The settings file for a tenant is located inside the application folder:

Windows:

tomcat-main\src\main\resources\tenants\{tenantname}\settings.xml
Code Block

Linux, Mac OS X, or Unix:

tomcat-main/src/main/resources/tenants/{tenantname}/settings.xml
Code Block

where {tenantname} is replaced by the actual name of the tenant.

Edit this file. (The example below is for editing the settings file for the core tenant, using the vi editor in Linux, Mac OS X, or Unix; you can use an equivalent command to edit this file in your favorite plain text editor in Windows.)

Code Block
vi tomcat-main/src/main/resources/tenants/core/settings.xml
  • In the <settings><email><baseurl> setting, enter your server's Internet host address (its hostname or IP address). The baseurl will be the beginning part of the URL which a user can visit to reset their password:

    <email> <baseurl>http://yourserverhostnamehere:8180</baseurl>
    Code Block
  • In the <settings><email><from> setting, enter an email address. This will be the email address in the From: line of password reset emails; e.g.

    Code Block
        <from>youremail@example.com</from>
    
  • In the <settings><persistence><service><url> setting, verify the server address of the CollectionSpace services layer. This is the address of the back-end part of CollectionSpace that stores data, such as cataloging and procedural records. (Usually this is running on your own host and you can simply leave the default value of localhost here.)

...

  • Enter the following command to build the CollectionSpace Services layer. A first-time build can take approximately 10 minutes on a typical system; subsequent builds will be considerably faster:

    mvn clean install -DskipTests
    Code Block
  • Enter the following command to initialize the CollectionSpace databases and import a default set of users and permissions. This can take approximately 10-15 minutes on a typical system:

    Warning
    titleWarning

    The ant create_db  -Drecreate_db=true command deletes any existing databases named 'nuxeo' and 'cspace' before it creates empty new databases using those names. If you have any databases matching these names, make sure to first rename them or back them up before running that command.

    ant undeploy deploy create_db -Drecreate_db=true import
    Code Block
Tip
titleTip

If an error occurs during any of these 'ant' commands, you can usually find a relevant error message near the end of the output from running that command.

...