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: 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 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.1.install-on-aix-ppc64.bin
- On Linux on System x® 64-bit:
- ./DSWC.v3.1.1.install-on-linux-x86_64.bin
- On Linux on System z® 64-bit:
- ./DSWC.v3.1.1.install-on-linux-s390x.bin
- On Windows 32-bit:
- DSWC.v3.1.1.install-on-windows-i386.exe
- On Windows 64-bit:
- DSWC.v3.1.1.install-on-windows-x86_64.exe
- On Solaris SPARC:
- ./DSWC.v3.1.1.install-on-solaris-Sparc.bin
- On Solaris x86-64:
- ./DSWC.v3.1.1.install-on-solaris-x86_64.bin
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.1.install-on-aix-ppc64.bin -i console
- On Linux on System x 64-bit:
- ./DSWC.v3.1.1.install-on-linux-x86_64.bin -i console
- On Linux on System z 64-bit:
- ./DSWC.v3.1.1.install-on-linux-s390x.bin -i console
- On Windows 32-bit:
- DSWC.v3.1.1.install-on-windows-i386.exe -i console
- On Windows 64-bit:
- DSWC.v3.1.1.install-on-windows-x86_64.exe -i console
- On Solaris SPARC:
- ./DSWC.v3.1.1.install-on-solaris-Sparc.bin -i console
- On Solaris x86-64:
- ./DSWC.v3.1.1.install-on-solaris-x86_64.bin -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.