FAQ

Most Popular

The .cpb file describes the search capabilities of a source. The .pmf is the pre-mapping file that allows administrators to map search/index attributes that apply before the Muse ISR stylesheet is used to format the search for the source (thus “Pre”-mapping). The .cpb file lists all the search indexes and Boolean operators which are supported by the Source (whatever the actual, native syntax of the attribute). It is also a place where other source capabilities could be added later for easy import into the Muse InfoBase. The search limiter sets are one example. The .pmf file provides a mapping from one attribute in ISR to one attribute in translator. The .pmf mapping is TO an attribute which is handled into the ISR translator. All of the attributes handled (supported) in the ISR translator have been automatically extracted and recorded into the appropriate section in .cpb file. By default, the PMF files map unsupported attributes to keyword.

MuseGlobal provides three methods for search and retrieval of EBSCOhost content.

  • Z39.50
  • HTTP
  • EBSCO Integration Toolkit (EIT)

Where applicable, the preferred method of access is via EIT. This is a SOAP-based Web Service approach which provides the optimal combination of performance and completeness. You can find the EIT Source Packages by searching in your Muse Console’s “Add Sources” section in the “IDs Containing” field for the term EIT. EIT SPs have Source IDs which start with the string EBSCOEIT.

URLs:

The HTTP Source Packages for EBSCO search on the URL
http://search.ebscohost.com/. The EIT Source Packages use
http://eit.ebscohost.com/Services/SearchService.asmx as the Home URL and Search URL.

AUTHENTICATION:
Authentication for the EBSCOEIT Source Packages is two-fold.

1) Authentication for search and retrieval can done by user/pw (with the USER_NAME and USER_PASSWORD fields of the profile) or IP (with the CUSTOM_PARAMETERS field of the profile).

For search/retrieval authentication by IP, a value must be placed in the CUSTOM_PARAMETERS tag from the EBSCOEIT* source profile. Again, this is used to connect to and search a certain database. Using this IP authentication, you may be authenticated to a number of databases.

Example :
<CUSTOM_PARAMETERS>AUTH_TYPE=ip;IP_PROFILE=eit;
IP_ADDRESS=1.2.3.4</CUSTOM_PARAMETERS>

where : IP_ADDRESS=your IP which authenticates to EIT.

Please note that your EBSCO account must be specifically enabled in order to use of EIT. The user/pw used for connecting to http://search.ebscohost.com/ will not work for EIT. Also note that the IP_PROFILE will be either eitor eitws; — this string matches the 3rd section of your 3-part EIT authentication string (ex. s123456.main.eit or s123456.main.eitws). Please check with EBSCO if you are not sure which it is.

2) The aforementioned authentication by IP or user/pw gives us access to the EBSCOEIT API, but it does not provide successful link navigation on the record links obtained.

For this, the PROXY_HOST and PROXY_PORT in the profile must be configured. IMPORTANT: authentication to EBSCO for link navigation is only done by IP.

Example :
<PROXY_HOST>proxy.you.com</PROXY_HOST>
<PROXY_PORT>9797</PROXY_PORT>

So, in conclusion, 2 IP authentication settings are needed: one (user/pw or IP) for accessing and searching the EBSCOEIT database desired and the other one (proxy IP) to successfully navigate on the record links obtained.

Questions about your EIT account status should be referred to Gregory Julien [GregoryJulien@ebscohost.com].

Categories: Muse Search, Sources

