Installing Enterprise Viewer

Use this procedure to install InfoSphere® MDM Enterprise Viewer. This web application is used to search for and view member records in a virtual MDM configuration.

Before you begin

Make sure that you meet these prerequisites:

Your environment meets the hardware and software requirements for this component.
You completed the IBM® Installation Manager preparation steps.
You reviewed and completed the MDM user applications installation worksheet.
You have IBM WebSphere® Application Server installed and running.

About this task

You have two options available for installing a user application: install a new deployment using IBM Installation Manager or modify an existing deployment using a madconfig script. The install option assumes that you are installing the application on a clean server or workstation. That means that the server or workstation does not have any InfoSphere MDM components that are already installed (for example the MDM operational server, database component, or another user application). If any InfoSphere MDM components are present on the machine on which you are installing the application, you must use the Modify_MDM madconfig target.

Procedure

To install a new InfoSphere MDM including the Enterprise Viewer component:
1. Start IBM Installation Manager and select Install.
2. Continue through the panels to accept the license agreement, select the installation directory, and the language.
3. On the Enterprise Viewer panel, deselect the option Skip entering installation input data for Enterprise Viewer UI. Click Next.
4. Enter the configuration information for the application.
5. Review the installation summary information and click Install.
6. Click Finish when the installation is complete and close IBM Installation Manager.
7. From a command line, navigate to MDM_INSTALL_HOME/mds/scripts and run the following command to open the installation configuration tool:
  - On Microsoft Windows operating systems:
```
madconfig Configure_MasterDataManagement
```
  - On Linux or UNIX based operating systems:
```
./madconfig.sh Configure_MasterDataManagement
```
8. Provide the details of your deployment as prompted by the installation configuration tool. The configuration tool will complete the configuration of your installation.
9. Open the IBM WebSphere Application Server Integrated Solutions Console (admin console) and verify that the application is deployed to the server specified during installation.
To modify an existing installation to add or remove the Enterprise Viewer component:
1. On the machine where you wish to add or remove components, open a command line, and browse to MDM_INSTALL_HOME/mds/scripts.
2. Run the following command to open the Modify MDM tool:
  - On Microsoft Windows systems, run
```
madconfig Modify_MDM
```
  - On Linux or UNIX systems, run
```
./madconfig.sh Modify_MDM
```
3. Follow the onscreen prompts to add or remove user interface components.
4. Open the IBM WebSphere Application Server Integrated Solutions Console (admin console) and verify that the application is deployed to the server specified during installation.

Results

When you install Enterprise Viewer, IBM Installation Manager updates the ContextManager.prop file with the host name, port, and valid user name and password that you provided on the installation configuration panel and deploys the Enterprise Viewer EAR to the target application server. During deployment, the application server unpacks the EAR content into an installed apps directory.

Connect to Enterprise Viewer by opening a browser and using this URL: https://host:port/accessweb

Last updated: 13 Dec 2016