Installing the Business Administration UI

Use this procedure to install the Business Administration UI. Administrators can use the Business Administration UI to manage certain elements of the MDM operational server without having to manually modify properties files or database tables.

Before you begin

Before installing the Business Administration UI, ensure 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 user applications installation worksheet.
You have IBM WebSphere® Application Server installed and running.
If you are upgrading from an earlier version of the application and have custom settings in your property files, make a copy of the files.

About this task

The Business Administration application can be installed on either a server or workstation. It can also be installed on a remote machine by choosing a remote WebSphere Application profile.

Restriction: This application is not supported for use with a Microsoft SQL Server database.

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 InfoSphere MDM including the Business Administration UI 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 Business Administration UI panel, deselect the option Skip entering installation input data for Business Admin 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 Business Administration UI 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.

What to do next

To access the Business Administration UI after it has been installed and started, navigate your web browser to the following URL (replacing <hostname> and <port> with the appropriate values): https://<hostname>:<port>/CustomerBusinessAdminWeb/faces/login.jsp

Learn more about using Business Administration UI by reviewing the related concept.