Versions Compared

Key

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

If you are new to WSO2 updates, here is how to install WUM and update your product for the first time:

  1. Get a valid WSO2 support subscription or subscribe to our free trial.
  2. If you have a proxy server/firewall, grant access to the endpoints mentioned below.

    Expand
    titleExpand to read more...

    WUM gets updates by connecting to the https://api.updates.wso2.com and https://cdn.updates.wso2.com endpoints in the WSO2 Update service. If your system connects to the Update service through a proxy server/firewall, grant access to these endpoints.
    Since WUM is a command-line tool, the proxy should be configured from your command-line as follows: 

    Code Block
    export http_proxy=http://username:password@proxyhost:port/
    Tip

    If you are behind an NTLM proxy, you can use a third party tool like  CNTLM  to do the NTLM proxy authentication. See the CNTLM documentation for instructions.

  3. Download and install WUM from https://wso2.com/wum/download/. The UI guides you through the process.
  4. Execute the following command on the command-line to initialize WUM. 

    Code Block
    wum init
  5. When prompted, give the WSO2 support subscription's user credentials.

  6. Note that the following directory is created in your computer:

    • On Unix: ~/.wum3
    • On Windows: C:\users\<username>\.wum3
  7. WUM updates are available only for the WSO2 product versions listed in https://wso2.com/updates/wum. Let's start by downloading a vanilla product distribution.

    Code Block
    //Search for an available product
    wum search <keyword>
    E.g., wum search am
    
    //Download the product
    wum add <product>
    E.g., wum add wso2am-2.5.0
  8. Check whether the product has any recent updates using the following command:

    Code Block
    wum check-update <product>
    E.g., wum check-update wso2am-2.5.0
  9. Execute the following command to start updating your product:

    Code Block
    wum update <product>
    E.g., wum update wso2am-2.5.0
  10. Note that the directory path of the new distribution appears on your terminal. You also get an email with details.

...