SSO adapter upgrade on Windows - CustomerID

Last reviewed: 2018-02-21

Ubisecure CustomerID package includes the Ubisecure CustomerID SSO Adapter extension to the Ubisecure SSO (it was previously called Ubisecure CustomerID Authorizer). It needs to be installed so that role based policies can be utilized in Ubisecure CustomerID. It also includes functionality related to user driven federations.

NOTE: If you are upgrading from an installation where the previous Ubisecure CustomerID SSO Adapter has been from an Ubisecure CustomerID version below 5.0.x then you need to remove old Ubisecure 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: %PROGRAMFILES%\Ubisecure\ubilogin-sso\tomcat\webapps\uas\WEB-INF\lib and %PROGRAMFILES%\Ubisecure\ubilogin-sso\ubilogin\webapps\uas\WEB-INF\lib

set UBILOGIN_HOME=%PROGRAMFILES%\Ubisecure\ubilogin-sso\ubilogin
Define UBILOGIN_HOME environment variable for the Ubisecure SSO server so that it points to the Ubisecure SSO installation path: %PROGRAMFILES%\Ubisecure\ubilogin-sso\ubilogin
Transfer the cid-sso-adapter-package-x.x.x-windows.zip file to the Ubisecure SSO server and extract it for example under the following folder: %PROGRAMFILES%\Ubisecure
Run the Ubisecure CustomerID SSO Adapter update script:
```
cd /D "%PROGRAMFILES%\Ubisecure\cid-sso-adapter"
update.cmd
```
The Ubisecure CustomerID SSO Adapter jar files will be integrated to the Ubisecure SSO installation.
Remove older versions of duplicate jar files from Ubisecure SSO: %PROGRAMFILES%\Ubisecure\ubilogin-sso\ubilogin\webapps\uas\WEB-INF\lib

NOTE: If you are upgrading from an installation where the previous Ubisecure CustomerID SSO Adapter has been from an Ubisecure CustomerID version equal or higher than 5.0.x then you need to remove old versions of Ubisecure 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: %PROGRAMFILES%\Ubisecure\ubilogin-sso\tomcat\webapps\uas\WEB-INF\lib and %PROGRAMFILES%\Ubisecure\ubilogin-sso\ubilogin\webapps\uas\WEB-INF\lib. The removal should be done after running the update.cmd script.
NOTE: If you are upgrading from an installation where the previous Ubisecure CustomerID SSO Adapter has been from an Ubisecure CustomerID below 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.
Run update on Ubisecure SSO in order to finalize the upgrade of the Ubisecure CustomerID SSO Adapter.
```
"%PROGRAMFILES%\Ubisecure\ubilogin-sso\ubilogin\config\tomcat\update.cmd"
```

Ensure that the diagnostics log (uas3_diag.yyyy-mm-dd.log, which is by default located at %PROGRAMFILES%\Ubisecure\ubilogin-sso\ubilogin\logs) contains the following rows (with the current time):

2016-09-02 13:57:49,021 init CustomerID Authorizer started
2016-09-02 13:57:49,021 authz eidm.authorizer: CidAuthorizer init started.
2016-09-02 13:57:49,209 init CustomerID SQL: customeriddb PostgreSQL x.x.x
2016-09-02 13:57:49,224 authz eidm.authorizer: CidAuthorizer init done.
2016-09-02 13:57:49,224 init eidm: com.ubisecure.customerid.authorizer.CidAuthorizer: started