Nav

Installing and Deploying MMC to WebSphere

This document describes how to install the production version of Mule Management Console to WebSphere. Note that you can also deploy Mule to a variety of other application servers or containers, such as Tomcat or JBoss. See Installing the Production Version of MMC for full details. 

Please https://www.mulesoft.com/support-and-services/mule-esb-support-license-subscription[contact the MuleSoft Support team] with any questions about downloading and deploying Mule Management Console.

Trial Version vs Production Version

Please note that if you have downloaded MuleSoft’s bundled runtime download – ESB with Mule Management Console (MMC) – it is appropriate for use only as an evaluation tool and is not considered production-ready. For installation instructions for the trial version, please see Installing the Trial Version of MMC.

Follow these instructions to install and configure your mmc.war file on WebSphere.

  1. Log in to the WebSphere server.

    WS-1

  2. Go to Applications > WebSphere Enterprise Applications, then click Install.

    WS-2

  3. Select Local file system, click Browse, select the mmc.war file to deploy, then click Next.

    WS-3

  4. Select Detailed to show all the installation options, then click Next.

    WS-4

  5. Review the Application Security Warnings, then click Continue.

    WS-5

  6. WebSphere presents a nine-step installation process. In Step 1, click Next.

    WS-6

  7. In Step 2, select the mmc module, then click Next.

    WS-7

  8. In step 3, click Next.

    WS-8

  9. In Step 4, select both boxes as shown, then click Next.

    WS-9

  10. In Step 5, again select both boxes as shown, then click Next.

    WS-10

  11. In Step 6, click Next.

    WS-11

  12. In Step 7, select the web module, then click Next.

    WS-12

  13. In Step 8, complete the context root (i.e : /mmc), then click Next.

    WS-13

  14. In Step 9, click Finish.

    WS-14

  15. WebSphere displays an installation screen.

    WS-15

  16. If the installation was successful you will see something like the following screen with a message that the application was installed successfully. Click Save in order to save it to the master configuration.

    WS-16

  17. After you have saved, you can see the application installed in Enterprise Applications, but it is not running. Before starting the application, additional configuration is needed. Click on the application.

    WS-17

  18. Click Class loading and update detection.

    WS-18

  19. Under Class loader order select the option Classes loaded with local class loader first (parent last), then click Apply.

    WS-19

  20. Click Save to apply the changes directly to the master configuration.

    WS-20

  21. If you didn’t configure the context root during the installation process, select the application and under Web module properties click Context root for Web Modules. Assign the value you want, then click OK.

    WS-21

  22. Your application status is now started.

    WS-22

Note that if you want to configure MMC to persist data on external databases, you should follow the instructions for the specific database, as described in the following pages:

In the above pages, the paths of the directories where configuration files reside are based on an example Tomcat installation. When working with config files, you should change the directory paths to suit your Websphere installation. The table below lists examples of config file locations, using the MS SQL Server for illustration.

web.xml

C:\Program Files\IBM\WebSphere\AppServer1\profiles\AppSrv01\installedApps\w2k3wasNode01Cell\mmc-console-sqlserver-3_4_2_war.ear\mmc-console-sqlserver-3.4.2.war\WEB-INF\web.xml 

tracking-persistence-mssql.properties

C:\Program Files\IBM\WebSphere\AppServer1\profiles\AppSrv01\installedApps\w2k3wasNode01Cell\mmc-console-sqlserver-3_4_2_war.ear\mmc-console-sqlserver-3.4.2.war\WEB-INF\classes\META-INF\databases\tracking-persistence-mssql.properties

mmc-mssql.properties

C:\Program Files\IBM\WebSphere\AppServer1\profiles\AppSrv01\installedApps\w2k3wasNode01Cell\mmc-console-sqlserver-3_4_2_war.ear\mmc-console-sqlserver-3.4.2.war\WEB-INF\classes\META-INF\databases\mmc-mssql.properties

Copy the sqlserver.jar into the following directory

C:\Program Files\IBM\WebSphere\AppServer1\profiles\AppSrv01\installedApps\w2k3wasNode01Cell\mmc-console-sqlserver-3_4_2_war.ear\mmc-console-sqlserver-3.4.2.war\WEB-INF\lib

sqlserver.jar is the ConnectJDBC type 4 driver for Microsoft SQL Server provided by IBM. If you use sqlserver.jar as described above, you do not need to use the JDBC driver provided by Microsoft (sqljdbc4.jar). For details, see Persisting MMC Data to MS SQL Server and the IBM documentation for data source minimum required settings for Microsoft SQL Server.

See Also

In this topic: