Difference between revisions of "ART installation manual"
(→Download and install the ART-DECOR eXist-db server) |
|||
Line 1: | Line 1: | ||
− | ==Project hosting== | + | ==Project hosting == |
{{Box|type= l_green_dark|text=We offer free project hosting on ART-DECOR. Feel free to [[contact]] us if you are interested.}} | {{Box|type= l_green_dark|text=We offer free project hosting on ART-DECOR. Feel free to [[contact]] us if you are interested.}} | ||
==Introduction== | ==Introduction== |
Revision as of 18:56, 5 June 2015
Contents
Project hosting
Introduction
This page contains a short overview of the installation process. For a more complete installation manual for ART-DECOR in production environments, see ART-DECOR installation on linux.
Prerequisites
The software requires a Java development environment (JDK).
Download and install Apache Tomcat
Download and install Apache Tomcat following the instructions for your platform.
Installation on OS X
Download a binary distribution of the core module: apache-tomcat-7.x.y.tar.gz (where x.y should be replaced with the latest stable release of Tomcat. In examples below Tomcat version 7.0.0 is used).
Opening/unarchiving the archive will create a folder structure something like this in your Downloads folder:
~/Downloads/apache-tomcat-7.0.0/apache-tomcat-7.0.0
Move the unarchived distribution to /usr/local:
sudo mv ~/Downloads/apache-tomcat-7.0.0/apache-tomcat-7.0.0 /usr/local
To make it easy to replace this release with future releases, we are going to create a symbolic link that we are going to use when referring to Tomcat:
sudo ln -s /usr/local/apache-tomcat-7.0.0 /Library/Tomcat
Change ownership of the /Libaray/Tomcat folder hierarchy:
sudo chown -R <your_username> /Library/Tomcat
Make all scripts executable:
sudo chmod +x /Library/Tomcat/bin/*.sh
Instead of using the start and stop scripts, you may also want to check out Activata’s Tomcat Controller a tiny freeware app, providing a UI to quickly start/stop Tomcat.
Download and install ART-DECOR Orbeon web archive
Download the art-decor.war file from: http://sourceforge.net/projects/artdecor/files/Orbeon/art-decor.war/download
Unzip.
Follow the instructions in the readme file: http://sourceforge.net/projects/artdecor/files/Orbeon/README.txt/download
Download and install the ART-DECOR eXist-db server
1.
Download the eXist-db installer file from: http://sourceforge.net/projects/artdecor/files/eXist-db/eXist-db-setup-2.1-rev0000.jar/download Note: this is an installer with specific configuration prepared for ART-DECOR.
2.
Start the installer by double clicking on the installation file. Follow the instructions in the installer, keep clicking ‘next’ until the installation process is completed. Note: enter an admin password when asked, do not leave it blank.
3.
Start the eXist-db server. How to start the server is explained on the last page of the eXist-db installer.
Install ART-DECOR software & data
All ART-DECOR software and data is installed using the eXist-db package manager. The default repository URL points to the eXist-db public repository, this needs to be changed to point to the public repository residing at repository.art-decor.org.
1.
Point your browser to: http://localhost:8877/apps/dashboard/index.html You should see the dashboard page:
2.
Click on the ‘Not logged in’ and log in as admin with the password you entered during installation.
3.
To change the default repository URL click on the ‘Collections’ icon to open the collections browser and locate the dashboard configuration at: /db/apps/dashboard
4.
Double click on the file configuration.xml to open it in eXide.
- To install the stable release (latest version):
Change the content of the repository element to:
https://repository.art-decor.org/stable2
Save the changes.
Optionally: You can also download and install the packages from our repositories locally, although this is normally not a required step. You may find these XAR repositories at:
- http://decor.nictiz.nl/apps/public-repo/retrieve.html (Stable release)
- http://decor.nictiz.nl/apps/public-repo-dev/retrieve.html (Development release)
5.
Close the eXide editor window and click on the ‘Package Manager’ icon to open the package manager. In the default view all packages are shown, the ones that are already installed and all packages available in the repository. Selecting ‘installed’ shows the packages installed during the eXist-db installation:
6.
Select ‘available’ to show the packages available in the repository. Hovering over a package will show the install icon:
Clicking on the install icon will install the package in the database and remove it from this view.
7.
Install the application packages in the following order:
- Advanced Requirements Tooling
- This is the core application package.
- DECOR core files
- Contains Decor schema, xslt and other core resources.
- DECOR services
- Contains the modules for the Decor REST services.
- ART-DECOR System Services
- Contains resources related to ART-DECOR system services like ADANS (automatic notifier system) and ADRAM (release and release manager).
- Terminology Applications
- Contains the terminology applications and services.
- XIS Test information system (optional)
- Contains applications for testing of HL7 messages and messaging services.
- OID Registry tools (optional)
- Application for maintaining an OID registry, only install if you really need to maintain an OID registry.
8.
Install data packages (all optional). Click on ‘show details’ to view the Name (URI) part for all packages:
There are several types of data packages available:
- DECOR example files
Decor example project files and associated resources.
- Terminology data packages
These packages have: Name (URI): http://art-decor.org/ns/terminology-data/<name>
Terminology data for use by the terminology explorers and ART terminology functions (terminology associations, creating value sets).
- Terminology Data - SNOMED CT Data
Package for creating and maintaining SNOMED CT reference sets. Please note that the full terminology package SNOMED CT data is not supplied from our repository, due to licensing issues. We do supply an empty stub package Terminology Data - SNOMED CT version 14.1.1, but this essentially contains no SNOMED CT, but just serves as an example on how to host this content.
- HL7 XML packages
These packages have: Name (URI): http://art-decor.org/ns/hl7/<name> These packages are named: HL7 - <name> XML packages for message validation and generation.
- Other packages
Click on ‘show details’ to view a description of the content.
9.
Start Tomcat and point your browser to: http://localhost:8080/art-decor/home
10.
Start using the ART-DECOR web application and service. You can log in as admin with the password you provided during the eXist-db installation. Read the documentation online at: documentation