Release Management
Space shortcuts
Space Tools

Versions Compared

Old Version 9

changes.mady.by.user Janice Donahoe

Saved on

compared with

New Version 10

changes.mady.by.user Janice Donahoe

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Anchor
i2b2-upgrade-v1709c-info
i2b2-upgrade-v1709c-info

Version Information

Current Version:1.7.09c
Release Date:December 6, 2017
License:i2b2 Open Source License

Anchor
i2b2-upgrade-v1709c-download
i2b2-upgrade-v1709c-download

Download

Descriptioni2b2 Released VersionMinimum Version RequiredDownload LinkRequirements
Files to upgrade the i2b2 server to 1.7.09c.1.7.09c1.7.05 i2b2upgrade-1705-to-1709c.zipSee Technical Details section on the i2b2 Upgrades page.

Anchor
i2b2-upgrade-v1709c-howTo
i2b2-upgrade-v1709c-howTo

Upgrade Instructions

Excerpt Include
i2b2 Upgrades
i2b2 Upgrades

 

Knowing some sites have remained on JBoss 7 and some have upgraded to WildFly 10, we have gone ahead and provided Step-by-Step Instructions for both scenarios. For the most part the overall process is very similar. What is different, is the path in which the files reside. See examples shown below.

Generic Box
box-typeexample
show-iconfalse

JBoss 7 path to i2b2.war

 

Code Block
languagepowershell
/opt/jboss-as-7.1.1.Final/standalone/deployments/i2b2.war/

 

WildFly 10 path to i2b2.war

Code Block
languagepowershell
/opt/wildfly-10.0.0.Final/standalone/deployments/i2b2.war/

Anchor
i2b2-upgrade-v1709c-stepByStep-JBoss
i2b2-upgrade-v1709c-stepByStep-JBoss

Step-by-Step Instructions for JBoss

UI Steps
sizesmall
UI Step

Stop JBoss

Code Block
languagepowershell
titleLinux Example
collapsetrue
$ /opt/jboss-as-7.1.1.Final/bin/jboss-cli.sh --connect command=:shutdown
UI Step

Backup your existing i2b2.war directory

UI Expand
titleLinux

On Linux, make a copy of /opt/jboss-as-7.1.1.Final/standalone/deployments/i2b2.war/ and save it to a different location outside of /opt/jboss-as-7.1.1.Final/ 

UI Expand
titleWindows

On Windows, make a copy of c:\opt\jboss-as-7.1.1.Final\standalone\deployments\i2b2.war\ and save it to a different location outside of c:\opt\jboss-as-7.1.1.Final\ 

UI Step

Delete i2b2.war.deployed file

Code Block
languagepowershell
titleLinux Example
collapsetrue
$ rm /opt/jboss-as-7.1.1.Final/standalone/deployments/i2b2.war.deployed
UI Step

Extract / copy the files from the upgrade zip file to your JBoss deployments a local directory

UI Expand
titleContents of Zip File

i2b2 Upgrade Instructions for 1.7.05+ to 1.7.09c.pdf

configuration/
configuration/crcapp/
configuration/crcapp/crc.properties-1709

deployments/
deployments/i2b2.war.dodeploy
deployments/i2b2.war/
deployments/i2b2.war/WEB-INF/
deployments/i2b2.war/WEB-INF/lib/
deployments/i2b2.war/WEB-INF/lib/CRC-core.jar
deployments/i2b2.war/WEB-INF/lib/FR-core.jar
deployments/i2b2.war/WEB-INF/lib/i2b2Common-core.jar
deployments/i2b2.war/WEB-INF/lib/IM-core.jar
deployments/i2b2.war/WEB-INF/lib/Ontology-core.jar
deployments/i2b2.war/WEB-INF/lib/ProjectManagement-core.jar
deployments/i2b2.war/WEB-INF/lib/Workplace-core.jar
deployments/i2b2.war/WEB-INF/services/
deployments/i2b2.war/WEB-INF/services/CRC.aar
deployments/i2b2.war/WEB-INF/services/FR.aar
deployments/i2b2.war/WEB-INF/services/IM.aar
deployments/i2b2.war/WEB-INF/services/ProjectManagement.aar
deployments/i2b2.war/WEB-INF/services/Ontology.aar
deployments/i2b2.war/WEB-INF/services/Workplace.aar

