Updating WSO2 API Manager 4.7 Behind a Corporate Proxy

-


With WSO2 API Manager 4.7, the Update Tool is no longer bundled with the product distribution. Instead, you must first download it using the update_tool_setup.sh script, which then installs the platform-specific update utility (for example, wso2update_linux).

If your environment is behind a corporate proxy, the download may fail unless the proxy environment variables are configured.

Step 1: Configure Proxy (If Applicable)

Before running the setup script, configure the proxy environment variables.

export http_proxy=http://[proxy-host]:[proxy-port]
export https_proxy=http://[proxy-host]:[proxy-port]

export HTTP_PROXY=$http_proxy
export HTTPS_PROXY=$https_proxy

# Optional
export no_proxy=localhost,127.0.0.1,[internal-domains]
export NO_PROXY=$no_proxy


Note: In my environment, configuring https_proxy was sufficient for the Update Tool to download successfully.
Step 2: Download the Update Tool
Navigate to the API Manager installation directory bin (AM_HOME/bin) and execute:
./update_tool_setup.sh
Command Output
$ ./update_tool_setup.sh
Downloading and extracting the supported Update Tool binary...
Downloading archive wso2update_linux.zip
https://product-dist.wso2.com/downloads/update-tool/release/wso2update_linux.zip
######################################################################################################################################################################### 100.0%

Successfully downloaded and extracted the supported Update Tool binary



This downloads the appropriate update utility for your operating system.
Step 3: Update the Product
Once the setup completes, execute the downloaded update utility.
./wso2update_linux
The tool checks for available updates, downloads the required patches, and updates the API Manager installation.

Command Output

$ ./wso2update_linux
Initializing update tool with credentials
Please enter your credentials to continue.

Email: kumar@domain.com
Password for kumar@domain.com
Authenticating
Authenticated user kumar@domain.com
Checking for latest update tool version
-------------- Welcome to WSO2 Updates --------------

Checking for updates
The latest update level is 'wso2am-4.7.0.9'.
This consists of 18 updates applied on top of 'wso2am-4.7.0.7'
[WARNING]
 The update level 'wso2am-4.7.0.9' consists of 1 critical security updates applied on top of 'wso2am-4.7.0.7'.
WSO2 strongly recommends to use 'wso2am-4.7.0.9' distribution in production as soon as possible.
Creating a backup of '/data1/u01/binaries/wso2am-4.7.0'
Successfully created the backup at : /home/appadmin1/.wso2-updates/backup/wso2am-4.7.0-bdee23ad-0018-4ae8-bc67-33f4d7dfc0d9
Downloading updates
Downloading files... [63/63] - 0s remaining
Updating product
wso2am-4.7.0 updated successfully

Key Takeaways

  • WSO2 API Manager 4.7 no longer ships with the Update Tool by default.
  • Execute update_tool_setup.sh once to download the platform-specific update utility.
  • If you're behind a corporate proxy, configure http_proxy and https_proxy before running the setup script.
  • After the Update Tool is downloaded, use wso2update_linux (or the equivalent for your operating system) to apply the latest product updates.
  • This small change in the update process can save troubleshooting time, especially in enterprise environments where outbound internet access is restricted through a proxy.

 Infographic

WSO2 APIM v4.7 update



    Comments

    Post a Comment

    Popular posts from this blog

    Oracle SOA Suite- Implementing Email Notification

    -
    Image
    In this post, I am going to show how to implement email notifications in Oracle SOA Suite using BPEL process. So let's get started- Implementing email notification in Oracle SOA Suite consists of below steps: Environment- IDE- Oracle jDeveloper 11g Weblogic Server 12c Oracle SOA Suite 12c High Level Steps Keep ready email server settings. Configure & enable usermessagingdriver-email for target SOA servers via console. Setting up Email driver (usermessagingdriver-email )with email server settings via enterprise manager. Enable notifications for SOA workflows(make sure either All or EMail option is selected).. Create SOA composite application Deploy it on SOA server. Testing & done. 1. Keep ready email server settings. Keep ready your below email server settings: Outgoing Mail Server          : smtp.domain.com Outgoing Mail Server Port   : xxx Default From Address         : username@doamin...
    Read more

    Oracle SOA Suite 12c- PKIX path building failed & unable to find valid certification path to requested target

    -
    Image
    Hi Everyone, in this blog I'll be writing one of the strange issue that has been encountered while working with a Oracle SOA composite running in Oracle IDAM environment and trying to invoke a SSL based remote service where SSL certification based exception has been thrown during the service invocation. Environment Oracle SOA Suite 12c  (HA Mode) Oracle IDAM 12c (HA Mode) Oracle Linux 7 External Web Service (SOAP Service) Problem Below is the exception thrown when trying to invoke an external webservice (SSL Based) via BPEL process- <bpelFault><faultType>0</faultType><remoteFault xmlns="http://schemas.oracle.com/bpel/extension"><part name="summary"><summary>oracle.fabric.common.FabricInvocationException: Unable to invoke endpoint URI "https://idam.uppclonline.com/soa-infra/services/default/DefaultOperationalApproval!5.12*soa_69e4734b-d8fe-4edf-b44e-e287f61c2ddf/SMSNotification%23ApprovalProcess/SMSNotification" succe...
    Read more

    Migration of Oracle SOA Suite Composite from 11g to 12c

    -
    Image
    Recently I have came across a scenario where I have a business requirement of  migration of Oracle SOA Suite 11g(11.1.1.7.0) to 12c(12.1.3.0). Below are the different mechanisms I have tried to do, few of them failed and one succeeded. Working in Oracle SOA Suite 11g is completely different from 12c. In 11g, we need to install the jDeveloper(11.1.1.7) then SOA extension separately to be installed either via offline file  (download available at  https://www.oracle.com/ocom/groups/public/@otn/documents/webcontent/156082.xml ) or through jDeveloper top menu >>  Help >> Check for Updates >> SOA Extension.  While working with 12c doesn't involves such tedious job. Only single installer is required for jDeveloper/SOA/Weblogic and is available as QuickStart Installer(download available at https://www.oracle.com/technetwork/middleware/soasuite/downloads/index.html). Approach 1- Compress(Zip) SOA composite ...
    Read more