"Server is not reachable or still initializing, please refresh the page in a few seconds" error launching Controller Web caused by incorrect TCP port inside 'server.xml'

Troubleshooting

Problem

User launches Controller Web. An error appears.

Symptom

Server is not reachable or still initializing, please refresh the page in a few seconds

Cause

There are several known causes for the 'Server is not reachable or still initializing, please refresh the page in a few seconds' error.

TIP: See separate IBM Technote #0791129 for more examples.

This Technote specifically relates to the scenario where the cause is that the configuration file 'server.xml' contains the wrong setting.

Specifically, the value for 'httpPort' was incorrect.

Example:

In one case, the setting was configured as:

<httpEndpoint host="*" httpPort="9080" httpsPort="9443" id="defaultHttpEndpoint">

This is incorrect for the (default) settings of Controller 10.4.0 (which expects the httpPort to be 3000 and httpsPort to be 3443).

Environment

This Technote is based on Controller 10.4.0.

However, it may be applicable for some other versions.

Diagnosing The Problem

1. Open the 'frontend' logs folder.

TIP: By default, this is here: C:\Program Files\ibm\cognos\ccr_64\frontend\logs

2. Open the most recent 'fcmwebui-xxxxxx' log file (inside Notepad).

Example:

2019-04-25 12:29:08 Commons Daemon procrun stdout initialized
Server ip written in backend-url.js!
Express server listening on port 9080
error from web proxy: { Error: connect ECONNREFUSED 127.0.0.1:3000
    at Object._errnoException (util.js:1022:11)
    at _exceptionWithHostPort (util.js:1044:20)
    at TCPConnectWrap.afterConnect [as oncomplete] (net.js:1182:14)
code: 'ECONNREFUSED',
errno: 'ECONNREFUSED',
syscall: 'connect',
address: '127.0.0.1',
port: 3000 }
error from web proxy: { Error: connect ECONNREFUSED 127.0.0.1:3000
    at Object._errnoException (util.js:1022:11)
    at _exceptionWithHostPort (util.js:1044:20)
    at TCPConnectWrap.afterConnect [as oncomplete] (net.js:1182:14)
code: 'ECONNREFUSED',
errno: 'ECONNREFUSED',
syscall: 'connect',
address: '127.0.0.1',
port: 3000 }

Resolving The Problem

Reconfigure the file 'server.xml'.

Steps:

1. Logon to the Controller application server

2. Browse to the 'fcm.web' folder

TIP: By default, this is here: C:\Program Files\IBM\cognos\ccr_64\fcmweb\wlp\usr\servers\fcm.web

3. As a precaution, create a backup copy of the file: server.xml

4. Edit the following file in NOTEPAD: server.xml

5. Modify the settings to be correct.

Example: For most customers this should be:

<httpEndpoint host="*" httpPort="3000" httpsPort="3443" id="defaultHttpEndpoint">

6. Save changes

7. Obtain downtime (no users using Controller) and restart the application server.

Related Information

0791129 - ** Troubleshooting ** "Server is not reachable or still initializing,…

Document Location

Worldwide

[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SS9S6B","label":"IBM Cognos Controller"},"Component":"","Platform":[{"code":"PF033","label":"Windows"}],"Version":"10.4.0","Edition":"","Line of Business":{"code":"LOB10","label":"Data and AI"}}]

Tips