Most Popular

Load More


The Muse Embedded Tomcat is needed because it entirely replaces Muse HTTP Server which was also used for the internal XML protocol and for the XMLDB. The external Tomcat could not have been used for the XML protocols and XMLDB. If there are no other services than Muse in the External Tomcat then this can be disabled. Muse contexts should be deactivated from there. The Muse Embedded Tomcat will come with its own Muse contexts, thus everything will be ok. Also consider lowering the Java memory for the external Tomcat because Muse servers will not run in it anymore. If there is an External Tomcat running on the same machine which didn’t have anything in common with the Muse Servers then normally one doesn’t have to worry about the embedded Muse Tomcat server, because this one just takes the place of Muse HTTP Server, and since there were no conflicts between that External Tomcat and Muse HTTP Server there shouldn’t be any here. If it is a fresh install of Muse then the only conflicts are given by port 8005 as described below. This conflict was always present between the Muse HTTP Server and an External Tomcat. But in case there was no service running in that External Tomcat we recommend that is shut down and disabled so that it doesn’t start at boot time. In the rare event that there is an external Tomcat that is used both for Muse and for other external services and both Muse and the other services contexts are all defined on the same port (e.g. 80) and you don’t want to change the Muse port to another port (e.g. 8000) then the front end Muse Servlets will remain defined and further used in the External Tomcat server and the Muse Embedded Tomcat will be used for what Muse HTTP Server was used, namely for XML protocols and XMLDB. Regarding the port conflicts there should be none effecting you in normal situation. For rare events, the cases below would help troubleshooting a port conflict in case it would appear. – The Muse HTTP Server already conflicted with an external Tomcat on port 8005 used for internal XML Muse protocols in Muse and for Shut Down in Tomcat. Hence, because Muse HTTP Server and the external Tomcat co-existed it means that the port value was changed from 8005 on one side or another so that both were running. As the Muse Embedded Tomcat takes the Muse HTTP Server configuration the port 8005 should not be an issue. – In case the External Tomcat was connected to the Apache Web Server then the AJP ports will conflict and only one Tomcat will be able to run through the Apache Web Server. For this change the AJP 8009 port from the Muse Embedded Tomcat. However note that other changes to the interconnection between Apache Web Server and both Tomcats are necessary in order to differentiate which requests received by the Apache Web Server are redirected to which Tomcat. These are described in the document Muse External Servlets Engine (Tomcat), chapter entitled “Web service adapters for Tomcat”. – There can be other applications on the same machine conflicting to the External Tomcat. For this a netsat or fuser command can be run on Unix like environments. The Tomcat files were ports are defined are tomcat/conf/server.xml. Check these files both for the External Tomcat and for the Embedded also for the case when one modified in the past the default values of the External Tomcat server.

The ports that need to be accessible from the Internet are:

1. 8000 – Apache Tomcat or Muse HTTP Server

Configuration file – ${MUSE_HOME}/tomcat/conf/server.xml or ${MUSE_HOME}/http/conf/contexts.xml

Files that contain references to this port:

  • ${MUSE_HOME}/factory/MuseInfoBase.xml
  • ${ICE_HOME}/ICECore.xml
  • ${ICE_HOME}/jaas.config
  • ${MUSE_HOME}/proxy/jaas.config
  • ${MUSE_HOME}/web/MusePeer.xml

2. 8443 – Apache Tomcat or Muse HTTP Server

Configuration file – ${MUSE_HOME}/tomcat/conf/server.xml or ${MUSE_HOME}/http/conf/contexts.xml

Files that contain references to this port:

  • ${MUSE_HOME}/web/MusePeer.xml
  • ${MUSE_HOME}/enrich/MuseEnrichmentService.xml
  • ${MUSE_HOME}/enrich/index/index.xml
  • ${MUSE_HOME}/z3950/MuseZBridge.properties

3. 9797 – Muse Proxy

Configuration file – ${MUSE_HOME}/proxy/MuseProxy.xml

Files that contain references to this port:

  • ${MUSE_HOME}/web/MusePeer.xml;
  • ${MUSE_HOME}/enrich/MuseEnrichmentService.xml;
  • ${MUSE_HOME}/enrich/index/index.xml;
  • ${MUSE_HOME}/z3950/MuseZBridge.properties

Note: Also configured in all Muse bridges that use the MNM: (${MUSE_HOME}//MuseBridge.xml and in ${MUSE_HOME}//MuseBridge.properties).

Note: This is the secured mode of the Muse HTTP server (SSL connections).

Warning: One of the server type ports Muse opens for its components may be occupied by other server programs. One
such example is the Ajp12 connector from Tomcat. See “${MUSE_HOME}/doc/Muse External Servlets Engine (Tomcat).pdf" manual for further reference regarding the ports used by Tomcat.

Warning: If one of the Muse Servers fails to start the user is advised to check the log file for detailed information.
Finding the message below in the log file means that the port is already used by some other Application. When such a
situation occurs a reconfiguration is necessary to change the port used by the respective Muse server or by the already
existing service.
Cannot listen on port . Address already in use: JVM_Bind

Note: Not all ports are required by all Muse installations. They are required only if the corresponding components are installed. For example, port 9797 is only required if the Muse Proxy is installed.

Note: All server type ports can be remapped. The best way to accomplish this remapping is by using the Muse PostInstall Configuration package, which makes this process simple and ensures that the correct files are updated.

Further information about this can be found in the "$MUSE_HOME/doc/Muse Advanced Configuration.pdf"document, “Server Type Ports Opened by Muse within Internet Scope” chapter.

Load More