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
- You must have read and write privileges on the directory where
you plan to install or upgrade Data Studio web console.
- If you are upgrading an earlier version of IBM® Data
Studio Health Monitor, make sure that
you run the installation program as the same type of user, administrative
or non-administrative, that you used when you installed the earlier
version of the software.
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
valuesOption |
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:
- If you are upgrading an earlier version of Data Studio Health Monitor, do the following
tasks to prepare to upgrade:
- 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 .
- 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.
- Run the installation program by using one of the following
options:
Option |
Description |
Install by using the installation wizard |
- Open the command line and use it to open the directory of the
installation image for Data Studio web console.
- 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.
- 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 |
- Open the command line and use it to open the directory of the
installation image for Data Studio web console.
- 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.
- Complete the questions in the console window.
The console indicates whether the installation is successful.
|
Data Studio web console is
installed.
- 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.