Control-D/WebAccess Server Installation

The Control-D/WebAccess Server installation installs Control-D/WebAccess Server Desktop and the Control-D/WebAccess Server Web Application, which enables you to access production reports on Control-D mainframe repositories via a Web browser in real time. The reports remain centrally stored, and as such, there is no need to replicate and send reports over the network to all potential Internet and Intranet users.

To ensure that Java libraries remain updated, Java library deliveries are decoupled from Control-D/WebAccess server and not part of the installation. For more information, see Control-D External Java Installation.

Before you install the WebAccess Server, verify that your operating system and database software is compatible with the current version of Control-D/WebAccess Server, as described in Control-D/WebAccess Server Compatibility for Version 9.0.21.100

The following procedures describe how install and uninstall Control-D/WebAccess Server on UNIX and Windows.

• Installing Control-D/WebAccess Server on UNIX

• Installing Control-D/WebAccess Server on Windows

• Uninstalling Control-D/WebAccess Server on UNIX

• Uninstalling Control-D/WebAccess Server on Windows

Installing Control-D/WebAccess Server on UNIX

This procedure describes how to install Control-D/WebAccess Server on UNIX.

Before You Begin

Before you install Control-D/WebAccess Server, you need to complete the following procedures:

• Configuring a User Account on UNIX: Describes how to configure specific parameters for Control-D.

• Setting Environment Variables in UNIX: Describes how to set environment variables in UNIX, which enables you to see messages from the console.

• Setting the Java Environment Variable Describes how to set the Java environment variable, which points to an external Java installation.

Begin

1. Login as the Control-D/WebAccess Server administrator.

2. Copy the installation files from the temporary directory that you created in Obtaining Control-D/WebAccess Server installation files, to the home directory.

3. Set your DISPLAY environment variable, as described in Control-D Pre-Installation Procedures on UNIX.

4. From your home directory, type the following command:

   <source_path>/setup.sh

5. Do one of the following:

   • Interactive install: Continue with the on-screen instructions until the installation is complete.

     The installation log is saved to the following location:

     <waInstallFolder> /BMCINSTALL/log/BMC_ Control-D_WebAccess_Server_Install_ date.time>. log

   • Automatic install: Create a parameter file and then run the automatic install in a non-interactive mode:

     1. Continue with the on-screen instructions until the Summary window.

     2. Click Generate and select the location to create the XML parameter file.

     3. Click Yes to quit the installation.

        A confirmation message appears.

     4. Click Yes.

     5. Copy the automatic installation parameters file to a network location that is accessible to all computers where you want to do an automatic installation.

     6. To run the installation script, type the following command:

        <source_path>/setup.sh -silent <xml_path>/filename.xml>

        Type the following command to encrypt the password when you install Control-D/WebAccess Server:

        <source_path>/setup.sh -encrypt <password>

     7. The installation log is saved to the following location:

        <waInstallFolder>>/BMCINSTALL/log/BMC_Control-D_WebAccess_Server_Install_<date.time>.log

     Control-D/WebAccess Server is successfully installed on your computer.

Installing Control-D/WebAccess Server on Windows

This procedure describes how to install Control-D/WebAccess Server on Windows.

Before You Begin

Before you install Control-D/WebAccess Server, you need to complete the following procedures:

• Setting the Java Environment Variable: Describes how to set the Java environment variable, which points to an external Java installation.

• Ensure that your operating system is compatible with the current version of Control-D/WebAccess Server, as described in Control-D/WebAccess Server Compatibility.

Begin

1. Log in to the computer using a user ID that has Administrator permissions.

2. Copy the installation files from the temporary directory that you created in Obtaining Control-D/WebAccess Server installation files, to the home directory.

3. From a command prompt window, type the following command:

   <source_path>>\setup.exe.

