Installing or upgrading Data Studio web console by using the installation wizard or the console mode

Data Studio web console provides an installation wizard to install or upgrade the product. If you want to install the product on a computer that does not have a graphical user interface, you can install the product by using the console mode.

Before you begin

About this task

If you install the product as a Windows administrator, Data Studio web console is added as a Windows service. If you run the installation program as a non-administrative user, an administrative user can later install the Data Studio web console service manually by running the installservice.bat script from the DSWC_installation_dir/bin directory.

The following table lists the options that are available when you install the product and the default values for these options.

Table 1. Installation options and default values
Option Default values that are used for installation Comments
Installation directory: DSWC_installation_dir
Linux and UNIX default directories
With administrative user: /opt/IBM/DSWC
With non-administrative user: $HOME/DSWC

where $HOME is the environment variable that defines the home directory for the user that is running the installation program.

Windows default directories
With administrative user: C:\Program Files\IBM\DSWC
With non-administrative user: %USERPROFILE%\IBM\DSWC

where %USERPROFILE% is the Windows environment variable that defines the home directory for the user that is running the installation program.

To upgrade an existing version of Data Studio Health Monitor select the installation directory of the earlier product in the installer.
Default administrative user Default: admin Use the default administrative user to initially log in to the web console in single-user mode, and to perform certain web console administrative tasks. The default administrative user is separate from the other administrative users that are used with the product, such as database administrators.
Note: If you are upgrading an earlier version of Data Studio Health Monitor, the user ID and password can be the same that you used with Data Studio Health Monitor.
Port numbers

Default HTTP: 11083

Default HTTPS: 11084

Default control port: 11085

Use any unoccupied port in the range of 1024 to 65535.

Note: If you are upgrading an earlier version of Data Studio Health Monitor, you must provide all the port numbers for your installation.

Procedure

To install Data Studio web console:

  1. If you are upgrading an earlier version of Data Studio Health Monitor, do the following tasks to prepare to upgrade:
    1. Stop the earlier version of Data Studio Health Monitor, if running:
      • Linux and UNIX: From the DSHM_installation_dir/bin directory, run the command stop.sh
      • Windows: From the Start menu, click All Programs > IBM Data Studio > Stop Data Studio Health Monitor .
    2. Uninstall any manually installed Windows service. If you manually configured Data Studio Health Monitor to run as a Windows service, you must manually uninstall the service by running removeservice.bat from the DSHM_installation_dir/bin directory.
  2. Run the installation program by using one of the following options:
    Option Description
    Install by using the installation wizard
    1. Open the command line and use it to open the directory of the installation image for Data Studio web console.
    2. Run the following command:
      On AIX®:
      ./DSWC.v3.1.install-on-aix-ppc64.bin
      On Linux on System x® 64-bit:
      ./DSWC.v3.1.install-on-linux-x86_64.bin
      On Linux on System z® 64-bit:
      ./DSWC.v3.1.install-on-linux-s390x.bin
      On Windows 32-bit:
      DSWC.v3.1.install-on-windows-i386.exe
      On Windows 64-bit:
      DSWC.v3.1.install-on-windows-x86_64.exe

      The installation wizard opens.

    3. Complete the pages of the wizard.

    The wizard indicates whether the installation is successful, and if Data Studio web console started successfully. The installation program also gives you the option to open the web console at the completion of the wizard.

    Install by using the console mode
    1. Open the command line and use it to open the directory of the installation image for Data Studio web console.
    2. Run the following command:
      On AIX:
      ./DSWC.v3.1.install-on-aix-ppc64.bin -i console
      On Linux on System x 64-bit:
      ./DSWC.v3.1.install-on-linux-x86_64.bin -i console
      On Linux on System z 64-bit:
      ./DSWC.v3.1.install-on-linux-s390x.bin -i console
      On Windows 32-bit:
      DSWC.v3.1.install-on-windows-i386.exe -i console
      On Windows 64-bit:
      DSWC.v3.1.install-on-windows-x86_64.exe -i console

      The installation program starts in console mode.

    3. Complete the questions in the console window.

    The console indicates whether the installation is successful.

    Data Studio web console is installed.
  3. Optional: To see the installation details, you can check the installation log files:
    • On Linux and UNIX:
      • DSWC_installation_dir/logs/DSWCinstall_summary_timestamp.log
      • DSWC_installation_dir/logs/DSWCinstall_details_timestamp.log
    • On Windows:
      • DSWC_installation_dir\logs\DSWCinstall_summary_timestamp.log
      • DSWC_installation_dir\logs\DSWCinstall_details_timestamp.log
    Where timestamp is the date and time when you ran the installer and DSWC_installation_dir is the path to the installation directory you selected.

What to do next

If Data Studio web console is not already running, start it and log in to the web console by using the default administrative user that you created when you installed the product. If you upgraded your product, log in as a user with permission to access the web console.

Feedback