You can configure LDAP authentication as a single authentication method. The steps are:
– copy the ${MUSE_HOME}/use/ice/profiles/ICELoginModuleLDAP.xml file into the application which is to be configured, into the ${MUSE_HOME}/home/ApplicationID/profiles/ folder, where replace ApplicationID with the exact application ID you wish to configure with LDAP authentication.
– configure the necessary Muse login modules for the application. Below is their list in the correct order along with the correct flag values:
– ICELoginModuleXML – required;
– ICELoginModuleParametersRemap – required;
– ICELoginModuleLDAP – requisite.
The configuration of the login modules is done through the Muse Console for Applications Administration as follows: select the desired application from the list of applications and click on the left menu – “Login Modules”; from this location manage the login modules: add, delete or edit them. The ICELoginModuleParametersRemap login module must have the following attributes and values: ldapUserPwd=”wwwAuthPwd” ldapUserID=”wwwAuthID” .
– Configure the properties of the ICELoginModuleLDAP login module:
– in the MCAA console select the desired application from the list of applications and click on the left menu – “Login Modules” and in the “Login Modules” panel click on the “Edit” link from next to the ICELoginModuleLDAP entry;
– in the editor page change the value for the “config” field from the default "${ICE_HOME}/profiles/ICELoginModuleLDAP.xml" to
${MUSE_HOME}/home/ApplicationID/profiles/ICELoginModuleLDAP.xml
where replace ApplicationID with the exact application ID you wish to configure with LDAP authentication.
– click the “Update” button;
– click the “Edit Config File” and configure the elements specific to the LDAP server, such as LDAP-URL, BASE-DN…etc.
– Create a login page where the enduser will enter his/hers LDAP credentials to login into the application:
– create a backup copy of the ${MUSE_HOME}/web/www/logon/ApplicationID/index.html file, where replace ApplicationID with the exact application ID you wish to configure with LDAP authentication.
– edit the ${MUSE_HOME}/web/www/logon/ApplicationID/index.html file, locate the line:

and replace the content from below that line until the line

with







User Name:
Password:
 


where replace the 2 ApplicationID occurrences with the exact application ID you wish to configure with LDAP authentication and ApplicationPassword with the right password.
– the access URL for authenticating with LDAP credentials in this application is:
http://MUSE_SERVER:MUSE_PORT/muse/logon/ApplicationID/
where replace ApplicationID with the exact application ID you wish to configure with LDAP authentication

Under $ICE_HOME/, there is a script called “version”. Running this script will allow you to see what version of ICE you are running. The version of the ICE server also tells you the Muse version.
This can be run as a normal script on a Unix based Operating Systems ($ICE_HOME/version) or from a Command Prompt window under Windows Operating Systems (%ICE_HOME%/version.bat).

There is a more comprehensive script in Muse which prints out the version of all installed Muse components and tools called startSystemInformation. This script is available only if the “Muse Admin Bridge” product is licensed. It can be run as a normal script on a Unix based Operating Systems ($USE_HOME/tools/startSystemInformation) or from a Command Prompt window under Windows Operating Systems (%USE_HOME%/tools/startSystemInformation.bat).

Categories: Muse Search, Tools

Load More

Latest

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 the MCAA console (reommmended). Login into the MCAA console from an already allowed IP address and follow the below steps:

  • Access the Users top menu;
  • From the Users page access the left menu item – Muse Authentication and Authorization Users;
  • In the new page select the mcaa user (or the desired administrator user from the list) and click the left menu item – Edit Access Rules;
  • In the Edit Access Rules pop-up page, click an Insert link corresponding to the last entry from the list;
  • For the new item that was added, edit the IP value and add the desired IP address. When done click the Update button.
2. Manually by editing the IP rules file on disk.
  • Access the Muse server remotely, the access method differs, depending on the Operating System (RDP/VNC/TeamViewer, etc. for Windows based systems, SSH/VNC, etc. for Linux based systems);
  • Edit the file ${MUSE_HOME}/aas/hosts.xml file.
  • Locate the USER_RULE section corresponding to the mcaa user (or the desired administrator). It should look like: mcaa
  • Add next to the existing IP rules a new entry as following: Your_IP_Address, where replace Your_IP_Address with the actual IP address value.
Before saving the changes, the file must be double checked for not breaking it, since it is a XML file.

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 required passwords="${ICE_HOME}/profiles/passwords.xml";
};

The entry must be modified to look like below:
AppID {
com.edulib.ice.security.authentication.ICELoginModuleXML required passwords="${ICE_HOME}/profiles/passwords.xml" justUser="true";
com.edulib.ice.security.authentication.ICELoginModuleIP sufficient hosts="${ICE_HOME}/profiles/hosts.xml";
com.edulib.ice.security.authentication.ICELoginModulePPMS required xmldbLocation="xmldb:exist:http://admin:@localhost:8000/xmldb/exist/xmlrpc";
};

