Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. After upgrading SSO (as instructed in page  Upgrading SSO in Linux), prior to removing the temporary ubilogin-sso-old folder, go to the folder containing the old configuration files: 

    Code Block
    languagetext
    cd /usr/local/ubisecure/ubilogin-sso-old/ubilogin/webapps/uas/WEB-INF/


  2. Copy the existing configuration files to the new installation folder: 

    Code Block
    languagetext
    cp -a attribute-prefix.index /usr/local/ubisecure/ubilogin-sso/ubilogin/webapps/uas/WEB-INF/
    cp -a eidm2-authorizer.properties /usr/local/ubisecure/ubilogin-sso/ubilogin/webapps/uas/WEB-INF/


    Note

    NOTE: If you are upgrading from an installation where the previous CustomerID SSO Adapter has been from a CustomerID version older than 5.0.x then you need to check the attribute-prefix.index configuration file contents. The value for the eimd property has changed from com.ubisecure.customerid.authorizer.EIDM2Authorizer to com.ubisecure.customerid.authorizer.CidAuthorizer.


  3. Define UBILOGIN_HOME environment variable for the SSO server so that it points to the SSO installation path: /usr/local/ubisecure/ubilogin-sso/ubilogin 

    Code Block
    languagetext
    export UBILOGIN_HOME=/usr/local/ubisecure/ubilogin-sso/ubilogin


  4. Transfer the cid-sso-adapter-package-x.x.x-linux.tar.gz file to the SSO server and extract it for example under the following folder: /usr/local/ubisecure
  5. Run the CustomerID SSO Adapter update script: 

    Code Block
    languagetext
    cd /usr/local/ubisecure/cid-sso-adapter
    ./update.sh

    The CustomerID SSO Adapter jar files will be integrated to the SSO installation.

  6. Remove older versions of duplicate jar files from SSO: /usr/local/ubisecure/ubilogin-sso/ubilogin/webapps/uas/WEB-INF/lib

    Note

    NOTE: If you are upgrading from an installation where the previous CustomerID SSO Adapter has been from a CustomerID version older than 5.0.x then you need to remove old CustomerID Authorizer files. The files that need to be removed are: commons-lang.jar, eidm2-authorizer.jar, eidmutil.jar, json-simple.jar and jsr305.jar. Remove the files from these folders: /usr/local/ubisecure/ubilogin-sso/tomcat/webapps/uas/WEB-INF/lib and /usr/local/ubisecure/ubilogin-sso/ubilogin/webapps/uas/WEB-INF/lib


    Note

    NOTE: If you are upgrading from an installation where the previous CustomerID SSO Adapter has been from a CustomerID version 5.0.x or newer then you may need to remove old versions of CustomerID SSO Adapter related jar files. The files that need to be checked are: cid-model-x.x.x.jar, cid-sso-adapter-x.x.x.jar, cid-util-x.x.x.jar, commons-lang3-x.x.jar, guava-x.x.jar and json-simple-x.x.x.jar. Remove the old versions of these files from these folders: /usr/local/ubisecure/ubilogin-sso/tomcat/webapps/uas/WEB-INF/lib and /usr/local/ubisecure/ubilogin-sso/ubilogin/webapps/uas/WEB-INF/lib. The removal should be done after running the update.sh script.


  7. Run update on SSO in order to finalize the installation of the CustomerID SSO Adapter. This can be done with the following command: 

    Code Block
    languagetext
    /usr/local/ubisecure/ubilogin-sso/ubilogin/config/tomcat/update.sh


  8. Ensure that the SSO diagnostic log (sso_diag.yyyy-mm-dd.log, which is by default located at /usr/local/ubisecure/ubilogin-sso/ubilogin/logs) contains the following rows (with the current time): 

    Code Block
    languagetext
    2022-10-06 07:25:25,711 uas init INFO CustomerID Authorizer started
    2022-10-06 07:25:25,711 uas authz INFO eidm.authorizer: CidAuthorizer init started.
    2022-10-06 07:25:26,083 uas init INFO CustomerID SQL: customeriddb PostgreSQL 12.8
    2022-10-06 07:25:26,130 uas authz INFO eidm.authorizer: CidAuthorizer init done.
    2022-10-06 07:25:26,130 uas init INFO eidm: com.ubisecure.customerid.authorizer.CidAuthorizer: started


...