Open Immunization Software - Spring 2016

Data Quality

Open Source Projects

Installation for MySQL

The DQA is designed to be most easily installed on MySQL. Installations on other databases such as Oracle and PostGres are supported and can be accomplished by a technical team. These instructions are only for those installing the simpliest version on an MySQL database.

Please Note: These instructions assume that you are generally comfortable with installing your own software, have some experience working with databases, and have admnistrative rights to your system. If one or both of these do not apply you will want to ask for assistance from other team members or your information systems department to help you with this process.

Install MySQL

MySQL is available as a free community download. This will work well for local and small installations. (Please note that these directions are subject to change. MySQL may change their download and installation process at any time with no notice to this project. )

  1. Navigate to http://www.mysql.com/.
  2. Select Downloads.
  3. Scroll to the bottom section titled "MySQL Community Edition (GPL)" and select Community (GPL) Downloads.
  4. Select Download under the MySQL Community Server section.
  5. Follow the installation instructions for your operating system.

For more information or help with MySQL downloads, please follow the links and help documents given on the MySQL page. Installation of MySQL is straightforward and standard/default options should be selected.

Once MySQL is installed you will need to decide on which type of client to use to access it for administrative purposes. Here are your choices:

Once you have MySQL installed you should ensure the following:

Setup Database

Now that MySQL is installed and you have access to your new database, it is time to install the DQA specific database that the DQA will need to do its work. This database will also hold the data imported in which you can directly access by connecting to the database using your favorite MySQL client.

These instructions require that you connect to your database using your client. The examples given will be shown on the MySQL Command-Line Tool. Instructions for other clients will vary from these instructions.

The MySQL database scripts can be found at https://svn.code.sf.net/p/ois-dqa/code/database/mysql/trunk/ . For this installation you will need the following files:

Download, modify and then run each of these scripts:

  1. Download the two scripts to your local system.
  2. Open the create-user.sql script in a text editor, such as Notepad, and modify the changme password to a secure password that you will remember. This is the username and password you will give to access the DQA when it is running.
  3. Run the create-user.sql script and verify there are no errors.
  4. Open the initial-v1.08.sql script and modify line 44 to indicate the user information for the admin user. Change dqa_admin to a user name of your choosing, change_this_password to a secure password, and set_this_email@email.com to your email address.
  5. Run the initial-v1.08.sql script and verify there are no errors.

Note: To run a script into MySQL you can use a command like this:
mysql -uroot -ppassword < script.sql
Make sure root and password are replaced with the username and password you created when installing MySQL and the file name script.sql is replaced with the name of the file you want to import. The -u and -p should remain on front of the username and password.

Install Java

Installation instructions for java are maintained by Oracle and can be found here: How do I install Java?. Install the default or latest version pointed to by this site.

Install Tomcat

Installation instructions for Tomcat are maintained by the Apache Software Foundation here: Installation. Install the Tomcat version 7 or later.

Once Tomcat is installed it would normally be configured to run automatically in the services panel, if running on a Windows system. Ensure that Tomcat is up and running before downloading the DQA. You can confirm that Tomcat is running by visiting localhost:8080.

Download DQA

In this last step everything comes together for a working system. You should have Tomcat and MySQL up and running.

  1. Download the software application from the DQA Download site. Note: you will need to enter the URL, username and password to download the software. The URL will probably be: jdbc:mysql://localhost/dqa, if the database and Tomcat are installed on the same system. The username and password were set by you in the Setup Database stage. Setting these values here allows the downloading software to your database connection parameters in the DQA version you get.
  2. Save the dqa.war file into the Tomcat/webapps directory. In a windows system this can be found here: C:\Program Files\Apache Software Foundation\Tomcat 7.0\webapps
  3. Confirm that after a few seconds Tomcat has created a Tomcat/webapps/dqa directory to match the dqa.war file that you just copied in. This indicates that Tomcat is running and was able to unpack the DQA application and deploy it.
  4. Login to the DQA via your web browser . You will use the password you setup in the Setup Database stage.

Configure the DQA

Once you have successfully logged in you will want to configure the DQA to start working for you.

Configuration