IBM Support

IBM Bluemix Secure Gateway Service not created

Troubleshooting


Problem

While installing the IBM Secure Gateway Client, the service is not created.

Symptom

Something similar (depending on your version of the IBM Secure Gateway Client installation) to the following is recorded during the installation:

17 error Windows_NT 10.0.14393
18 error argv "C:\\Program Files (x86)\\Secure Gateway Client\\ibm\\node6.9.4\\node.exe" "C:\\Program Files (x86)\\Secure Gateway Client\\ibm\\node6.9.4\\node_modules\\npm\\bin\\npm-cli.js" "run-script" "install-securegw-service"
19 error node v6.9.4
20 error npm  v3.10.10
21 error code ELIFECYCLE
22 error ibm-bluemix-secure-gateway-client@1.8.0-fp6 install-securegw-service: `winser -i -a -s --name "IBM Bluemix Secure Gateway Service"`
22 error Exit status 1
23 error Failed at the ibm-bluemix-secure-gateway-client@1.8.0-fp6 install-securegw-service script 'winser -i -a -s --name "IBM Bluemix Secure Gateway Service"'.
23 error Make sure you have the latest version of node.js and npm installed.
23 error If you do, this is most likely a problem with the ibm-bluemix-secure-gateway-client package,
23 error not with npm itself.
23 error Tell the author that this fails on your system:
23 error     winser -i -a -s --name "IBM Bluemix Secure Gateway Service"
23 error You can get information on how to open an issue for this project with:
23 error     npm bugs ibm-bluemix-secure-gateway-client
23 error Or if that isn't available, you can get their info via:
23 error     npm owner ls ibm-bluemix-secure-gateway-client
23 error There is likely additional logging output above.

Cause

Customer is installing the IBM Secure Gateway client on a machine that has no internet access.  npm is required for this installation and will be access (installed) by accessing it's web site.

Resolving The Problem

When installing the Secure Gateway client, it will try and reach out to https://npmjs.org ... if that is blocked, your options are:
Option #1
- Install on a machine that has no restrictions to accessing sites outside your network
- Copy over the files (C:\Program Files (x86)\Secure Gateway Client) from that machine to your locked down server
- Create the service manually using the following command, from the path specified:
     C:\Program Files (x86)\Secure Gateway Client\ibm\securegateway\client>windowsService.cmd install
The Secure Gateway Service name created is:
For 1.8.0 X -> IBM Bluemix Secure Gateway Service
For 1.8.5 X -> IBM Cloud Secure Gateway Service
The following two lines should be displayed, upon executing the command:
C:\Program Files (x86)\Secure Gateway Client\ibm\securegateway\client>windowsService.cmd install
> ibm-bluemix-secure-gateway-client@1.8.5-fp1 install-securegw-service C:\Program Files (x86)\Secure Gateway Client\ibm\securegateway\client
> winser -i -a -s --name "IBM Cloud Secure Gateway Service"
or
C:\Program Files (x86)\Secure Gateway Client\ibm\securegateway\client>windowsService.cmd install
> ibm-bluemix-secure-gateway-client@1.8.0-fp6 install-securegw-service C:\Program Files (x86)\Secure Gateway Client\ibm\securegateway\client
> winser -i -a -s --name "IBM Bluemix Secure Gateway Service"

*** In addition to the above, you must ensure that outbound ports 443 and 9000 are open. ***

Option #2
- Do a manual download and install of node.js and npm as outlined on their web page, FIRST, then try the installation of IBM Secure Gateway Client next.
       https://docs.npmjs.com/getting-started/installing-node
How to Install npm & Manage npm Versions
  1. Install Node.js & npm
  2. Update npm
The second paragraph of this web page outlines the manual steps to update / download the latest npm package, effectively what the SGC is supposed to do automatically.

[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSD29G","label":"IBM Planning Analytics"},"Component":"IBM Secure Gateway Client","Platform":[{"code":"PF033","label":"Windows"}],"Version":"All Versions","Edition":"","Line of Business":{"code":"LOB10","label":"Data and AI"}}]

Document Information

Modified date:
10 April 2020

UID

ibm10733607