Skip to main content
Skip table of contents

Upgrade with LUY Installer Wizard

This guide provides instructions to upgrade LUY from release 7.3 to release 7.4.

For previous versions, please follow the appropriate LUY upgrade guides in order to upgrade to LUY 7.3 first.
Check the Installation prerequisites before starting. We strongly recommend creating a complete backup of your entire LUY database and the application files.

In the scope of this guide, it is assumed that LUY is deployed on an Apache Tomcat web server. The Tomcat installation directory is hereafter referred to as $TOMCAT_HOME, regardless of the underlying operating system. Furthermore, it is assumed that the LUY application is deployed under $TOMCAT_HOME/webapps/luy. If you have deployed the application under a different name, replace luy in the provided path as appropriate.

The Java Runtime Environment (JRE) or Java Developlent Kit (JDK) installation directory is denoted as $JAVA_HOME.

This guide uses Unix conventions for path names. For Windows, replace slashes (/) with back-slashes (\) and include drive letters where necessary.

Upgrade

The update of the database structure is carried out automatically with the first start of Tomcat.

Preparation

Before LUY 7.4 is set up, shut down LUY or the entire Tomcat instance. The previous installation of LUY should be completely undeployed from the Tomcat instance. In particular, the following files and directories should be deleted from the Tomcat installation directory:

$TOMCAT_HOME/webapps/luy.war
$TOMCAT_HOME/webapps/luy

If an old LUY installation is deployed simultaneously with LUY 7.4, unexpected side effects may occur due to competing database and file access.

Launch LUY installer

Run the installer by launching the luyInstaller.jar file and follow the instructions. Depending on your system configuration, double-clicking the jar file might not work. If this is the case, the file can be launched from the command line by executing

java jar luyInstaller.jar

or by explicitly stating the JRE to use:

$JAVA_HOME/bin/java jar luyInstaller.jar

Enter database connection parameters

During the installation process, the installer will request you to provide database connection parameters. The parameters to use are the same as the ones used for the installation of previous versions of LUY.

If you are not sure about your parameters, you can look up the settings in the following two files of your old version’s backup:
$TOMCATBACKUP/webapps/luy/WEB‑INF/classes/luy‑db.properties for the LUY database and $TOMCATBACKUP/webapps/luy/META-INF/contex.xml for the iTURM database with authentication information.

Empty the search index directory

If you intend to use the search index directory of your previous installation of LUY, remove all files and subdirectories, as LUY will not be able to start up if the old indexes are still present. The location of the search index is denoted by the property hibernate.search.index in the config file $TOMCAT_HOME/webapps/luy/WEB-INF/classes/luy.properties.

Empty Tomcat’s temporary work directory

Tomcat’s temporary work directory contains files of a previously installed version of LUY, even after installing the new version. This might cause problems. Therefore, delete the following folder:

$TOMCAT_HOME/work/Catalina/localhost/[luy]

Deploy LUY

After LUY 7.4 has been successfully configured by the installer, the generated WAR-file should be copied into the Tomcat webapps directory ($TOMCAT_HOME/webapps). Start the Tomcat to deploy LUY 7.4. Furthermore, the database structure will be migrated from 7.3 to the new release version.

Any customizations made to your previous LUY version need to be transferred over to the new properties files in $TOMCAT_HOME/webapps/luy/WEB-INF/classes/ folder.

Copy graphics reactor content

The LUY graphics reactor stores all input and output files in the file system. Copy the content of $TOMCAT_BACKUP/webapps/luy/WEB-INF/classes/reactor from the backup to the corresponding directory in the new installation. 

Transfer LDAP authentication settings

If LUY was installed with LDAP authentication enabled, copy the parameters from the luy-auth.properties file in your old installation’s backup to the $TOMCAT_HOME/webapps/luy/WEB-INF/classes/luy-auh.properties file.

Transfer SAML2 authentication settings

If LUY was installed with SAML2 authentication enabled, copy the keystore file from the folder security in the old installation’s backup into the folder $TOMCAT_HOME/webapps/luy/WEB-INF/classes/security directory. Afterwards transfer the parameters of luy-auth.properties from your old installation’s backup into the file $TOMCAT_HOME/webapps/luy/WEB-INF/classes/luy-auth.properties.

Final restart

As a last step, restart Tomcat to make sure that any modifications to the LUY configuration become active.

Users should clear their local browser cache and re-log in to LUY.

Initialize the search index

Once Tomcat is successfully started, log in to LUY with administrative rights.

To utilize the full-text search functionality, the search index needs to be re-built. This can be done via the system settings page:

Go to Administration -> System and click the "recreate index" button.

The initial run may take several minutes.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.