Versions Compared

Key

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

...

  1. Run the following commands to check whether there are updates available:

    Code Block
    wum check-update <product>
    E.g., wum check-update wso2am-2.5.0
  2. If an update is available, run the following command to start updating your product:

    Code Block
    wum update <product>
    E.g., wum update wso2am-2.5.0

    Your local product repository should now contain the latest and the previous WUM-updated distributions. Let's extract the updates in the latest WUM-updated distribution to a ZIP file.

  3. Execute the following command to identify the previous WUM-updated pack for this product.

    Code Block
    wum list [product-name]
    E.g., wum list wso2am
  4. Execute the following command:

    Code Block
    wum diff <Latest-WUM-updated-distribution.zip> <Previous-WUM-updated-distribution.zip>
    E.g., wum diff wso2am-2.5.0+1538333553548.full.zip wso2am-2.5.0+1537333553538.full.zip
    Tip

    Note that the diff ZIP is created in the location from where you executed the diff command.

    Next, let's apply the WUM updates that you extracted to the ZIP file to the distribution pack that is currently running in your environment.

  5. Open the summary PDF that you get inside this ZIP file (also via email). It contains information about the:

    • New configurations introduced with the update.

    • Existing files/artifacts that are affected due to the update.

  6. If you do not have any customizations in the existing distribution, simply copy the changed configuration files mentioned in the ZIP to the corresponding directories in your product distribution.

  7. If you have customizations in the existing distribution, there might be conflicts between that and the WUM-updated distribution. 

    Expand
    titleClick to read how to resolve conflicts...

    A conflict happens when a customized configuration file or artifact has changed in the WUM updates. As the file/artifact has your customizations in it, it is not recommended to completely replace this file with the file that comes with the update.

    Given below is how to resolve conflicts manually in different types of files/artifacts:

    File TypeHow to Merge the Conflicts
    Binary files

    Copy all the binary files (.jar, .jks, .car, .war) to the relevant directories in your existing product distribution. If you have made any customizations to .car and .war files, manually merge those changes.

    Tip

    Note: If there are .war files in the WUM update, be sure to delete all extracted .war files in your existing product distribution.

    This is because all deployed .war files get extracted at the server startup and if there are already extracted .war files by that same name, the server will not extract the updated .war files in the WUM update.

    Jaggery files

    You cannot replace the Jaggery artifacts in your existing product distribution with the WUM-updated Jaggery artifacts because your existing Jaggery artifacts may contain customizations. Here's how to merge the files:

    1. Check the summary PDF to identify how the Jaggery files have changed because of the WUM updates.
    2. Apply the changes to the same files in your existing product distribution.
    Apply the updated configuration files

    Identify the configuration updates in the summary PDF and apply them (by merging) to the relevant configuration files in the <PRODUCT_HOME>/repository/conf folder of your existing product distribution.

    Note: Be sure to merge the configuration files in your environment with the new files. It is not recommended to replace them.

    Redundant filesIf there are artifacts/files that are removed by the WUM updates, remove them from your existing product distribution.
    Newly added filesIf there are newly added files listed in the PDF, create the same folder structure (if it doesn't exist) in your existing product distribution and add the file.
  8. Do you have additional WSO2 features installed in your product distribution? If so,

    Expand
    titleClick to read on...

    Please note that WSO2 does not recommend installing new features to standard products. If you already have features installed, you need to install the same features in the new product distribution and apply the patches. Please contact team WSO2 as this needs to be handled on a case-by-case basis.

  9. Test the updated product distribution and deploy it in your production environment.