FAQ

Most Popular

Load More

Latest

The “An error occured when list personal users for application applicationid: Personal Profile Management System will not be used because it could not be initialized. Probably xmldb location is not properly set. [Connection refused]” error is caused by a wrong port setting in MuseAdmin.xml file. Please check the $MUSE_HOME/admin/MuseAdmin.xml file, locate the tag and check if the port is the same as the one Muse HTTP server/Apache Tomcat (depending on the Muse version) is running on.

Not seeing the SPs related data, as status, version, install and build dates, can point an issue with the Local InfoBase.

The most comon issues that have these results are:

1) XMLDB corruption

For more information about this, please see the “How do I perform a backup/restore operation of the XML database?” (1019) FAQ.

2) InfoBase Bridge not started due to a port conflict

Muse InfoBase Bridge is using the 8005 port, so please check the Embedded Apache Tomcat logs to see if there are any entries of the form (which point a conflict):

Address already in use: JVM_Bind:8005

This port can cause a conflict if on the machine there is an external Apache Tomcat (or other software) running and listening on this port. In case of Apache Tomcat, the 8005 port is used for shutdown and it is configured in the $TOMCAT_HOME/conf/server.xml. For other servers, please consult their documentation.

The advice is to change the port of external Apache Tomcat or any other software (not Muse) to something else, eg: 8115, and restart that server and Embedded Apache Tomcat.

The ports that need to be locally accessible are:

1. 2100 – Muse Z39.50 Bridge

Configuration file: – ${MUSE_HOME}/z3950/MuseZBridge.xml

Note: This port works as a client for the Information Connection Engine (ICE) server, but it is also a server for all the Z39.50 clients connecting to it.

2. 2504 – Muse ICE Server

Configuration file: – ${ICE_HOME}/ICECore.xml

Files that contain references to this port:

${MUSE_HOME}/web/MusePeer.xml;

${MUSE_HOME}/use/tools/ICEClient.xml;

${MUSE_HOME}/z3950/MuseZBridge.properties

Note: This port is also configured in all Muse bridges used for the Muse ICE Server (in either one of the following two files) (${MUSE_HOME}//MuseBridge.xml and in ${MUSE_HOME}//MuseBridge.properties).
3. 2505 3000 – Muse ICE Server

Note: This is the control port for the Muse ICE Server. If it is not accessible, the next port is used, and so on. An error is retrieved if none of the ports up to 3000 can be opened.

4. 8001 8004, 8006 – Custom XML Bridges

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

5. 8005 – Muse Local Infobase Bridge

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

Files that contain references to this port: ${MUSE_HOME}/factory/SourceFactory.xml

Note: This port acts as a bridge, the communication protocol being XML.

6. 8007 – Muse Admin

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

Note: This port handles XML connections.

7. 8010 – Muse HTTP Server

Configuration file: ${MUSE_HOME}/http/MuseHTTPServer.xml or ${MUSE_HOME}/tomcat/conf/server.xml

Note: This is the Muse HTTP Server or Tomcat control port.

Note: If you want to access some of the above Muse services from the Internet or from machines other than localhost, then the port(s) corresponding to the desired service must be open to the machine making the request.

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

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.

If there is no proxy defined (Proxy Host field) in either the application level or Source Package level, then no proxy will be used, no matter the other proxy related settings (Proxy Port, Proxy PAC also) from either level.

Secondly, if there are proxy settings both at application level and at the Source Package level, then the Source Package ones will have priority over the application level ones.

Categories: Muse Search, Sources

Load More