Changes between Version 11 and Version 12 of OpenClinicaUbuntu


Ignore:
Timestamp:
10/13/09 15:55:15 (10 years ago)
Author:
joshuadf
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • OpenClinicaUbuntu

    v11 v12  
    33This "quickstart" guide is a condensed version of the verbose instructions found in the Open``Clinica download at `install-docs/linux/install.txt`. It should allow you to get Open``Clinica installed on a fully updated install of [http://www.ubuntu.com/news/ubuntu-8.04-lts-server Ubuntu 8.04 LTS] in a short amount of time.
    44
    5 OpenClinica(R), OpenClinica Enterprise(TM), and Akaza Research(R)
     5Open``Clinica(R), Open``Clinica Enterprise(TM), and Akaza Research(R)
    66are trademarks of Akaza Research LLC.
    77
    8 The party providing this guide to installing OpenClinica is not a certified partner,
     8The party providing this guide to installing Open``Clinica is not a certified partner,
    99reseller, or affiliate of Akaza Research LLC, and is not certified, approved,
    1010or sponsored by Akaza Research LLC in connection with installation, operation,
    11 maintenance or support of the OpenClinica software platform,
    12 the OpenClinica Enterprise software platform or any other Akaza products.
     11maintenance or support of the Open``Clinica software platform,
     12the Open``Clinica Enterprise software platform or any other Akaza products.
    1313
    1414
     
    1818
    1919Operating systems such as Ubuntu or Red Hat Enterprise Linux supply conveniently packaged software that tracks security updates, so I use it whenever possible.
    20 Unfortunately the packages in RHEL5 are too old to support OpenClinica 3.0, and [https://bugs.launchpad.net/ubuntu/+source/tomcat6 Ubuntu's tomcat6 bugs] are serious as well. The best solution from my perspective is to use Ubuntu with newer PostgreSql and run Tomcat using jsvc, a generic java daemon program. Please note that since we are not using an OS pacakge for Tomcat, '''security updates are YOUR responsibility'''. You probably want to subscribe to the [http://tomcat.apache.org/lists.html#tomcat-announce Apache Tomcat Announce mailing list].
     20Unfortunately the packages in RHEL5 are too old to support Open``Clinica 3.0, and [https://bugs.launchpad.net/ubuntu/+source/tomcat6 Ubuntu's tomcat6 bugs] are serious as well. The best solution from my perspective is to use Ubuntu with newer PostgreSql and run Tomcat using jsvc, a generic java daemon program. Please note that since we are not using an OS package for Tomcat, '''security updates are YOUR responsibility'''. You probably want to subscribe to the [http://tomcat.apache.org/lists.html#tomcat-announce Apache Tomcat Announce mailing list].
    2121
    2222See also OpenclinicaFedora for installation on Fedora.
     
    4040=== 1b. Install tomcat ===
    4141
    42 Next create places for Tomcat and OpenClinica, and download [http://tomcat.apache.org/download-60.cgi the latest Tomcat6].
     42Next create places for Tomcat and Open``Clinica, and download [http://tomcat.apache.org/download-60.cgi the latest Tomcat6].
    4343By default, Tomcat is not configured for encrypted (HTTPS) requests. To add this security, we
    4444can [http://tomcat.apache.org/tomcat-5.5-doc/ssl-howto.html configure Tomcat to serve SSL requests]
    4545by editing `/etc/tomcat/server.xml` to uncomment the SSL `Connector port="8443"` section, and
    46 then creating a keystore with a self-signed certificate for Tomcat as described below.
     46then creating a keystore with a self-signed certificate for Tomcat as described below. You may also
     47want to remote the `Connector port="8080"` section to disable unencrypted logins.
    4748
    4849{{{
     
    7879
    7980
    80 === 1c. Download and extract OpenClinica for Linux ===
     81=== 1c. Download and extract Open``Clinica for Linux ===
    8182
    8283Next [http://www.openclinica.org/register.php Register at OpenClinca.org] and get [http://www.openclinica.org/entities/entity_details.php?eid=535 OpenClinica 3.0.0 (10/13/2009)], or browse for the latest version at the [http://www.openclinica.org/page.php?pid=40 OpenClinica Downloads] website.
     
    8485Upload your OpenClinica-*.tar.gz download to `/usr/local/oc/` on your host with a command like `rsync -vaz OpenClinica-*.tar.gz $LINUX_HOST:/usr/local/oc/`.
    8586
    86 Now, on your host, decompress the download. If you have older versions of OpenClinica you can first move them to an `oldversions/` directory.
     87Now, on your host, decompress the download. If you have older versions of OpenClinica you can first move them to an `oldversions/` directory. Make sure you only have one `/usr/local/oc/OpenClinica-3*` directory or some of the commands below will fail.
    8788{{{
    8889cd /usr/local/oc
    89 tar zxvf OpenClinica-*.tar.gz
     90tar zxvf OpenClinica-3*.tar.gz
    9091}}}
    91 
    92 Make sure you only have one `/usr/local/oc/OpenClinica-*` directory or some of the commands below will fail.
    9392
    9493== 2. Setup software ==
     
    104103  # type a strong password and note it!
    105104  createdb --owner=clinica openclinica
    106   psql -d openclinica -f /usr/local/oc/OpenClinica-*/config/database/PostgreSQL/*/install/create_database_*_tables_with_data.sql
    107105exit
    108106# test the connection from localhost -- type your strong password
     
    112110=== 2b. Tomcat ===
    113111
    114 Below are several small Tomcat configuration changes, bugfixes, and workarounds:
    115 
    116112{{{
    117 # install postgresql JDBC driver per OpenClinica instructions
    118 cp /usr/local/oc/OpenClinica-*/config/libraries/postgresql-8.1-405.jdbc3.jar /usr/local/tomcat/common/lib/
     113cp /usr/local/oc/OpenClinica-3*/distribution/OpenClinica.war /usr/local/tomcat/webapps/
    119114}}}
    120115