Product

Remedy AR System Server

Component

Single Sign On

Applies to

RSSO, AR Server, Mid Tier, SmartIT, Digital Workplace

Question

How do I temporarily disable, then re-enable RSSO, without having to completely uninstall and reinstall.

Answer

This knowledge article may contain information that does not apply to version 21.05 or later which runs in a container environment. Please refer to Article Number 000385088 for more information about troubleshooting BMC products in containers.

Backup Files
First, create a backup of the config.properties and web.xml in the following directories

Windows:

C:\Program Files\BMC Software\ARSystem\midtier\WEB-INF\classes\config.properties
C:\Program Files\BMC Software\ARSystem\midtier\WEB-INF\web.xml

Linux

/opt/bmc/ARSystem/midtier/WEB-INF/classes/config.properties
/opt/bmc/ARSystem/midtier/WEB-INF/web.xml

If you experience errors with RSSO after carrying out these steps, restore the 2 backed up files.

Disabling RSSO for AR Server and Mid Tier

Open the config.properties in a text editor
- Windows:
  - C:\Program Files\BMC Software\ARSystem\midtier\WEB-INF\classes\config.properties
- Linux
  - /opt/bmc/ARSystem/midtier/WEB-INF/classes/config.properties
Locate the following line

arsystem.authenticator=com.bmc.rsso.plugin.authenticator.RSSOAuthenticator

Update the line to read as follows

arsystem.authenticator=com.remedy.arsys.session.DefaultAuthenticator

save the file
open web.xml in a text editor
- Windows:
  - C:\Program Files\BMC Software\ARSystem\midtier\WEB-INF\web.xml
- Linux
  - /opt/bmc/ARSystem/midtier/WEB-INF/web.xml
locate the following Xml

<filter>
    <filter-name>RSSOFilter</filter-name>
    <filter-class>com.bmc.rsso.agent.RSSOFilter</filter-class>
</filter>

update the Xml as follows to comment it out, by surrounding the Xml fragment with

<!--<filter>
    <filter-name>RSSOFilter</filter-name>
    <filter-class>com.bmc.rsso.agent.RSSOFilter</filter-class>
</filter>-->

locate the following Xml

<filter-mapping>
    <filter-name>RSSOFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

update the Xml as follows to comment it out, by surrounding the Xml fragment with

<!--<filter-mapping>
    <filter-name>RSSOFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>-->

save the file

Disabling RSSO for SmartIT and Digital Workplace

execute the following SQL statement against the SmartIT database:

UPDATE SmartIT_System.TENANT SET SAML_AUTHENTICATION = 0;

execute the following SQL statement against the Digital Workplace database:

UPDATE DWP_System.TENANT SET SAML_AUTHENTICATION = 0;

Restart DWP and Smart IT Tomcat service. To re enable, set value back to 1 and restart tomcat.

Disabling RSSO for DWP Catalog

Remove the rsso-agent-osgi.jar from <DWPC Install directory>/deploy and restart the server.

Re-enabling RSSO

If you have previously disabled RSSO using the steps outlined in this Knowledge Article, use the following steps to re-enable RSSO.

Enabling RSSO for AR Server and Mid Tier

open the config.properties in a text editor
- Windows:
  - C:\Program Files\BMC Software\ARSystem\midtier\WEB-INF\classes\config.properties
- Linux
  - /opt/bmc/ARSystem/midtier/WEB-INF/classes/config.properties
locate the following line

arsystem.authenticator=com.remedy.arsys.session.DefaultAuthenticator

update the line to read as follows

arsystem.authenticator=com.bmc.rsso.plugin.authenticator.RSSOAuthenticator

Make Sure that the Authenticator is com.bmc.rsso.plugin.authenticator.RSSOAuthenticator if you wish to enable RSSO again.If the Authenticator is not changed it will give a AR login page after we login with RSSO.

save the file
open the web.xml in a text editor
- Windows:
  - C:\Program Files\BMC Software\ARSystem\midtier\WEB-INF\web.xml
- Linux
  - /opt/bmc/ARSystem/midtier/WEB-INF/web.xml
locate the following Xml

<!--<filter> 
    <filter-name>RSSOFilter</filter-name> 
    <filter-class>com.bmc.rsso.agent.RSSOFilter</filter-class> 
</filter>-->

update the Xml as follows to uncomment it, by removing the surrounding

<filter>
    <filter-name>RSSOFilter</filter-name>
    <filter-class>com.bmc.rsso.agent.RSSOFilter</filter-class>
</filter>

locate the following Xml

<!--<filter-mapping>
    <filter-name>RSSOFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>-->

update the Xml as follows to uncomment it, by removing the surrounding

<filter-mapping>
    <filter-name>RSSOFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

save the file

Enabling RSSO for SmartIT and Digital Workplace

execute the following SQL statement against the SmartIT database:

UPDATE SmartIT_System.TENANT SET SAML_AUTHENTICATION = 1;

execute the following SQL statement against the Digital Workplace database:

UPDATE DWP_System.TENANT SET SAML_AUTHENTICATION = 1;

Enabling RSSO DWP Catalog

Put the rsso-agent-osgi.jar back o <DWPC Install directory>/deploy and restart the server.