(the 8000 port must be adjusted accordingly as per the Tomcat’s installation port)

2) Add the allowed IP(s) for the IP authentication

Login into the MCAA console, select the application from the list (AppID) and click on the “Login Modules” left menu. In the login modules listing click the “Edit” link corresponding to the ICELoginModuleXML module. In the new panel click the “Insert” link and start adding the IP(s). Consult the available help details to see the accepted format entries.

3) Make the end-user interface changes

Login into the MCAA console, select the application from the list (AppID) and click on the “Application General Settings->Interface Options” left menu link. In the Branding tab, “Login Page” section, press the “Load remap U/P Form”, then click the Update button from the bottom of the page.

4) Enable the “My Account” functionality

Login into the MCAA console, select the application from the list (AppID) and click on the “Application General Settings->Interface Options” left menu link. In the Functionality tab, locate the My Account” section and enable the “Enable Account:”, “Enable Saved Searches” and “Enable WorkRoom” features.

From this moment the “IP on campus/personal account off campus” authentication workflow should work, the access URL to use is:

 http://hostname:port/muse/logon/AppID/autologin.html

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 pre-configured the following filters:
CONTENT_TYPE=Journals;STARTING_YEAR_PUBLICATION=2010;

To use any of the above SPs you need an API key from IEEE, to get it follow the steps below:

1) Register for an account on the IEEE Developer website: https://developer.ieee.org/

2) Apply for an API key.

Once you have the API key you must configure it through the Muse Console for Applications Administration (MCAA) in the “Custom Parameters” section, as value for the API_KEY parameter.

Categories: Muse Search, Sources

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 -type xml

where replace HTTP_SERVER_PORT with the actual value (8000 default).

Note *: that the “backup” folder is created by the converter tool. Wait for the converter to finish. You may see some errors on screen as it runs. This is normal, as the database is corrupt and some documents from the database won’t be recovered.
Note **: The Local InfoBase maintains local information about the Source Packages installed in the Muse System. Documents that aren’t recovered will be evident in the Consoles as Source Packages in the Console’s Status tab SP list with missing installation date, version, and Test Status information. This information will be restored the next time these Source Packages are updated.
Note ***: if the database is so corrupt that the Converter tool does not even start, please refer to the special note at the end of this question.
3. Stop HTTP Server (Muse HTTP or Embeded Tomcat, depending on your Muse version). Wait for it to finish; verify it is stopped using “ps” command.
4. Backup the previous database location:
- mv $MUSE_HOME/xmldb/db $MUSE_HOME/xmldb/db.TIMESTAMP

- mkdir $MUSE_HOME/xmldb/db
5. Start HTTP Server (Muse HTTP or Embeded Tomcat, depending on your Muse version). Allow a few seconds (5-10) for the servers to start.
6. Restore the database content from the backup you made in step #2 above:
- cd ${MUSE_HOME}/xmldb
- ./startConverter -src file:/tmp/backup -dst xmldb:exist:http://admin:@localhost:8000/xmldb/exist/xmlrpc -type xml

Special note:
If the Converter tool at step #2 above does not start, follow the next steps:
a) Stop HTTP Server (Muse HTTP or Embeded Tomcat, depending on your Muse version).
b) Delete the files matching the *.log and *.lck patterns from ${MUSE_HOME}/xmldb/db. This typically means running the commands:
- rm -f $MUSE_HOME/xmldb/db/*.log
- rm -f $MUSE_HOME/xmldb/db/*.lck

c) Start HTTP Server (Muse HTTP or Embeded Tomcat, depending on your Muse version).
d) Continue with the #2 above.

- mv $MUSE_HOME/xmldb/db $MUSE_HOME/xmldb/db.TIMESTAMP

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 to recover an unclean database. For this to work correctly, all database operations must be logged to a journal file.

To add the recovery parameter, one must follow these steps:

a) make a backup for the ${MUSE_HOME}/xmldb/webapps/exist/WEB-INF/conf.xml file;

b) edit the ${MUSE_HOME}/xmldb/webapps/exist/WEB-INF/conf.xml file and just before the ““(no quotes) add the lines from below:


c) Restart Apache Embedded Tomcat server.

Load More