4. Do one of the following:

   • Interactive install: Continue with the on-screen instructions until the installation is complete.

     Parameters for the custom installation option are listed in Internet Access Method installation parameters.

     Unicode encoding is especially useful in locales that require double-byte character encoding, that is, when reports to support East Asian (CJK) languages.

     The installation log saved to the following location:

     <waInstallFolder>>\BMCINSTALL\log

   • Automatic install: Create a parameter file and then run the automatic install in a non-interactive mode:

     1. Continue with the on-screen instructions until the Summary window.

     2. Click Generate and select the location to create the XML parameter file.

     3. Click Yes to quit the installation.

        A confirmation message appears.

     4. Click Yes.

     5. Copy the automatic installation parameters file to a network location that is accessible to all computers where you want to do an automatic installation.

     6. Log in using a user ID that has Administrator permissions on the current computer.

     7. Type the following command:

        <source_path>\setup.exe -silent <xml_path>\<filename.xml>

        Type the following command to encrypt the password when you install Control-D/WebAccess Server:

        source_path>\setup.exe -encrypt password>

     8. The installation log is saved to the following location:

        <installFolder>>\BMCINSTALL\log\BMC_Control-D_WebAccess_Server_Installdate-time>.log

     Control-D/WebAccess Server is successfully installed on your computer.

Uninstalling Control-D/WebAccess Server on UNIX

This procedure describes how to Control-D/WebAccess Server components from UNIX.

Begin

• Type the following command to uninstall Control-D/WebAccess Server:

  <waInstallFolder>/BMCINSTALL/uninstall/Control-D_WebAccess_Server_UnInstall>/uninstall.sh [-silent]

The uninstallation log is saved to the Control-D/WebAccess home folder.

Control-D/WebAccess Server is successfully removed from your computer.

Uninstalling Control-D/WebAccess Server on Windows

This procedure describes how to uninstall Control-D/WebAccess Server from Windows.

Before You Begin

Ensure that all jobs have ended.

Begin

• Do one of the following:

  • Interactive uninstall:

    1. From the Start menu, select Settings.

    2. Select Apps, and then select Apps & Features.

    3. Select Control-D/WebAccess Server 9.0.21.000, and click Uninstall.

    4. Click OK to continue.

       Control-D/WebAccess Server is successfully removed from your computer.

  • Automatic uninstall: Type the following command:

    <waInstallFolder>\BMCINSTALL\uninstall\<LPnumber>\uninstall.exe -silent

  The uninstallation log is saved to the following location:

  <waInstallFolder>/BMCINSTALL/log/BMC_Control-D_WebAccess_Server_UnInstall_<date.time>.log

  Control-D/WebAccess Server is successfully removed from your computer.

Logging in to Control-D/WebAccess Server Web Application

This procedure describes how to log in to Control-D/WebAccess Server Web Application.

Begin

1. Open a web browser.

2. Type the URL provided to you.

   Validate the server is trusted when a warning message appears that the URL is not secure.

3. Do the following:

   • In the User Name field, type your username.

   • In the Password field, type your password.

4. (Optional) Select the Filter reports during log in checkbox.

   The Filter Report List panel appears when you log in.

5. (Optional) From the Host drop-down list, select the required repository.

   Control-D/WebAccess Server connects to the selected repository.

6. (Optional) From the Change Language drop-down list, select the required language.

7. Click Login.

   You are logged in to Control-D/WebAccess Server

Logging out of Control-D/WebAccess Server Web Application

This procedure describes how to log out of Control-D/WebAccess Server Web Application.

Begin

• From the Home page in the upper right corner, select the Connected to drop-down list, select Logout.

  You are now logged out of Control-D/WebAccess Server. To log-in, see Logging in to Control-D/WebAccess Server Web Application.

Logging in to Control-D/WebAccess Server Desktop

This procedure describes how to log in to Control-D/WebAccess Server Desktop.

Begin

1. Open the Control-D/WebAccess Server Desktop application.

2. Do the following:

   • In the User field, type your username.

   • In the Password field, type your password.

3. From the Connection Name drop-down list, select one of the following options:

   • Local connection.

   • Extra connection.

4. Click OK.

   You are now logged in to Control-D/WebAccess Server Desktop.

Logging out of Control-D/WebAccess Server Desktop

This procedure describes how to log out of the Control-D/WebAccess Server Desktop.

Begin

• From the File drop-down list, select Exit.

  You are now logged out of Control-D/WebAccess Server Desktop. To log-in, see Logging in to Control-D/WebAccess Server Desktop.