Skip to main content
Kinetic Community

Upgrade Guide

 

Introduction

 

Kinetic Calendar 1.5.3 is purely a bug fix release for v1.5.2.  No features or enhancements have been added in this release.

 

Upgrade Instructions

 

This upgrade document is for users of Kinetic Calendar 1.5.2.

If your version is less than 1.5.2, please follow the upgrade documents of the previous versions to upgrade the Remedy portion of the application up to 1.5.2.  The web application does not need to be updated for each version as it will be overwritten again with this upgrade.

The upgrade should be performed by a Remedy Administrator.

 

  1. Verify your version of Kinetic Calendar is 1.5.2.
    1. Login to Remedy using the Remedy User tool
    2. Click the ‘Kinetic Calendar Console’ link from the home page
    3. Click the ‘Configuration’ link on the left hand side of the dialog window.
    4. The Kinetic Calendar version will be in the upper-right hand corner of the Configuration Manager dialog window.
    5. If Kinetic Calendar is at version 1.5.2, you may proceed with the instructions below.  If your calendar version is less than 1.5.2, please contact Kinetic Data support to obtain all the previous update packages.
  2. Import Remedy Workflow
    1. Using the appropriate application for your environment (Remedy Admin Tool or Developer Studio), import in-place the def file that came with the upgrade package:
      1. ​ARS\KineticCalendar_v01.05.02_to_v01.05.03.def
    2. Be sure to select the ‘Replace Objects on the Destination Server’ option.
  3. Update Web Server Files
    1. Before you begin with this step, stop all of your servlet container servers (such as Tomcat or ServletExec) that are used for Kinetic Calendar.
    2. On each of your web servers, the KinCal webapp directory must be updated.  The easiest way to do this is to remove the existing application, and install the new web application.
    3. Move the “KinCal” webapp directory on each of your web servers to a backup location outside of the web server applications directory.  For tomcat, the applications directory is <tomcat_home>/webapps/.  If you copied the directory instead of moved it, please delete the existing KinCal web application directory at this time.
    4. Determine what version of the web application you will run for your environment.  Kinetic Calendar now comes with support for the 6.0 – 7.0 style API for Remedy 6.x servers, and support for the pure Java style API for Remedy 7.x servers.
      1. ​6.3 servers – use the web application found in the Web/RemedyAPI_6.x directory of the upgrade package.
      2. 7.0+ servers – use the web application found in the Web/RemedyAPI_7.x directory of the upgrade package.
    5. ​Copy the KinCal directory from the appropriate web directory you determined in step ‘d’ above to your web server’s web applications directory.  The files are in the default directory structure, so they can be moved en-masse.
    6. Configure the KinCal/WEB-INF/classes/KinCal.xml file to connect with your Remedy server.  The following parameters listed below can be copied from the /WEB-INF/KinCal.xml file in your backup directory.
      1. ​LogLevel
      2. LogSubLevel
      3. UseEncryption
      4. EncryptionSeed
      5. RemedyServer
      6. RemedyUser
      7. RemedyPassword
      8. RemedyPort
      9. RemedyRpc
      10. RemedyAuth
      11. AuthenticationAdapter
      12. AuthenticationAdapterProperties
    7. Check your backup for any custom output pages.  These files would be located in the /KinCal/resources/ directory.  If you have any other than ‘helloWorld.jsp’, copy these to the new /KinCal/resources/ directory at this time.
    8. Restore any other customizations you made to the application, such as stylesheets, images, etc…
    9. Restart your servlet container service.
    10. Repeat these steps for each web server used.
  4. Flush your web server’s compiled JSP store.
    1. This example is for a Tomcat web server, and the exact procedure will vary with different web servers.
      1. ​Navigate to the <tomcat>/work/Catalina/localhost directory.
      2. Delete the KinCal directory.  This directory will be recreated when a user connects to Kinetic Calendar.
      3. Repeat these steps for each web server used.