The following steps will walk you through the deployment process. The commands on a Windows Server may differ slightly on a Unix Machine.
This difference will be noted when appropriate.
Note
During the configuration process the working directory was already changed to the edu.harvard.i2b2.server-common folder. If you did not change it then you can skip step 1 and go directly to the second step of deployment. If you did change it then you will need to change it back by following the steps outlined below.
Step 1: Change working directory
The first step in the cell configuration process is to change your working directory to the location of your edu.harvard.i2b2.pm folder.
Change Directory Command CD YOUR_I2B2_SRC_DIR\edu.harvard.i2b2.server-common
Important
The change directory command shown above is written for Windows. The command itself is the same for both Linux and Windows with the only exceptions being the slashes in the path name and Linux does not include the "drive".
Linux Path: use a forward slash.
Windows Path: use a backward slash.
EXAMPLES:
Linux Command: CD /opt/i2b2/edu.harvard.i2b2.server-common Windows Command: CD C:\opt\i2b2\edu.harvard.i2b2.server-common
Step 2: Deploy edu.harvard.i2b2.server-common
The second and final step in the deployment process is to run the Ant script to deploy edu.harvard.i2b2.server-common.
Select the command line that is appropriate for your environment.
Linux Run Command ant clean dist deploy jboss_pre_deployment_setup
Run Command
%ANT_HOME%\bin\ant.bat clean dist deploy jboss_pre_deployment_setup
Note
If the command %ANT_HOME% does not work it may be because you did not set your environment variables as suggested in the Requirements Chapter. If you do not wish to set this variable then you will need to replace %ANT_HOME% with the full path to your Ant directory.
Provided there were no problems running the script you will see Build Successful when the script finishes and the edu.harvard.i2b2.server-common has been deployed.
4.6 Next Steps
Steps Completed
The following steps were completed during this chapter on installing i2b2 server-common.
i2b2 Server-common Installation Chapter
Extracted the i2b2 source code to a directory of your choice (YOUR_I2B2_SRC_DIR) Stopped JBoss Services
Deployed edu.harvard.i2b2.server-common
Note
Normally we restart JBoss services between installations so we can verify a cell was deployed correctly. In this chapter we intentionally omitted this step because we did not deploy a cell so there are no services to check.
If you are not continuing with the rest of the installation at this time you may want to restart your JBoss services if they are needed for other applications in your environment. Steps on how to do this can be found in any of the cell installation chapters in the section called Start Services
Next Steps
After completing this chapter on installing the i2b2 server-common you are now ready to begin installing the i2b2 core cells. Each cell installation has its own chapter that will walk you through the installation process.
For the most part the order in which the cells are installed does not matter. There are a couple of exceptions:
1. The PM Cell has to be installed before any other cells.
2. The i2b2 Administration Module has to be installed after the PM Cell before any other cells.
At this point in the installation process your next step is to proceed to the Install Project Management (PM) Cell chapter where the steps for installing the PM Cell are defined.
Chapter 5. Project Management (PM) Cell Install
Information in the Project Management cell is related to the setup and maintenance of the hive, projects, users and security. The PM Cell needs to be installed prior to the other i2b2 Core cells.
Chapter 5. Table of Contents
5.1 Prerequisites
5.2 PM Installation Overview
5.2.1 Source Code and Directory Structure 5.3 Stop Services
5.4 Configuration
5.4.1 Configure the PM Build Properties 5.4.2 Data Source Configuration 5.5 Deployment
5.6 Start Services
5.7 Verify PM Installation
5.8 Next Steps
5.1 Prerequisites
The following installations must be completed prior to beginning the process of installing the Project Management (PM) Cell.
Requirements Chapter
Installed a Database Management System (Oracle, PostgreSQL or SQL Server) Installed Java, JBoss, Apache Ant and Apache Axis2
Downloaded the i2b2 Software
Data Installation Chapter
Created database user accounts for i2b2 schemas
Created all the data tables (Crcdata, Hivedata, Imdata, Metadata, Pmdata and Workdata) Created the stored procedures for the Crcdata tables and the triggers for the Pmdata tables Loaded data into all the tables (Crcdata, Hivedata, Imdata, Metadata, Pmdata and Workdata)
i2b2 Server-common Install Chapter
Extracted all the i2b2 source code to a directory a directory of your choice (YOUR_I2B2_SRC_DIR) Configured Server-common properties
Deployed edu.harvard.i2b2.server-common
5.2 PM Installation Overview
Installation Overview
In this chapter we will be installing the Project Management (PM) Cell.
Important
The PM Cell has to be deployed before any other i2b2 cells are deployed.
Order of Installation
The basic steps that will be taken during this installation are as follows:
Step 1: Stop services (JBoss) Step 2: Edit PM configuration files Step 3: Deploy the PM Cell Step 4: Start services (JBoss) Step 5: Verify installation
Important
The details of what is to be done for each step are defined in the different sections within this chapter. It is important to follow steps in the order they are defined and not to skip any of them unless otherwise noted.