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

Data Studio web console provides an installation wizard to install or upgrade the product.

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/DSWC4.1.1
With non-administrative user: $HOME/DSWC4.1.1

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\DSWC4.1.1
With non-administrative user: %USERPROFILE%\IBM\DSWC4.1.1

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 web console, version 3.2 or newer, 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 web console, the user ID and password can be the same that you used with Data Studio web console.
Port numbers

Default HTTP: 11086

Default HTTPS: 11087

Default control port: 11088

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

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

Procedure

To install or upgrade Data Studio web console:

  1. If you are upgrading from Data Studio web console version 3.2 or newer, stop the earlier version of Data Studio web console, if running:
    • Linux and UNIX: From the DSWC_installation_dir/bin directory, run the command stop.sh
    • Windows: From the Start menu, click All Programs > IBM Data Studio > Data Studio Web Console > Stop Web Console Server.
  2. Open the launchpad:
    • On Windows, run launchpad.exe or launchpad_win_nonadmin64.exe.
    • On other platforms, run launchpad.sh.
  3. Start the Installation Manager installer:
    • To install as an administrator, expand Install or Update Product and then click Administrative Installation or Update.
    • To install as a non-administrator, expand Install or Update Product and then click Non-administrative Installation or Update.
    If an update for Installation Manager is available, Installation Manager will update to the newest version and then restart.
  4. Complete the installer. Click Install to install a new instance of Data Studio web console, or click Update to upgrade an existing instance.
    Note: If you are upgrading from Data Studio web console version 3.2 to Data Studio web console version 4.1.1, you do not need to download any additional packages, so you can click Cancel at the Password Required prompt.
  5. Optional: If you installed a new instance of Data Studio web console, use the Data Studio Configuration Assistant to configure the product. Specify the default administrative user and the server ports. If you choose not to run the Data Studio Configuration Assistant after installing, you can run it later:
    • On Linux and UNIX: run DSWC_installation_dir/bin/config_DSWC.sh.
    • On Windows: from the Start menu, click IBM Data Studio > Data Studio Web Console > Configure the Data Studio web console.
    You do not need to run the Data Studio Configuration Assistant after upgrading Data Studio web console.
  6. Optional: To see the installation details, you can check the installation log files in the following directories:
    • On Linux and UNIX:
      • DSWC_installation_dir/logs/
      • /var/ibm/InstallationManager/logs/
    • On Windows:
      • DSWC_installation_dir\logs\
      • C:\ProgramData\IBM\Installation Manager\logs\

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