IBM DB2 Genius Hub can be installed on Windows using either the Command Line Interface (CLI) or the Graphical User Interface (GUI).
Installation using CLI package
This guide walks you through downloading, installing, and configuring IBM Db2 Genius Hub on a Windows machine via the command-line interface (CLI) and GUI.
Step 1: Download CLI Installation Package
- Open your browser and navigate to the IBM Support Fix Central portal:
IBM.com/support/fixcentral
- In the Product selector search bar, type Genius Hub and select IBM Db2 Genius Hub from the results.
- Select the latest version to install.
- Select the platform:
- Select Windows 64-bit, x86 (or Windows) and click Continue.
- Choose your search option:
- Select Browse for fixes and click Continue.
- Select below installation type for CLI installation:
- Select ibm-db2GeniusHub-1.1.2.0-win and click Continue.
- Select preferred option to download , e.g. Download using your browser (HTTPS) and click Continue.
- Review the Terms and Conditions and click I Agree.
- Click the zip file link (ibm-db2GeniusHub-1.1.2.0-win.zip file, ~2.32 GB) to start downloading.
- Locate the downloaded .zip file on your Windows machine.
- Extract the contents of the zip file to your preferred directory.
Step 2: Run the Command-Line Installer
- Open the extracted folder and navigate inside it.
- Open a Command Prompt window as an Administrator within this folder directory.
- Run the setup batch script by typing: setup.bat
- On the welcome screen, select your installation path from the three options:
- Perform a new installation of IBM Db2 Genius Hub
- Upgrade the existing IBM Db2 Intelligence Center to IBM Db2 Genius Hub
- Upgrade from IBM Db2 Data Management Console to IBM Db2 Genius Hub
Note: For a new setup, enter 1 and press Enter.
- Accept the License Agreement:
- Enter 1 to accept the license agreement and press Enter.
- Configure the Administrative Credentials:
- Enter your preferred default administrative User ID (e.g., admin).
- Enter and re-enter your password when prompted.
- Press Y to confirm and proceed with this configuration.
- The installer will begin starting the Genius Hub core services.
Note : If you have WSL already installed on your machine, in that case, you can skip Step 3 and 4.
Step 3: Complete Post-Installation Setup (WSL & Redis)
Because the agentic model inside IBM Db2 Genius Hub depends on WSL (Windows Subsystem for Linux) and Redis, an interactive user session and system restart are required.
- Allow the installer to finish checking setup configurations for WSL and Redis.
- When prompted, press Enter to continue.
- A notification will inform you that a system restart is required to complete the Ubuntu/WSL configurations.
- Restart your Windows machine.
Step 4: Restart Genius Hub Services
After the machine restarts, the system will automatically start the WSL setup in a command prompt window. Once complete, manually restart the Genius Hub service:
- Open Command Prompt.
- Navigate to your IBM Db2 Genius Hub installation directory and enter the bin folder:
cd <Installation_Directory>\bin
- Stop the current running instance by running:
stop.bat
- Start the service again by running:
start.bat
(This initialization step usually takes 2 to 3 minutes).
Step 5: Access the Genius Hub Web Console
- Once the server start command completes, the terminal will display your direct HTTP / HTTPS Console URLs.
- Copy the URL into your web browser.
- Log in using the Admin credentials you set up during Step 3.
- Upon your first successful log-in, you will see a welcome screen asking you to configure your repository data to complete the final setup phase.
Video Demonstration
Installation using GUI package
Installing IBM DB2 Genius Hub on a Windows environment using the Graphical User Interface (GUI) installer is a straightforward process. This guide walks you through the step-by-step process—from downloading the necessary installation packages to completing post-installation setups like Windows Subsystem for Linux (WSL) and Redis.
Step 1: Download GUI Installation Package
- Open your browser and navigate to the IBM Support Fix Central portal:
IBM.com/support/fixcentral
- Search for IBM DB2 Genius Hub in the search bar.
- Select the latest version to install.
- Select the platform:
- Select Windows 64-bit, x86 (or Windows) and click Continue.
- Choose your search option:
- Select Browse for fixes and click Continue.
- Select below installation type for GUI installation:
- Select ibm-db2GeniusHub-1.1.2.0-win64-gui-install.zip and click Continue.
- Select preferred option to download , e.g. Download using your browser (HTTPS) and click Continue.
- Review the Terms and Conditions and click I Agree.
- Click the zip file link (ibm-db2GeniusHub-1.1.2.0-win64-gui-install.zip file, ~2.49 GB) to start downloading.
Step 2: Run the GUI Installer
- Extract the downloaded .zip file using Windows Extract All.
- Open the extracted folder and run IBM Db2 Genius Hub.exe.
- Accept the License Terms and click Next.
- Select Installation Type:
- Perform a new installation: Choose this option if performing a fresh install.
- Upgrade options: Choose the upgrade paths if migrating from IBM DB2 Intelligence Center or Data Management Console (DMC).
- Configure Admin Credentials:
- Enter the Administrator credentials for accessing the console.
- Default username is admin (can be updated as needed). Set and confirm a strong password.
- Configure Port Settings:
- Review the default HTTP and HTTPS ports.
- Keep the defaults or update them if those ports are already in use by other services on your machine.
- Click Next to begin the installation process.
Once complete, the installer displays the URLs to access the web console, along with a prompt indicating that a system restart is required to finish setting up background services.
Note : If you have WSL already installed on your machine, in that case, you can skip Step 3 and 4.
Step 3: Complete Post-Installation Setup (WSL & Redis)
After the initial GUI setup finishes, reboot your system to finalize the base installation.
1. Execute the Setup Script
Once the machine restarts, navigate to the installer resources directory in your command prompt (cmd):
cd <GH_installer_path>\resources\bin\addons\redis-bundle\setup-wsl.bat
Run setup-wsl.bat to launch the automated installer for Windows Subsystem for Linux (WSL) and Redis dependencies required by the agentic module.
2. Reboot and Finalize WSL Installation
- The script will instruct you to restart your computer. Reboot your system.
- Upon logging back in, the post-reboot setup window will automatically pop up.
- Follow the on-screen prompts (e.g., press any key when prompted) to allow the automated script to install Ubuntu and complete the WSL deployment.
Step 4: Restart Genius Hub Services
- Once the WSL environment is initialized, open Command Prompt as Administrator.
- Navigate to your installation directory containing the execution control scripts.
- Restart the services to ensure all modules load cleanly:
stop.bat
start.bat
(Alternatively, you can run restart.bat directly).
Wait a few minutes for all DB2 Genius Hub services and the web server to fully initialize.
Step 5: Access the Genius Hub Web Console
- Open your preferred web browser and navigate to the web server URL provided in the CMD console.
- Log in to Genius Hub Console using the admin credentials set during Step 2.
- Upon successful login, you will land on the Repository Database (Repo DB) setup page, where you can begin configuring monitoring rules, SQL statements, and database objects.
Video Demonstration
Understanding WSL's Role in IBM Db2 Genius Hub
WSL is a feature built into Windows that lets you run a native Linux environment right on your PC. Instead of dealing with the hassle of heavy virtual machines or dual-booting your computer, WSL lets Linux tools and backend services run smoothly and efficiently—right alongside your normal Windows apps.
Based on the official installation document provided for IBM Db2 Genius Hub on Windows, WSL is a critical requirement for running its underlying agentic models and Redis backend dependencies.
· Why it's needed: The agentic model and Redis-based caching layer within IBM Db2 Genius Hub rely on a Linux backend to execute background services efficiently on a Windows host.
· How it gets installed: Depending on whether you use the CLI or GUI installer, the setup wizard will either prompt you during the installation flow or require a post-installation script (setup-wsl.bat) to deploy the necessary Linux distribution (Ubuntu) and complete the WSL 2 configuration.
Summary
You have successfully installed IBM DB2 Genius Hub on Windows using your preferred approach (CLI or GUI), initialized the required WSL and Redis backend dependencies, and accessed the administration console!
References :
GUI Installation on Windows : https://www.ibm.com/docs/en/db2-genius-hub/1.1.x?topic=rsp-installing-db2-genius-hub-console-using-gui-windows
Command-line installation on Windows : https://www.ibm.com/docs/en/db2-genius-hub/1.1.x?topic=rsp-installing-db2-genius-hub-console-using-cli-windows
Windows Subsystem for Linux(WSL) : https://learn.microsoft.com/en-us/windows/wsl/
About the Author
Saurangi Kalantri is a backend and cloud developer specializing in Python, enterprise applications and cloud technologies. She brings strong expertise in IBM BYOC and IBM Db2 Genius Hub products, which she leverages to support customer adoption journeys as part of the Customer Adoption Engineering (CAE) team. Saurangi Kalantri can be reached out at saurangi.kalantri@ibm.com