Welcome to setup the Cognos installation guide

📦 1. Request Server with Extra Disk

Test Server: 100 GB additional disk

Prod Server: 500 GB additional disk

This disk is used to isolate Cognos data from the OS disk.

⚙️ 2. Base Server Configuration & Cognos Environment Setup

🔧 Script Location:

Scripts are in the bundle-setup-scripts.zip file.

Download from: bundle-setup-scripts.zip

📥 Steps:

unzip bundle-setup-scripts.zip cd bundle-setup-scripts/ chmod +x prepare-cognos-environment.sh server_base-setup.sh

🛠️ 2.1 Base Configuration

./server_base-setup.sh

Performs:

Hostname setup

SSSD & MFA config

Time zone setup

Root password reset

Note: Register server in PIM Console to create a secret.

🧪 2.2 Pre-Cognos Environment Setup

./prepare-cognos-environment.sh

Prepares:

Cognos user

ulimits

Directory structure

Permissions

Disk automounting

📁 3. Copy Cognos Software to Server

sudo cp analytics-installer-4.0.8-linuxx86.bin /home/cognos/ sudo cp casrv-12.1.0-2504161826-linuxi38664h.zip /home/cognos/ sudo chown cognos:cognos /home/cognos/* sudo chmod +x /home/cognos/analytics-installer-4.0.8-linuxx86.bin

🖥️ 4. VNC & X-Windows Installation

📜 Script:

Download: vnc-script.sh

🧾 Add to .bashrc (as cognos user):

export DISPLAY=:1

▶️ Execute:

chmod 755 vnc-script.sh ./vnc-script.sh

Choose option 1 for install

Set VNC password

Optionally launch Cognos Config Tool to generate xauth keys

📁 5. Create /tmp2 Directory

sudo mkdir -p /tmp2 sudo chown cognos:cognos /tmp2 sudo chmod 777 /tmp2

🧾 6. Update /etc/hosts

Example:

10.87.178.3 sj4-sl-cog05.preprod.sjc04.sos.ibm.com sj4-sl-cog05

🧠 7. Start GUI Mode Installation

Open VNC via MRemoteNG (port 5901)

Launch terminal → set variables:

export IATEMPDIR=/tmp2 export DISPLAY=:1

Run installer:

./analytics-installer-4.0.8-linuxx86.bin

Follow GUI steps:

Language: English

Accept license

Install to: /opt/ibm/cognos/analytics

Choose required components

📎 8. Post-Install Setup

🗂️ 8.1 Copy DB2 Certificate:

sudo cp db2EncryptTrafficECecdsaSHA384TestEvnCert0425.arm /opt/ibm/cognos/analytics/ sudo chown cognos:cognos /opt/ibm/cognos/analytics/db2EncryptTrafficECecdsaSHA384TestEvnCert0425.arm

📥 Source: Box Certs

🗃️ 8.2 Copy DB2 Drivers:

sudo cp db2jcc* /opt/ibm/cognos/analytics/drivers/ sudo chown -R cognos:cognos /opt/ibm/cognos/analytics/drivers/

📥 Source: Box Drivers

⚙️ 9. Launch Cognos Configuration Tool

sudo su - cognos export DISPLAY=:1 ./cogconfig.sh

If GUI doesn't launch, verify:

echo $DISPLAY

🌐 10. Network Requirements

🔓 60001: DB connectivity — SOSCS-2651

🔓 9334: NetScaler → Cognos — SOSCS-2653

🔓 636: bluepages.ibm.com — SOSCS-2654

✅ Installation Complete

You can now configure SAML, CM, and other Cognos services as per your environment.

🛠️ Troubleshooting: Missing libnsl.so.1

If you encounter an error launching cogconfig.sh, resolve by creating a symbolic link:

cd /opt/ibm/cognos/analytics/bin64/ ln -s ./libcogconfig_jni.so ./libnsl.so.1