FAQ Category: Muse Search

How do I configure my Muse Search Application with Azure AD SAML based authentication?

Follow the instructions from bellow for configuring the authentication for the Muse Search Application with Microsoft’s Azure Active Directory, using SAML. In this scenario, the Muse Search Application is the Service Provider (SP), while Azure AD is the Identity Provider (IDP). Generate the Service Provider Metadata Access the administration end point for SAML at an…

How to enable HTTPS access for my Muse Search Applications?

In the $MUSE_HOME/tomcat/docs/Apache Tomcat embedded within Muse.pdf manual, chapter “3.2.1.1 Secured Connections” you can find all details about securing the access to the Muse Embedded Tomcat server using SSL certificates. Basically you need to generate a keystore from the private key and certificate, and enable it into the Tomcat’s configuration file: $MUSE_HOME/tomcat/conf/server.xml by uncommenting or…

How can I add the new VPN IP for accessing the MCAA console?

The access into the Muse Administration Consoles such as the MCAA (Muse Console for Applications Administration) is secured by IP authentication, besides Username/Password. The access point for the MCAA console is: http(s)://your_Muse_host:Port/mmc/ There are 2 methods for adding a new IP as an allowed IP address from where the MCAA console can be accessed: 1. From…

“IP on campus/personal account off campus” authentication workflow

Below are the steps to enable and configure the “IP on campus/personal account off campus” authentication workflow for a MuseKnowledge Application. Note that they apply for versions starting with 7.6. 1) Configure the login modules. Edit the ${ICE_HOME}/jaas.config file, locate the application entry for which to make the settings (refered below ad AppID). It should look like below: AppID { com.edulib.ice.security.authentication.ICELoginModuleXML…

What Source I need to add for searching IEEE Xplore?

For searching IEEE content we provide Source Packages based on API, currently two are available for download in Muse Source Factory: 1) IEEEXploreAPIXML. This is a generic Source Package retrieving content without any filtering. 2) IEEEASPPXploreAPIXML. This is a Source Package specifically built to retrieve content from IEEE All-Society Periodicals Package. More exactly it has…

How do I perform a backup /restore operation of the XML database?

Follow these steps to backup and recover the database: 1. Login to the server as the user under which Muse runs. 2. Run the ${MUSE_HOME}/xmldb/startConverter tool to backup the database. For example, to dump the database from the server to /tmp/backup directory, you need to run: – cd ${MUSE_HOME}/xmldb – ./startConverter -src xmldb:exist:http://admin:@localhost:HTTP_SERVER_PORT/xmldb/exist/xmlrpc -dst file:/tmp/backup…

How can I prevent XMLDB corruption?

The eXist XMLDB can get corrupted after an unclean database shutdown. An unclean shutdown may be caused by power failures, OS reboots, or hanging processes that are subsequently killed. A good improvement was seen after adding the recovery parameter, which configures the journaling and recovery of the database. With recovery enabled, it is much easier…

Why do the Source installation date and the status fail to display on the Status page of the Source Console even when the search is successful?

The first step to try to resolve this issue is to update the Source(s) in question. If the installation date and status information still does not display after the Source(s) are updated, it is possible that the XML database is corrupted. Use our backup & restore utility to recover from this problem. This procedure is…

Where do I set email server details so that I can send Source Problem Reports from a Muse Administration Console to Technical Support?

The configuration file for setting the SMTP_HOST, SUPPORT_EMAIL (the email address where problems are reported) and other SMTP characteristics such as port, SSL/TLS, username/password, certificates, is $MUSE_HOME/admin/MuseAdmin.xml. A description for each SMTP property can be found in the comments area of the MuseAdmin.xml file and in the “Muse Administrator.pdf” manual. The email settings from this…

When I click the Personal Users link in the MCAA user I get an error.

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 <XMLDB> tag and…