SAS DataFlux Accelerator for Materials Data Classification 5.1 -------------------------------------------------------------------------------- Patch 1 - November 2013 -------------------------------------------------------------------------------- This patch contains files and instructions to allow the Accelerator for Materials Data Classification (MDC) 5.1 run correctly on the following systems: - SAS DataFlux Data Management Platform 2.3 - SAS DataFlux Data Management Platform 2.4 - SAS DataFlux Data Management Platform 2.5 The Accelerator for MDC 5.1 was originally designed and tested on Data Management Platform 2.2 and upgrading that software to a newer version requires the following modifications to your environment. SAS DataFlux Data Management Platform 2.3 ----------------------------------------- No changes are needed to your Data Management Platform 2.3 environment to allow the Accelerator for MDC 5.1 to run correctly. It has been successfully tested and validated on Data Management Platform 2.3. SAS DataFlux Data Management Platform 2.4 SAS DataFlux Data Management Platform 2.5 ----------------------------------------- When using Data Management Platform 2.4 or 2.5, you must also update your Accelerator for MDC 5.1 web application. This involves shutting down your application server, moving new files into place and restarting the application server. These instructions will describe this process for Apache Tomcat (other application server environments will differ from what is referenced here but the process is similar). Please do the following: 1. Stop your Apache Tomcat Server. On Microsoft Windows systems, this can either be done through the Control Panel > Administrative Tools > Services application, where you can use the Stop Service command after selecting the Apache Tomcat service, or it can be done using the Stop service command of the Windows status area Apache Tomcat service application that you may have installed with the Apache Tomcat server. 2. Navigate to the following directory of your Tomcat application server: ..\Apache Software Foundation\[Tomcat version]\webapps 3. Copy the classmgr.war file and the classmgr directory to another location. You will not need these any more but you may want to keep them in case you need to revert to the original version of the Accelerator for MDC 5.1. 4. Copy the classmgr.war file that was delivered with this patch into the Tomcat webapps directory. 5. Restart the Apache Tomcat server using a technique similar to one of those described in step 1. Wait 2 minutes and then stop the server again. This will unpack the Classification Manager web application into a classmgr directory in the Tomcat webapps directory. 6. Navigate to the following location to update configuration settings for the Classification Manager web application: ..\Apache Software Foundation\[Tomcat Version]\webapps\classmgr\WEB-INF 7. Open the web.xml file with a text editor, scroll to the bottom and update the integrationServerAddress entry and the dfAuthServerAddress entry, providing values that point to your Data Management Server and your Authentication Server respectively. If you are unsure of these values, look in the version of this file that you copied in step 3 and copy those values to this new file. 8. Save the file. Be sure when saving the file to keep the file encoding the same. Some text editors will change the encoding upon a file save operation. 9. Navigate to the following location to modify log file settings: ..\Apache Software Foundation\[Tomcat Version]\webapps\classmgr\WEB-INF\ classes 10. Open the log4j.properties file with a text editor and modify the following line, replacing the directory path with one that is more convenient for you: log4j.appender.mdc.File=c:\temp\mdc5_0.log 11. Save the file. Be sure when saving the file to keep the file encoding the same. Some text editors will change the encoding upon a file save operation. 12. Restart the Apache Tomcat server again using a technique similar to one of those described in step 1. Wait a few minutes to allow the application server to start up the Accelerator for MDC web application. 13. Your system has been updated and is now ready for use.