Updating

JOSSO 2.5.x is the current version actively developed. It contains all features and fixes provided by JOSSO 2.4.4 through update #58. We still provide support for previous versions, like security and bug fixes.

Applying an update

Updates are normally provided for a specific JOSSO version; for instance updates for JOSSO 2.4.2 will normally not work on a 2.4.1 install. The process of installing an update is always the same, unless specific instructions are provided within the release notes.

You can verify your current update by looking at the product startup screen (in console mode), or by accessing JOSSO’s command line console (SSH) at TCP Port 8101. For instance:

$ ssh -oPort=8101 admin@sso-server

You can look for the Build and Update entries:

  Update                 (004)

  Build                  (2014-12-04 18:20:43)

TIP

It is a common practice to keep a distribution folder with all applied updates on the server where JOSSO is installed. (i.e. /opt/atricore/dist/ or D:\atricore\dist)

Updates are cumulative; this means that the latest update distribution file contains all previous enhancements. The process of applying an update file is always the same. The first step is to get the update file in the server that hosts JOSSO, and follow these steps:

$JOSSO2_HOME refers to the location where JOSSO is installed, for example: /opt/atricore/josso-ee-2.4.1 or D:\atricore josso-ee-2.4.1.

• Verify whether the update requires special install steps

• Get the update file in the server hosting JOSSO

• Stop JOSSO Service

• Backup the following folders form JOSSO2_HOME:

  • server/etc
  • server/data/derby
  • server/lib
  • server/features
  • server/system/com/atricore
  • server/system/org/atricore

tar zcvf ./server/data/derby ./server/lib ./server/features ./server/system/com/atricore ./server/system/org/atricore ./server/etc /opt/atricore/bkp/josso-2.4.1-update-03-bkp.tgz

• Extract the update file in JOSSO2_HOME

tar zxvf /opt/atricore/dist/josso-ee-2.4.1-20190112.103000-update-04.tar.gz

• Delete JOSSO2_HOME/server/data/cache (Only required if JOSSO is running as Windows OS service)

• Start JOSSO Service

TIP

When updating multiple releases in a single step (i.e. from update #1 to update #5), make sure to follow install instructions from all the updates since your last update.

Restoring a previous version

If for any reason a rollback to the previous version is needed, these are the steps to follow:

• Stop JOSSO Service

• Restore the list of folders from the backup created during the update in JOSSO2_HOME

    tar zxf /opt/atricore/bkp/josso-2.4.1-update-03-bkp.tgz

• Delete JOSSO2_HOME/server/data/cache (Only required if JOSSO is running as Windows OS service)

• Start JOSSO