Upgrade Instructions CLIP V7.00

For a new installation, just follow the installation instructions in the “User & Admin Guide”, the following notes do not apply in this case.

Since Clip Version 6.01.00, a new licensing method is used that supports subscription, the former perpetual licenses provided do not work with V6.01 and V7. A new license must be requested, please collect the following information and request the license via email to sales@applink.de :

• Clip Hostname as displayed in the Status window above. Please note that Clip licenses are case sensitive for the Clip Hostname.
• IP Adresse(s) of the system that Clip is installed on.
• Purchase Order ID
• Number and type of licenses you are requesting ( types include permanent productive, permanent Dev/QA, permanent failover and temporary )

An emergency license, valid until March 31st, 2021 is provided here:

<license>qnHSnNWDp3l2fmXMUjL/cBh+NVsrlg4c</license>

Clip version V7 is also a maintenance update for the Clip components Tomcat servlet engine ( version 9 ) as well as the Java Runtime Environment (Adopt Open JDK 11).

Certain configuration files of the previous Tomcat servlet engine as well as the Java Runtime Environment (JRE) installation will be migrated to the new JRE/Tomcat versions:

– the JRE truststore “cacerts”where java stores public certificates of root CA’s. Java uses cacerts to authenticate the servers.

– the JRE keystore “AppLink.jks”

– the Tomcat’s tomcat-users.xml, which is the default user database for authentication in Tomcat.

Please note that if any other modifications to files related to the JRE and Tomcat installation have been performed, these have to be applied manually to the new versions.

Before upgrading, it is highly recommended to stop the Clip service and create a complete archive of the Clip installation directory.

Please follow this procedure for an upgrade to Clip V7 :

• on Windows:
  • run the “ClipSetup” executable as a user with administrative rights, and when prompted for the installation folder, select the existing Clip installation folder ( it contains the Clip folders db, conf, jre…, apache… etc. ).
  • Once installed, the ClipService.bat will perform the upgrade.
  • In order to revert back to the previous Clip version please run the command “[CLIP_HOME]/ClipService.bat legacy” from windows command line with administrator rights
• on Linux:
  • for the Clip RPM package, run the rpm installer with the “upgrade option” instead of the “install option” ( this would result in warnings about conflicting files of the previous version ):   rpm –Uvh Clip-7.00.00-1.x86_64.rpm
  • Once installed, the setup.sh script will perform the upgrade.