wiki:HowToInstallIBIS

IBIS is an enterprise software application. By that I mean it is a scalable application that is centrally managed and has interfaces to other enterprise software (e.g., databases, admin application, statistical analysis software, security directories). This makes installation more complex than for self-contained desktop applications. But here is a brief rundown on the steps that must be accomplished to install a fully-functioning IBIS application.

Before you begin, you may want to...

  1. Visit the IBIS documentation Website to get an overview of the system architecture.
  2. View the Intro.ppt and Overview of IBIS-PH.ppt Powerpoint presentations to get a sense of what IBIS is and how it works.
  3. Review the System Requirements to make sure you have all the pieces in place.

You'll also want to involve your friendly local IT systems guy or gal to help you. His or her experience and knowledge of your IT environment will be essential to the task.

Each of the links in this document leads to more detailed information on how to accomplish a step.

1. Set up your Local Development Environment.

For the most part, this page is presented as a local development environment installation. You'll need to extrapolate to your own server/networking environment.

2. Install the IBIS-View application.

IBIS-View provides all the interface pages. Regardless of whether you want the indicator pages or the query system, you will need the IBIS-View application.

  1. Download the .WAR file from the File Repository
  2. Deploy the View application in your local environment
  3. Review the IBIS-View file structure to get a sense of where things are located.
  4. Create your local look and feel using site-specific CSS and XSLT files (this may be done at any time)

3. Install the IBIS-Query application.

The Query application allows public or authenticated users to create custom queries of public health datasets, such as death and birth certificates and health surveys. You may run IBIS without the query system, and add the query system later, or not at all.

  1. License and install the SAS server application (SAS/Base and SAS/Stat modules)
  2. Install Apache on the SAS server
  3. Put your SAS dataset(s) on the SAS server
  4. Install the back-end IBIS-Q CGI application
  5. Review the IBIS-Query (SAS Server) file structure to get a sense of where things are located.
  6. Configure the IBIS Query-View-SAS-Apache connections
  7. Create your own query modules (see 2.d.)

4. Install the IBIS-Admin application.

The Admin application is a Web-based interface that allows public health professionals (Notice I did not say I.T. Professionals) to maintain their indicator report Web page content. All the page content for the IBIS indicator reports is stored in the IBIS-Admin relational database. The Admin Application consists of JSPs that provide a user-friendly interface to the IBIS-Admin relational database. You can use the IBIS Query system without the IBIS Admin system, and add the Admin system later, or not at all. You will not be able to publish IBIS indicator reports without the Admin application.

  1. Install/setup the SQL database
  2. Create the "ibisph_admin_owner" database account
  3. Create the IBIS-PH Data Admin database tables
  4. Optionally populate the IBIS-PH Data Admin database tables with the Utah data
  5. Install the JDBC drivers for the application server and RDBMS
  6. Install/setup the web app server's JNDI configuration (jdbc/doh_ibisph_admin)
  7. Deploy the application
  8. Configure the application (site specific properties, connections, firewalls, URL of View app, etc.)
  9. For more information, see the Admin installation overview on the IBIS documentation site.

5. Test, Troubleshoot and Tweak.

You'll want to use the IBIS-PH Forum to get help on your installation. There are too many questions to anticipate them all in the documentation (and besides, no one would read it, anyway), and the IBIS-PH Community of Practice has been very helpful with several of our installations.

I'm sure this document is incomplete and inadequate, but hopefully it will give you a sense of what is required.




Back to IBIS HowTo Index

Last modified 14 months ago Last modified on 11/13/17 10:05:42