Using the solution installer

You use the solution installer to define your IBM® Predictive Maintenance and Quality environment you want to install.

You define the environment by identifying node computers and adding the software that you want installed on each node. You create an installation configuration for your solution by dragging nodes onto a canvas and then dragging components into the nodes.

You can save your configurations. For more information, see Saving and opening configurations.

You can also load predefined configurations. For more information, see Using a predefined configuration.

Important: The solution installer runs on Google Chrome 44 or later or Mozilla Firefox 38 or later. It does not run on Internet Explorer.

For more information about supported software, see the IBM Software Product Compatibility Reports (www.ibm.com/support/docview.wss?uid=swg27041626).

Procedure

  1. Open the solution installer in a web browser.

    After the solution installer is running, you can access the URL from any computer from a Firefox or Chrome web browser.

    The URL is https://servername:8080/UI/index.html, where servername is the name of the computer where you ran the solution installer.

    Important: Do not use a web browser on the computer on which you are running the solution installer or any computer on which a Predictive Maintenance and Quality component is being installed. You must use a web browser on another computer.

    Ensure that you are using an English language web browser to access the solution installer URL.

  2. On the license information page, click Accept.
    CAUTION:
    Declining the license allows you to uninstall the solution installer and remove all of the files from the solution installer directory.
  3. Select New Configuration, and click OK.
  4. From the Mandatory Software List pane, drag a Node object onto the Configuration Editor pane.

    If you are installing IBM Predictive Maintenance and Quality on four nodes, you must drag four Node objects onto the Configuration Editor pane.

    A visual representation of an empty node is displayed.

  5. In the Property Editor pane, select the node object, and enter the following information.
    1. Enter a name for the node in Name, and press the Enter key. For example, enter BI node.
    2. Enter the server name in Host Name, and press the Enter key.
      Important: Unless you are using a single node configuration, ensure that the host names or IP addresses are for different computers. Do not use the same computer for more than one Node object.
    3. Enter the user who has access to install the components in User Name, and press the Enter key. For example, enter root or a user with sudo permissions.
    4. Enter the user's password in User Password, and press the Enter key.
    5. Repeat these steps for each node object that you add. If you are installing IBM Predictive Maintenance and Quality on four nodes, you must repeat these steps for each of the four node objects.
    Important: You must enter any mandatory information for nodes and other objects as indicated. Ensure that you review all of the properties to ensure that the values, both mandatory and optional, are valid.

    Ensure that you press the Enter key after you type a value for a property.

  6. From the Mandatory Software List pane, create your environment by dragging each object onto the appropriate node in the Configuration Editor pane.
    Tip: Valid drop zones are indicated in the Configuration Editor pane.

    Some restrictions are built into the placement of the objects. For example, if you are adding IBM Cognos BI Server to a node, then you must already have WebSphere Application Server on that node, and the IBM Cognos BI Server object must be placed within the WebSphere Application Server object.

    Image shows the BI node with the required components.
    Tip: Example environments are provided in the predefined configurations that are included with the installation files. For more information, see Using a predefined configuration.
    Note: If you add the IBM DB2 Data Server Runtime Client component to the same node as the IBM DB2 Enterprise Server component, the IBM DB2 Data Server Runtime Client component will not be installed.
  7. After you add an object, select it, and modify any values in the Property Editor pane.

    When you add WebSphere® Application Server to a node, you must provide the following information:

    • WebSphere Install Directory is the location where WebSphere Application Server is to be installed.
    • WebSphere Application Port is the port number that you want to use for WebSphere Application Server.
    • WAS Profile Admin User Name is the administrator user's user name for WebSphere Application Server.
    • WAS Profile Admin Password is the password for the administrator user.
    Image shows the required configuration properties for the WebSphere Application Server component.
    Important: Ensure that you press the Enter key after you type a value for a property.
  8. From the Optional Software List, drag the objects to the node on which you want the installation files copied. The optional software is not installed by the solution installer. You must install the software manually. The installation files are copied to the node you drag them to.

    Unless you change the default path, the optional software installation files are copied to the /opt/IBM/OptSoftware directory on the node computer.

  9. As you build your environment, click Validate to identify errors or incomplete information.
  10. After all nodes are defined and each node is validated, click Run.
    Important: After you click the Run button, do not close the browser window until the installation completes. If you close the browser, you cannot re-initiate the session.

    However, the installation does proceed even with the browser closed. But you cannot monitor the progress.

    If the browser window closes, do the following steps:

    1. Do nothing until enough time elapses to allow the installation to complete. Allow the installation at least 2 hours to complete.
    2. Open a new browser window, and open the solution installer again.
    3. Re-create the configuration that you used or open the saved session that you used. You must ensure that all of the values that you entered in the fields are the same as the configuration that you used when the browser window closed.
    4. Rerun the installation. The solution installer verifies that all of the components are installed.

      After the solution installer completes, verify that the components are working. For more information, see Test the installation.

    Tip: If you click Validate before all the mandatory content is added, a message indicates that the node is not valid. For example, if you validate the BI Node before you add the IBM DB2 Data Server Runtime Client component, then a message indicates that the node is not yet valid.
Parent topic: Install the Predictive Maintenance and Quality servers