This site contains the documentation that is relevant to older WSO2 product versions and offerings.
For the latest WSO2 documentation, visit https://wso2.com/documentation/.

Upgrading an Authenticator

Owned by Former user (Deleted)
Last updated: Nov 10, 2017 by Former user (Deleted)
1 min read

This topic provides instructions on how to upgrade a connector and it's artifacts to the latest version in WSO2 Identity Server. 

Before you begin

Stop WSO2 Identity Server if the server is already running.

  1. Download and extract the latest version of the connector artifacts (.jar, .war, gadgets etc.,) from the connector store.
  2. Replace the old .jar file found in the <IS_HOME>/repository/components/dropins folder with the new .jar file that you downloaded.
  3. For some connectors such as SMSOTP, EmailOTP, TOTP, X509Certificate etc., you are required to deploy .war files. To do this,
    1. Navigate to the <IS_HOME>/repository/deployment/server/webapps/ directory, and remove the existing .war file and the extracted folder of the .war of the specific authenticator that you want to upgrade. 
    2. Copy the latest .war file that you downloaded in step 1 to the <IS_HOME>/repository/deployment/server/webapps/ directory.
  4. For some authenticators such as EmailOTP, you are required to do specific configurations in the <IS_HOME>/repository/conf/identity/application-authentication.xml file under the <AuthenticatorConfigs> section. Update these configurations with the latest values according to the specific connector that you are upgrading.

Note: If you are upgrading the TOTP authenticator, replace the user_profile folder found in the <IS_HOME>/repository/deployment/server/jaggeryapps/portal/gadgets directory with the relevant user_profile folder provided in the artifacts folder you downloaded in step 1.