Upgrade from 11.4.x to 11.5.x or 11.6.x failed with HTTPS Error 504 - Gateway Timeout error for NetWitness Platform
Issue
When upgrading the NetWitness Platform from 11.4.x to 11.5.x or 11.6.x, the NetWitness Platform can fail with a post upgrade HTTPS Error 504 - Gateway Timeout. This error can appear in the browser as well as in the node-infra-server.log.
Cause
What can cause this issue is an upgrade failure due to having proxy settings enabled in the /etc/yum.conf and/or the /etc/environment file.Resolution
To address this issue, there are two options possible based on what is required of the environment. Note: Both options are performed against the Admin Server (Node 0)Removing/Disabling Proxy Settings
If the proxy server settings can be removed from NetWitness and the upgrade can still function, follow the steps below.- Open /etc/yum.conf file and remove the proxy setting. Example: proxy=
[main]
cachedir=/var/cache/yum/$basearch/$releasever
keepcache=0
debuglevel=2
logfile=/var/log/yum.log
exactarch=1
obsoletes=1
gpgcheck=1
plugins=1
installonly_limit=5
bugtracker_url=http://bugs.centos.org/set_project.php?project_id=23&ref=http://bugs.centos.org/...
proxy=http://192.168.20.1:8080
cachedir=/var/cache/yum/$basearch/$releasever
keepcache=0
debuglevel=2
logfile=/var/log/yum.log
exactarch=1
obsoletes=1
gpgcheck=1
plugins=1
installonly_limit=5
bugtracker_url=http://bugs.centos.org/set_project.php?project_id=23&ref=http://bugs.centos.org/...
proxy=http://192.168.20.1:8080
- Open /etc/envrionment file and remove the proxy settings. Example: Proxy URL format: http(s)://
:
http_proxy=http://proxy.customer.net:8080
https_proxy=http://proxy.customer.net:8080
HTTP_PROXY=http://proxy.customer.net:8080
HTTPS_PROXY=http://proxy.customer.net:8080
no_proxy=127.0.0.1,localhost
export HISTSIZE=10000
export HISTTIMEFORMAT="%h/%d/%y - %H:%M:%S"
https_proxy=http://proxy.customer.net:8080
HTTP_PROXY=http://proxy.customer.net:8080
HTTPS_PROXY=http://proxy.customer.net:8080
no_proxy=127.0.0.1,localhost
export HISTSIZE=10000
export HISTTIMEFORMAT="%h/%d/%y - %H:%M:%S"
- Rerun the upgrade.
Not Removing/Disabling Proxy Settings
If the proxy server settings cannot be removed or disabled, follow the steps below.- Create or update the file /etc/netwitness/platform/repobase with the line below.
# vi /etc/netwitness/platform/repobase
file:///var/netwitness/common/repo
file:///var/netwitness/common/repo
- Rerun the upgrade.
Internal Comments
I have attempted to recreate this issue by inserting the proxy values into /etc/yum.conf and /etc/environment in my lab, but it did not prevent checking for updates on 12.3.1 or 12.4.2, so I am switching this to interna and marking it as Archived.
Product Details
NetWitness Product Set: NetWitness PlatformNetWitness Product/Service Type: AdminServer (UI)
NetWitness Version/Condition: 11.4.x, 11.5.x, 11.6.x
Platform: CentOS 7
Approval Reviewer Queue
Technical approval queue