Cloning the Github Repositories

There are two Github repositories that must be cloned on the the server in order to deploy Nomisma.org: the code which comprises the framework and the data repository that contains all of the RDF/XML files that make up the Nomisma concepts and the Ontology RDF files. The Nomisma framework Github repository must be cloned onto the server and a symlink placed into the Orbeon apps folder to deploy the application. If you choose to download the zip file from Github instead of cloning, skip to step 4. You may wish to fork the repository and clone from that.

1. Install Git (It may be necessary to add SSH public keys for servers into user accounts in Github).
2. The repository may be cloned anywhere on the server, but I have always preferred to create /usr/local/projects
3. After creating /usr/local/projects, do a git clone [email protected]:nomisma/framework.git nomisma to clone the repository within this location to the folder nomisma. Note: References in Orbeon are case sensitive to 'nomisma' so the 'framework' repo should be cloned as 'nomisma.'
4. Create a symlink at $TOMCAT_HOME/webapps/orbeon/WEB-INF/resources/apps/nomisma which links to /usr/local/projects/nomisma
5. Deploy the Github data directory on the server, git clone [email protected]:nomisma/data.git nomisma-data.
6. Create symlinks to the Nomisma data and ontology in the Orbeon resources folder: sudo ln -s /usr/local/projects/nomisma-data /var/lib/tomcat10/webapps/orbeon/WEB-INF/resources
7. Edit /usr/local/projects/nomisma/config.xml and ensure that the data_path element corresponds to the file paths where you cloned the above two repositories. Note: This config.xml file also contains URLs for Solr and Fuseki.
8. Make the absolute_data_path writable by Tomcat (includes lines to make /etc/fuseki writeable by Tomcat for the SPARQL endpoint):

• vi /etc/systemd/system/tomcat10.service.d/override.conf

    [Service]
    ReadWritePaths=/usr/local/projects/nomisma-data/
    ReadWritePaths=/etc/fuseki/
    StandardOutput=file:/var/log/tomcat10/catalina.out

After following these instructions (and the steps that follow for deploying Fuseki, Solr, and establishing Tomcat authentication), the home page of the public user interface will be available at http://servername:8080/orbeon/nomisma/ and the admin panel will be available at http://servername:8080/orbeon/nomisma/admin/