Release Management
Space shortcuts
Space Tools

Versions Compared

Old Version 8

changes.mady.by.user Janice Donahoe

Saved on

compared with

New Version 9

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

 

 

 

Stop JBoss 

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\ 

 

 

Steps

  • Stop JBoss

     

  • Backup your existing i2b2.war directory

    UI Text Box
    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 Text Box
    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 directory

    ui-
    text-boxThe upgrade zip file contains the following files:
    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/

    Ontology

    FR-core.jar
    deployments/i2b2.war/WEB-INF/lib/

    ProjectManagement

    i2b2Common-core.jar
    deployments/i2b2.war/WEB-INF/lib/

    Workplace

    IM-core.jar
    deployments/i2b2.war/WEB-INF/lib/

    i2b2Common

    Ontology-core.jar
    deployments/i2b2.war/WEB-INF/lib/

    FR

    ProjectManagement-core.jar
    deployments/i2b2.war/WEB-INF/lib/

    IM

    Workplace-core.jar
    deployments/i2b2.war/WEB-INF/services/
    deployments/i2b2.war/WEB-INF/services/CRC.aar
    deployments/i2b2.war/WEB-INF/services/

    IM

    FR.aar
    deployments/i2b2.war/WEB-INF/services/

    FR

    IM.aar
    deployments/i2b2.war/WEB-INF/services/

    Ontology

    ProjectManagement.aar
    deployments/i2b2.war/WEB-INF/services/

    ProjectManagement

    Ontology.aar
    deployments/i2b2.war/WEB-INF/services/Workplace.aar

    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.