Enterprise Manager Fails to Load

Since BBj 14.0, BBj’s Enterprise Manager conveniently runs directly in the browser or Eclipse EM Plugin of any system with network access to the server with the following URL:

http://server-hostname:portnumber/bbjem/em

For example, if you installed BBj on a server named bbjserver.example.com, with the default BBjServices Jetty port configured to 8888, then the Enterprise Manager URL would be the following:

http://bbjserver.example.com:8888/bbjem/em

If Enterprise Manager fails to load, below are some areas to check.

Firewall

In order to connect to Enterprise Manager from a remote machine, the Jetty web server port 8888 and the BBj Admin port 2002* must be accessible to the connecting system.  

A simple way to test port connectivity is to use the telnet client to connect to the remote server/port:  telnet bbjserver.example.com 2002

*Note:  Most BBj ports can be configured to different port numbers; 8888 and 2002 are the defaults for Jetty and Admin, respectively.

LogMeIn

Any software package that runs on a port used by BBjServices will cause connectivity issues.  LogMein, a remote connectivity service, often runs on port 2002.

Resolution 1:  Configure LogMein to use a different port.  

Resolution 2:  Configure BBjServices to use a different port for the Admin server:

1. Stop BBjServices

2. Edit <bbjhome>/cfg/BBj.properties; changing the port in this property to the desired port number:  com.basis.server.admin.1.defaultPort=2002    

Classpath Problems After Upgrade

In some upgrade cases, having a classpath that refers to a missing .jar file in BBj.properties can lead to problems in the upgrade process and an incomplete BBj.properties file.  

For example, a BBj upgrade with the classpath property that references a .jar file that is not physically present in path specified, may cause the upgrade to fail and prevent Enterprise Manager from loading:

basis.java.classpath=C\:\\bbj\\lib\\BBjIndex.jar;C\:\\bbj\\
lib\\ExtIndex.jar;C\:\\bbj\\lib\\GappsV3Index.jar;C\:\\bbj\\l
ib\\basisfonts.jar;C\:\\bbj\\lib\\missing.jar

Additional Reading

KB#01228-Enterprise Manager Unable to Connect to BBjServices on Port 2002

KB#00967-Current BBj default ports for the various BBj servers