Installing the Image service on Linux
You can install the Image service either on the same computer or on a different computer from where Cognos Analytics is installed.
The Image service supports Linux and Windows 10 platforms and requires Docker to be installed.
Before you begin
Install Docker or Podman on Linux before you install the Image service.
For more information, follow the procedures for one of these Linux distributions:
- Installing Docker CE for CentOS
- Installing Docker CE for Ubuntu
- Installing Docker Engine for Red Hat Enterprise Linux
- Install podman 4.1.1 or later
- Install podman-compose 1.0.4 or later
- Install and configure netavark container network stack
You must set the fully qualified domain in Cognos Configuration using the following procedure:
- In IBM Cognos Configuration, in the Explorer window, click Environment.
- Under the Dispatcher URI for external applications set the fully qualified domain name (FQDN) for the IBM Cognos Analytics server.
- Under the Gateway URI set the fully qualified domain name (FQDN) for the IBM Cognos Analytics server.
- Click File > Save.
- Restart the Cognos Analytics service.
- Download the IBM® Cognos® Analytics Server installer (11.2.4 and above) and Server repository from Passport Advantage.
- Double click the installer file.
- Follow the directions in the installation wizard to copy and install the files to your
computer. The folder cognos_installation_location/image-service contains two subfolders:
- image-service/scriptsTip: The folder image-service/scripts/unix contains all the scripts that you need to run.
Purpose build.sh Run this to rebuild the images. config.conf Edit this configuration file to change the Image service parameters. install.sh Run this to load and start the Docker containers. prune.sh Run this to remove old Docker images. start.sh Run this to start the Image service. stop.sh Run this to stop the Image service. uninstall.sh Run this to uninstall the Image service.
- Ensure that you have execute permissions for each script:
Type chmod -R u+x image-service/scripts/unix
- Navigate to the image-service/scripts/unix directory.
- Type ./install.sh
The install script runs.