Setup ( All OSes )

1. Determine installation environment

There are a couple things you must know before you install a patch

  1. Where Journyx is installed.  If you're on our Hosted environment, you cannot install patches.
  2. Who installed Journyx.  "Who" being an account on the machine.  Journyx recommends creating a new local administrator for the installation of Journyx when it is first set up.  If you do not have access to this account you will need to talk with your IT team to get you access to it.  If you don't know what account that is, Journyx Support can help.


2. Collect the needed files.

You will need to have the patch files on the server that your local Journyx installation is running.  You can ask Journyx Support for these files.  It will be either a .zip or a .tar.gz file.  Inside will be a readme and a series of 'install' scripts.


Example:

3. Log in to the server as the user who installed Journyx.

This will depend on your server structure and IT procedures.


4. Consider performing a database backup prior to applying the patch

We don't foresee a patch causing any data problems, but a good recent backup is never needed until it's too late.


5. Consider scheduling down time for the install

Your site will be down for maintenance while you perform these steps.  No one will be able to login at all during the patch install.  Please coordinate with and/or notify your user base to be aware of the temporary outage. We recommend performing the maintenance outside of normal business hours whenever possible.


Installing on Windows

  1. Copy your patch files to the bin directory inside the Journyx install.  The default install location would be C:\Program Files\Journyx\jwt\bin.  This is a configuration point when you install Journyx so may be different.
  2. Unzip the compressed file in place.  You can do this by right clicking on it, and choosing Extract All... and following that to it's completion.
  3. Open the Journyx Command Line Prompt.  This can be found in your Start menu under the Journyx folder.
  4. Change directory in the Journyx Command Line Prompt to be in the folder that was extracted in step 2.
  5. Run install as shown below.  If you are running a custom script instead, follow the directions of the person who sent you the custom script.

  6. This will walk you through installing the patch.  It will ask if you want to make a backup before you apply the patch.  Generally hotfixes, custom code, and updates are fairly safe, but taking a backup is never a bad idea.  Once it completes your patch will be installed.  If it encounters an error, send the error to Journyx Support.

  7. You can then delete the patch install directory and the patch zip file if you want.


Installing on Linux

  1. Copy and extract the zip file to the bin directory inside the Journyx install location.  By default this is in /opt/jtime/pi/bin but can be configured when you install.
  2. Source the 'setup' file by running: . ./setup ( that is dot space dot slash setup )
  3. cd into the patch directory and run ./install and follow it to completion.  If you are running a custom script instead, follow the directions of the person who sent you the custom script.  It will ask if you want to make a backup before you apply the patch.  Generally hotfixes, custom code, and updates are fairly safe, but taking a backup is never a bad idea.  Once it completes your patch will be installed.  If it encounters an error, send the error to Journyx Support.

  4. You can then delete the patch install directory and the patch zip file if you want.

After Install Considerations

If you have multiple application servers set up in a high-availability environment, you will have to apply the patch to all application servers ( all servers that run Journyx, not the database ).