Problem

The Workbench URL cannot be reached (e.g. returns a 404 error) and/or the service appears to not be running. Common symptoms for each operating system are:

...

$> sudo service dm-mettleci-workbench start
MettleCI Workbench is not running
Starting MettleCI Workbench ...
MettleCI Workbench has been started
$> sudo service dm-mettleci-workbench status
/opt/dm/mci/METTLE_UI.pid dead but pidfile exist

Diagnostics

There are a number of diagnostic steps you can take to help understand and resolve your particular Workbench issue:

Ensure you’re using a correct, unblocked URL for the MCI Workbench

The Workbench is most typically installed on your DataStage Engine tier, in which case you would use…

• http://[your-engine-tier-URL]:8080, and/or

• https://[your-engine-tier-URL]:8443 (if you've configured Workbench to use HTTPS)

Ensure that your MettleCI Workbench menu items are configured to use the correct URL’s.

Ensure that the relevant ports are available

By default, MettleCI uses ports 8080 / 8443 (for the end-user UI) and 8081 (for the low-level diagnostics UI). There are two port-related scenarios that can cause Workbench to be unavailable:

1. The port for the UI you are trying to access is blocked by network-level or operating-system-level firewall rules. Time to talk to your friendly network administrator.

2. Either port is taken by other processes (e.g. a popular virus scanning application on Microsoft Windows often uses port 8081).

   • Workbench may appear to start but the browser will fail to get a response when you go to http://localhost:8080.

   • You will need to change the conflicting port in Workbench's config.yml file in the MettleCI home directory.

   • If this situation arises at the point that you are installing Workbench, its configuration wizard will be unavailable and you will need to configure Workbench manually. In this case, contact MettleCI Support and you will be provided with a template config.yml file and further instructions.

Find out which ports are already in use

Sometimes an old execution of Workbench from a previous installation may still be running and keeping the port open. Alternatively, a different application definitely requires use of that port. Find out what is already connected to the relevant port using the following methods:-

...

$> sudo netstat -tulpn | grep LISTEN | grep 8080
tcp6       0      0 :::8080                 :::*                    LISTEN      2018/java
$> ps -ef | grep 2018
mciworkb  2018     1  0 04:31 ?        00:00:54 /bin/java -jar /opt/dm/mci/mettle-ui-1.0-1432.jar server /opt/dm/mci/config.yml
root     31582 31469  0 14:19 pts/2    00:00:00 grep --color=auto 2018
$>

Check the status of the workbench service

Expand
title Windows
Open the Services application and verify that the Workbench service has been installed, has been configured to start automatically, and is running:

[user@host]$> sudo service dm-mettleci-workbench status        # You'll receive either

MettleCI Workbench is not running                              # This message, if the workbench service is running, or
/opt/dm/mci/METTLE_UI.pid dead but pidfile exists              # This message, if it's failed for some reason

Verify your Service settings (Windows)

Expand
title Windows
Open a Windows Command window and run the NSSM tool shipped with your MettleCI installation: Code Block C:\> cd C:\dm\mci\nssm\win64 C:\dm\mci\nssm\win64> nssm edit "MettleCI Workbench" This will display a dialog which will enable you to inspect and modify the settings for your Window MettleCI Workbench service. Use this tool to verify the values you provided at installation time. If you need to make any changes click ‘Edit service’ to make them permanent, then try restarting your MettleCI Workbench service:

Check the MettleCI log

Inspect the contents of /opt/dm/mci/mci.log

Verify your license file

Ensure your MettleCI license file is…

• named correctly, and in the correct directory (<METTLECI-HOME>/mettleci.lic)

• configured with permissions appropriate to make it readable by the account used to execute the service

• referenced correctly in your <METTLECI-HOME>/config.yaml file

• valid. Refer to the details in the email which provided you with your license file. Specifically…

  • Has your license expired? Check the effective dates.

  • Are other license constraints valid? e.g. does the MAC address of the host on which you are running the Workbench service match that embedded in your license?

Verify your MettleCI configuration file

Run the following commands to verify your config.yml file, and then try to start the Workbench service manually to provide further opportunities for diagnostic output:

...

# Where xxxx is your version of MettleCI Workbench...
[user@host]$> java -jar <METTLE-HOME-DIRECTORY>/mettle-ui-1.0-xxxx.jar check <METTLE-HOME-DIRECTORY>/config.yml

then...

[user@host]$> java -jar <METTLE-HOME-DIRECTORY>/mettle-ui-1.0-xxxx.jar server <METTLE-HOME-DIRECTORY>/config.yml

Manually run the Workbench Java application

If you have been unable to diagnose the issue with your Workbench service, you can manually run the java command to start Workbench to check if any of the output from the java command can help you identify the issue.

...

[root@test1-engn mci]# java -jar mettle-ui-1.0-1234.jar server config.yml
java.lang.RuntimeException: java.io.IOException: Failed to bind to 0.0.0.0/0.0.0.0:8080
	at org.eclipse.jetty.setuid.SetUIDListener.lifeCycleStarting(SetUIDListener.java:229)
	at org.eclipse.jetty.util.component.AbstractLifeCycle.setStarting(AbstractLifeCycle.java:205)
	at org.eclipse.jetty.util.component.AbstractLifeCycle.start(AbstractLifeCycle.java:72)
	at io.dropwizard.cli.ServerCommand.run(ServerCommand.java:53)
	at io.dropwizard.cli.EnvironmentCommand.run(EnvironmentCommand.java:45)
	at io.dropwizard.cli.ConfiguredCommand.run(ConfiguredCommand.java:87)
	at com.datamigrators.mettle.setup.StartServerCommand.run(StartServerCommand.java:41)
	at io.dropwizard.cli.Cli.run(Cli.java:78)
	at io.dropwizard.Application.run(Application.java:94)
	at com.datamigrators.mettle.MettleApplication.main(MettleApplication.java:66)
Caused by: java.io.IOException: Failed to bind to 0.0.0.0/0.0.0.0:8080
	at org.eclipse.jetty.server.ServerConnector.openAcceptChannel(ServerConnector.java:349)
	at org.eclipse.jetty.server.ServerConnector.open(ServerConnector.java:310)
	at org.eclipse.jetty.setuid.SetUIDListener.lifeCycleStarting(SetUIDListener.java:216)
	... 9 more
Caused by: java.net.BindException: Address already in use
	at sun.nio.ch.Net.bind0(Native Method)
	at sun.nio.ch.Net.bind(Net.java:433)
	at sun.nio.ch.Net.bind(Net.java:425)
	at sun.nio.ch.ServerSocketChannelImpl.bind(ServerSocketChannelImpl.java:223)
	at sun.nio.ch.ServerSocketAdaptor.bind(ServerSocketAdaptor.java:74)
	at org.eclipse.jetty.server.ServerConnector.openAcceptChannel(ServerConnector.java:345)
	... 11 more

Related articles

...