UI Step

Copy the deployments directory you extracted from the zip file to your JBoss standalone directory, replacing any existing files when prompted.

Code Block
languagepowershell
titleLinux Example
collapsetrue
$ cp -r deployments /opt/jboss-as-7.1.1.Final/standalone
UI Step

Modify the crc.properties

 

UI Step

Start JBoss

Code Block
languagepowershell
titleLinux Example
collapsetrue
$ /opt/jboss-as-7.1.1.Final/bin/standalone.sh -b 0.0.0.0 &
UI Step

Verify your upgrade

UI Expand
expandedtrue
titleTest Web Client

Navigate to your local i2b2 Web Client in your preferred browser and verify you are able to log on and perform standard i2b2 functions. (e.g. Run queries, retrieve previous queries, view breakdowns, etc.)

 

 


 

Anchor
i2b2-upgrade-v1709c-stepByStep-WildFly
i2b2-upgrade-v1709c-stepByStep-WildFly

Step-by-Step Instructions for WildFly

Steps

  1. Stop WidlFly

    Code Block
    languagepowershell
    titleLinux Example
    collapsetrue
    $ /opt/wildfly-10.0.0.Final/bin/jboss-cli.sh --connect command=:shutdown

  2. Backup your existing i2b2.war directory

    UI Text Box
    On Linux, make a copy of /opt/wildfly-10.0.0.Final/standalone/deployments/i2b2.war/ and save it to a different location outside of /opt/jboss-as-7.1.1.Final/
    UI Text Box
    On Windows, make a copy of c:\opt\wildfly-10.0.0.Final\standalone\deployments\i2b2.war\ and save it to a different location outside of c:\opt\jboss-as-7.1.1.Final\ 

  3. Delete i2b2.war.deployed file

    Code Block
    languagepowershell
    titleLinux Example
    collapsetrue
    $ rm /opt/wildfly-10.0.0.Final/standalone/deployments/i2b2.war.deployed

  4. Extract / copy the files from the upgrade zip file to your WildFly deployments directory

    UI Text Box
    The upgrade zip file contains the following files: i2b2 Upgrade Instructions for 1.7.05+ to 1.7.09c.pdf deployments/ deployments/i2b2.war.dodeploy deployments/i2b2.war/ deployments/i2b2.war/WEB-INF/
    deployments/i2b2.war/WEB-INF/lib/
    deployments/i2b2.war/WEB-INF/lib/CRC-core.jar
    deployments/i2b2.war/WEB-INF/lib/Ontology-core.jar
    deployments/i2b2.war/WEB-INF/lib/ProjectManagement-core.jar
    deployments/i2b2.war/WEB-INF/lib/Workplace-core.jar
    deployments/i2b2.war/WEB-INF/lib/i2b2Common-core.jar
    deployments/i2b2.war/WEB-INF/lib/FR-core.jar
    deployments/i2b2.war/WEB-INF/lib/IM-core.jar
    deployments/i2b2.war/WEB-INF/services/
    deployments/i2b2.war/WEB-INF/services/CRC.aar
    deployments/i2b2.war/WEB-INF/services/IM.aar
    deployments/i2b2.war/WEB-INF/services/FR.aar
    deployments/i2b2.war/WEB-INF/services/Ontology.aar
    deployments/i2b2.war/WEB-INF/services/ProjectManagement.aar
    deployments/i2b2.war/WEB-INF/services/Workplace.aar

  5. Start WildFly

    Code Block
    languagepowershell
    titleLinux Example
    collapsetrue
    $ /opt/wildfly-10.0.0.Final/bin/standalone.sh -b 0.0.0.0 &
  6. Verify your upgrade

Navigate to your local i2b2 Web Client in your preferred browser and verify you are able to log on and perform standard i2b2 functions. (e.g. Run queries, retrieve previous queries, view breakdowns, etc.)

 

 

Anchor
i2b2-upgrade-v1709c-note
i2b2-upgrade-v1709c-note

Notes

  • Release 1.7.09c does contain changes to the i2b2 Web Client. Therefore you will need to download the i2b2webclient-1709c.zip file from the i2b2.org/software website. You will also need to update the i2b2 Admin on the i2b2 Server.