KB: Missing Entry in Property File when Upgrading Transact from 2019.x on Linux

May 2, 2022
|In Install and Upgrade, Linux, SSO
|By Abby Moreland

Applies to: Transact version 2019.x

Affected operating system: Linux

Issue

This issue occurs when upgrading Transact from 2019.x to 2022.1.00 on Linux. When performing the upgrade with a preconfigured single sign-on (SSO) environment, SSO may not work due to a missing entry in a properties file.

Solution

To resolve the above issue, complete the following steps.

  1. Navigate to the [Ephesoft_Directory]/Application/WEB-INF/classes/META-INF folder.
  2. Open the applicationContext-security.xml file in a text editor.
  3. Locate the following lines:

<bean id="epheSamlFilter" class="com.ephesoft.dcma.webapp.SamlFilter">
<constructor-arg index="0" value="FirstName"/>
<constructor-arg index="1" value=""/>
<constructor-arg index="2" value="true"/>

    1. Add the line <constructor-arg index="3" value=""/> as shown below in bold:

<bean id="epheSamlFilter" class="com.ephesoft.dcma.webapp.SamlFilter">
<constructor-arg index="0" value="FirstName"/>
<constructor-arg index="1" value=""/>
<constructor-arg index="2" value="true"/>
<constructor-arg index="3" value=""/>
 </bean>

  1. Save and close the file.
  2. Restart the Transact server.