FAQ Category: Installation

The out-of-the-box signing and encryption key named only4test must not be used in production for generating new metadata for the setup of SAML authentication. A new key pair with long-term (e.g. 10 years) validity must be generated and stored into the ${MUSE_HOME}/proxy/webcontexts/ssoRWP/WEB-INF/classes/security/samlKeystore.jks keystore. Oracle Java keytool or other Certificate Management GUI tools such as CERTivity…

The default logger configuration of Muse Proxy is to produce *.log.1, *.log.2…*.log.10 files which rotate by size when reaching 10485760 bytes or at midnight, depending on whichever condition is first met: <LOGGER enable=”true” flush=”15000″ name=”default”>  <DEBUG>NOTICE</DEBUG>  <LOG_CLASS>com.edulib.ice.util.log.ICETextLog</LOG_CLASS>  <LOG>${MUSE_HOME}/proxy/logs/MuseProxy.log</LOG>  <LOG_SIZE>10485760</LOG_SIZE>  <LOG_FORMAT>{0, date,yyyy-MM-dd’T’HH:mm:ss.SSS z} {1}: {4}: {3}</LOG_FORMAT>  <LOG_MAX_BACKUP_INDEX>10</LOG_MAX_BACKUP_INDEX>  <LOG_TIME_INTERVAL>24</LOG_TIME_INTERVAL>  <LOG_SCHEDULED_ROTATION hour=”0″ minute=”00″ type=”daily”/> </LOGGER> <LOGGER enable=”true” flush=”15000″…

In production we recommend to use Azure Active Directory with SAML (ADFS). Theoretically there are no special requirements for integration with Azure Active Directory SAML , however this is a multi-step configuration which involves a lot of communication between the Muse Proxy technical team and the customer’s technical team. The customer must create a new…

We strongly recommend to access the Muse Proxy service securely over HTTPS. This is required because almost all content vendor platforms accessed through Muse Proxy rewriting are using the secure protocol, and the same level of security must be matched by Muse Proxy as well. Furthermore, the rewriting of some platforms may not work without…

We encountered cases on some Windows distributions when the Muse Proxy Windows Service fails to start, usually an error like below can be found in the Windows Event Viewer: “The LoadLibrary function failed for the following reason: The specified module could not be found.” The fix consists in adding into the Path system environment variable…

Certain kinds of Antivirus software automatically change the extension when downloading a file with exe extension via HTTP (eg. muse-win32.exe is renamed to muse-win32.1.2D0D17.efw). You should just rename the file to muse-win32.exe and run the executable. More details about the .efw extension are available here: http://www.fileinfo.net/extension/efw

One can specify an IP address for Muse Proxy to listen on for connections. By default, Muse Proxy listens on all IP addresses, on all interfaces. This setting can be changed in the ${MUSE_HOME}/proxy/MuseProxy.xml file by specifying an IP address in the “<BINDADDRESS>” field.

For Muse Proxy service to correctly work on Windows 64-bit systems you must install Muse Proxy either using the muse-proxy-setup.jar file or the executable file (muse-proxy-win32.exe). In the latter case you must set JAVA_HOME environment variable to the location of the 64-bit Java. If no JAVA_HOME is defined and there are both 32-bit JAVA and…

Follow these steps to install the new Muse Proxy version: – stop the Muse Proxy – delete the content of the ${MUSE_HOME}/proxy/cache directory. IMPORTANT: Do not delete the directory itself, only its content. – copy and dearchive the attached file “proxy.zip” in ${MUSE_HOME} directory – start the Muse Proxy