How to temporarily disable and re-enable RSSO

Version 3
    Share This:

    This document contains official content from the BMC Software Knowledge Base. It is automatically updated when the knowledge article is modified.


    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:

    Backup Files
    First, create a backup of the following 2 files:

       
    • C:\Program Files\BMC Software\ARSystem\midtier\WEB-INF\classes\config.properties
    •  
    • C:\Program Files\BMC Software\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 C:\Program Files\BMC Software\ARSystem\midtier\WEB-INF\classes\config.properties in a text editor
    •  
    • 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 C:\Program Files\BMC Software\ARSystem\midtier\WEB-INF\web.xml in a text editor
    •  
    • 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 <!-- and -->
                           
    <!--<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 <!-- and -->
                           
    <!--<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;
      

    Disabling RSSO for DWP Catalog  
       
    • You need to 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 C:\Program Files\BMC Software\ARSystem\midtier\WEB-INF\classes\config.properties in a text editor
    •  
    • 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
      
       
    • save the file
    •  
    • open C:\Program Files\BMC Software\ARSystem\midtier\WEB-INF\web.xml in a text editor
    •  
    • 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 <!-- and -->
                           
    <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 <!-- and -->
                           
    <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;

     


    Article Number:

    000163062


    Article Type:

    FAQ/Procedural



      Looking for additional information?    Search BMC Support  or  Browse Knowledge Articles