Tools for compiling and building source code aren't included by default on recent versions of Mac OS X. Apple's free Xcode suite of tools provides these tools, and you will first need to install it.

To install Xcode and its command line tools:

• Open the App Store application. (You can find it in your /Applications folder.)
• Search for Xcode.
• Click the appropriate link(s) to download and install Xcode. (Note: this is a large download, fully 1.65 GB for Xcode 4.6, for example.)
• Install the Xcode command line tools:
  • Open the Xcode application. (You can find it, once it has been installed, in your /Applications folder.)
  • If this is a first-time installation of Xcode:
    • Accept the License Agreement.
    • Download any suggested components at the System Component Installation screen.
  • Select Preferences ... from the Xcode menu.
  • Click the Downloads icon.
  • Install the Command Line Tools from the Downloads->Components tab.

To install Java 7:

• Visit Oracle's Java SE download page
• Click any of the Java Platform (JDK) 7u... Download buttons on that page.
• Click the Accept License Agreement button.
• Follow the next steps described in Oracle's guide, How do I install Java for my Mac?:
  • One minor but important change from that guide: you'll be downloading a file whose name begins with jdk, rather than jre as described in the guide.
    (As of this writing, the file you will want to download is named jdk-7u13-macosx-x64.dmg: the Java Development Kit (JDK) for Java 7 Update 13.)

Getting CollectionSpace

Go to the directory where you want to install CollectionSpace:

cd /usr/local/share

Download the tarball via FTP:

ftp source.collectionspace.org

Log in with the username anonymous and any password. Then:

Unpack tarball:

This will create an

directory.

Optionally remove the tarball:

Make necessary files executable:

Setting up CollectionSpace

You need an administrative user in PostgreSQL that CollectionSpace can use: one that has been granted full privileges and can grant privileges to other users. Either set up a new user account (recommended), or you can use the postgres user that you set up in the prerequisites section of this page. The values myusername and mypassword, below, should be replaced by the actual username and password of this user.

Set up environment variables. Make sure that the following values correspond to your environment:

CSPACE_JEESERVER_HOME: The full path to the

directory that was created when you unpacked the CollectionSpace tarball.
CATALINA_HOME: The full path to the

directory, identical to the value of CSPACE_JEESERVER_HOME.
CATALINA_PID: The full path to a file which will hold the Tomcat server process number. This is used by the Tomcat shutdown script.
CATALINA_OPTS: Environment options for the Tomcat server process. The recommended options below are Java Virtual Machine (JVM) memory settings which permit allocation of up to 1 GB of RAM to the Java heap and up to 384 MB of RAM for Java Permanent Generation (PermGen) space.
JAVA_HOME: The full path to your Java directory. Apple recommends that you set this to the output of running the command /usr/libexec/java_home, and by entering that command surrounded with backticks (`), as shown below, you can do that automatically.
DB_CSADMIN_PASSWORD: The password for the administrative database user for the CollectionSpace application. This must match the password for that user that you specified while setting up PostgreSQL, via the instructions in PostgreSQL Installation under Linux. (This administrative user by default will be named csadmin, and will be a superuser. However, this user will have fewer privileges than the overall database administrator superuser, by default named postgres.)
DB_NUXEO_PASSWORD: Any database-legal password of your choice for the nuxeo database user. This user can work with CollectionSpace data stored in Nuxeo, the content management system underlying CollectionSpace.
DB_CSPACE_PASSWORD: Any database-legal password of your choice for the cspace database user. This user can work with CollectionSpace data for users, roles, and access permission.
DB_READER_PASSWORD: Any database-legal password of your choice for the reader database user. This user will have read-only access to CollectionSpace data stored in Nuxeo.
ANT_OPTS: Environment options for the Apache Ant build tool. The recommended options below are Java Virtual Machine (JVM) memory settings which permit allocation of up to 768 MB of RAM to the Java heap and up to 512 MB of RAM for Java Permanent Generation (PermGen) space.
MAVEN_OPTS: Environment options for the Maven build tool. The recommended options below are Java Virtual Machine (JVM) memory settings which permit allocation of up to 768 MB of RAM to the Java heap and up to 512 MB of RAM for Java Permanent Generation (PermGen) space.

The example below is for the Bash shell; edit ~/.bashrc or ~/.bash_profile and be sure to substitute the actual values for your environment:

If you added these lines to ~/.bashrc, to ensure these environment variables are present in every new login shell, edit or create the ~/.bash_profile file and add the following line to that file:

. ~/.bashrc

Next, the path for PostgreSQL's binaries need to be added to the shell PATH environment.
Mac OS X sets the PATH environmental variable not in ~/.bashrc as would be the case in other Linux based OS's but in /etc/paths.

/etc/paths is read-only so you'll need the sudo command to save any edits :

sudo vi /etc/paths

The PATH variable below should reflect the path for PostgreSQL's bin/ directory, which is defaulted to /Library/PostgreSQL/9.1/bin. Change this to reflect your PostgreSQL installation path if you have a custom installation.
Add the following line to the top of the file:

/Library/PostgreSQL/9.1/bin

(If you've installed a version of PostgreSQL other than 9.1, change the version number in the path above accordingly.)

Opening a new Terminal.app window and typing env will show a list of all environmental variables.

Configure your tenant

The settings file for a tenant is located at either:

• $CSPACE_JEESERVER_HOME/lib/tenants/{tenantname}/settings.xml, where {tenantname} is replaced by the actual name of the tenant;
  or
• $CSPACE_JEESERVER_HOME/lib/tenants/{tenantname}/local-{tenantname}-settings.xml, where {tenantname} is replaced by the actual name of the tenant.

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

• tomcat-main/src/main/resources/tenants/{tenantname}/settings.xml, where {tenantname} is replaced by the actual name of the tenant;

The example below is for editing the settings file for the core tenant:

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>
  

• 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.

      <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.)

Build the Application layer and deploy (copy) your changes to the CollectionSpace server. A first-time build can take approximately 5-10 minutes on a typical system; subsequent builds will be considerably faster:

(During this process, you may notice a large number of dependency-related files being downloaded, as well. These files will be downloaded to your local Maven repository directory, $HOME/.m2/repository, on most Mac OS X systems.)

Initialize database and users and permissions

• 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
  

• 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

  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

You are now done with the most basic install.

Starting the server

Start the server:

$CSPACE_JEESERVER_HOME/bin/startup.sh

Wait for it to fully start up. (For more information on verifying server startup, see [Starting Up CollectionSpace Servers].)

Logging in

Check the installation: Open a browser and go to this URL http://<ip-address>:8180/collectionspace/ui/core/html/

You should be able to log in to the demonstration core tenant using the user admin@core.collectionspace.org and the password Administrator.