Skip to main content
Kinetic Community

v05.01.00

Use the below links and instructions to dowload and install/update Kinetic Request/Survey to version 5.1.0. Note: Kinetic Request and Kinetic Survey use the same files and follow the same installation/upgrade procedure.  The information provided below applies to both applications.

Requirements

Remedy AR Server v6.0.3 or greater
Web Application Server

Java Servlet Container (Servlet spec 2.4, JSP spec 2.0)

  • Examples
    • Tomcat 5.5+

    • WebSphere 6.1+ 

    • WebLogic 9.0+

Java 32-bit Java 1.5.0 or greater - MUST be 32-bit
Architecture Click for Architecture Requirements
 

Installation

For a new install, download the full installation package.  The zip file contains a Windows executable that can be used to automate the process.  If you do not have access to a Windows machine with the ability to connect to your Remedy server, the zip file also contains the Remedy definition files, Remedy data files, and web application files necessary for a manual installation. 

For complete installation instructions, see the Kinetic Request Installation Guide.

 

Upgrade

The 5.1.0 upgrade requires that Kinetic Request is currently at version 5.0.3.  If you are on a version prior to 5.0.3, see the appropriate sections below for instructions on how to upgrade your system to 5.0.3 before continuing.

Upgrading from version 5.0.3.

NOTE: If installing into a 7.6 or greater version of Remedy, you MUST set to Base Development mode using BMC Developer Studio.

  1. Download and unzip the upgrade package from here.

Remedy Workflow, Data and Templates

  1. Use a Remedy Administrator or BMC Developer Studio tool to import the ARS def files (found in Remedy/Definitions directory) in the order that they are listed here.  The import options for each file are listed in parenthesis after the file name:
    • KS_SurveyRequest_RegularForms.def - (replace existing objects and replace conflicting types)
    • KS_SurveyRequest_JoinForms.def - (replace existing objects and replace conflicting types)
    • KS_SurveyRequest_DisplayForms.def - (replace existing objects, delete excess fields, delete excess views, and replace conflicting types)
    • KS_SurveyRequest_Workflow.def - (replace existing objects)
    • KS_SurveyRequest_Flashboards.def - (replace existing objects)
  2. Use a Remedy Administrator or BMC Data Import tool to import the ARS data files (found in the Remedy/data directory).  Each file imports into a form of the same name.
    • Group.arx
    • KS_ACC_Menu.arx
    • KS_ACC_MessageText.arx
    • KS_ATT_AttributeType.arx
    • KS_BRG_MessageText.arx
    • KS_SRV_ClientSideEvent.arx
    • KS_SRV_DataSet_Question_Union.arx
  3. Import the Submission Lock Manger template using the Web Admin Console (file found in Remedy/Templates)
    • Request_SubmissionLockManager.zip

Web Application

Requirements:

  • 32-bit JDK (v5+)
  • Apache Tomcat (v5.5+)

Recommendations:

  • The location of the Remedy C API v7.0.1 files must be added to the system PATH environment variable.  These files are provided in the Web/lib/Ars701Api directory of this package in case they are not already installed on the web server.
  • It is recommended to use a separate Tomcat container for each main web application (Kinetic SR, and Kinetic Task), and another Tomcat container for all the bridge application.  This makes it easier to deploy and maintain each web application.
  • If a single Tomcat container must be used, then care must be taken to ensure the Remedy Java API library files (arapi70.jar, arutil70.jar) are in a shared classpath location.  The shared classpath location for Tomcat 5.5 is the <tomcat>/shared/lib directory, and for Tomcat 6 and Tomcat 7 the shared classpath location is the <tomcat>/lib directory.

Installation:

  1. Ensure the Remedy C Api v7.0.1 files are installed on the web server, and ensure this directory has been added to the system environment PATH variable.
  2. Kinetic Request:
    1. BACKUP your existing kinetic directory located at <tomcat>/webapps/kinetic.
    2. Copy the Web/apps/kinetic.war file to the <tomcat>/webapps directory of the Tomcat server that will be running Kinetic Request.
    3. Restart Tomcat and the web application should automatically deploy over the top of the existing files.  In some instances the application will not automatically deploy over the top of an existing application with the same name.  In these cases you will need to stop Tomcat, delete your existing kinetic directory (make sure it has been backed up) and then restart Tomcat.
    4. Log into the Admin Console and configure the properties.  The default web admin account is admin/admin http://webserver:port/kinetic/AdminConsole.
    5. Copy any custom themes or resources from your backup file into the respective locations inside the new kinetic directory.
  3. Kinetic ARS Bridge (If you need to connect to a different ARS server):
    1. Stop the Tomcat service if running.
    2. Copy the Web/apps/kineticArsBridge.war file to the <tomcat>/webapps directory of the Tomcat server that will be running the Bridge.
    3. Restart Tomcat and the web application will automatically deploy.
    4. Log into the Admin Console and configure the properties.  The default bridge admin account is admin/admin.  The Admin Console's address will be like http://<webserver>:<port>/kineticArsBridge/AdminConsole
  4. Other bridges - You can obtain other bridges from the Kinetic Community website located at http://community.kineticdata.com.  Use the same method for installing them as you did in step 3 above.

Hot Fixes

Hot fixes are released to provide solutions to bug that need to be addressed before an entire application upgrade is ready to be released.  Usually hotfixes are cumulative and contain only the files that have changed since the last complete build.

 

v5.1.0 HotFix 1

Released March 1, 2013

Resolves an issue where query parameters were being double encoded when passing through the timezone offset filter.

 

v5.1.0 HotFix 2

Released April 12, 2013

Resolves an issue where attachments links failed to download an attachment of a previously submitted answer.

 

v5.1.0 HotFix 3

Released April 30, 2013

Resolves an issue where answers were being mapped for approval submissions.

 

v5.1.0 HotFix 4

Released May 30, 2013

Resolves a regression where the field map and answer map values were being set to a blank string instead
of null for unanswered questions.

 

v5.1.0 HotFix 5

Released July 5, 2013

Respect the full answer field limit instead of hard-coding the limit to 4000 bytes.

 

v5.1.0 HotFix 6

Released July 15, 2013

Review Request ensures pages are returned in the correct sort order.

 

v5.1.0 HotFix 7

Released September 6, 2013

Fixes a NPE that sometimes occurs when submitting pages with a checkbox question, and then immediately display in Review Request.

Fixes a possible XSS issue when injecting script into certain parameter values.

 

v5.1.0 HotFix 8

Released August 28, 2014

Additonal instrumented logging.

 

 

v5.1.0 HotFix 9

Released October 21, 2015

Fixes a bug that allows arbitrary script to be executed in multi-line text question.