Steps to deploy web console

Redeploying the IIAS web console container

This section outlines a method for redeploying the IIAS Web Console container using Podman and a build artifact from Fixed Central.

Procedure:

  • SSH into the cluster host:
    ssh root@{cluster-hostname}
  • Log in to the head node:
    ssh node0101
  • Disable the web console container:
    ap apps disable WebConsole
  • Stop the Platform Manager:
    apstop -p
  • Stop and rename existing web_console container using Pod man.
    podman stop web_console
    podman rename web_console old_console
  • After this, please verify Exited and updated name of web_console. For example:
    [root@sail62-t14-n1 ~]# podman ps -a
    CONTAINER ID  IMAGE                                                                                                   COMMAND         CREATED            STATUS                       PORTS       NAMES
    7b93cc83f60e  localhost/ibmdashdb/common:v11.5.9.0-ppc64le                                                                            5 days ago         Up 2 hours                               dashDB
    c657fd7ad5d7  localhost/callhome/release-1.0.31.0:1.2.0.0-ppc64le                                                     /usr/sbin/init  4 days ago         Up 2 hours                               callhome
    a6c332239f61  docker-na-public.artifactory.swg-devops.com/hyc-dsp-docker-local/ibmdashdb/common:latest-console-ppcle                  About an hour ago  Exited (137) 46 seconds ago              old_console
    [root@sail62-t14-n1 ~]#
    [root@sail62-t14-n1 ~]#
  • Create a working directory and navigate to it:
    
    mkdir /root/10310_SB_Webconsole
    cd /root/10310_SB_Webconsole
    
  • Download the build artifact from Fixed Central.
  • Verify the file is present:
    ls -ltrh /root/10310_SB_Webconsole
    Example:
    [root@sail62-t14-n1 ~]# ls -ltrh /root/10310_SB_Webconsole/
    total 2.8G
    -rw-r-----. 1 root root 2.8G Aug 19 03:25 web_console-1.0.31.0-202508082029-common.ppc64le.tar.gz
    [root@sail62-t14-n1 ~]#
  • Deploy the Web Console container using apinit:
    Syntax:
    apinit web_console -f /root/10310_SB_Webconsole/<web_console_tar> -e /opt/ibm/appliance/storage/head/dashdb.env -d --bringdown
    Example: If tar name is webconsole_20250808_2029-console-ppcle.tar.gz
    /opt/ibm/appliance/platform/container-api/bin/apinit web_console -f /root/10310_SB_Webconsole/webconsole_20250808_2029-console-ppcle.tar.gz -e /opt/ibm/appliance/storage/head/dashdb.env -d --bringdown 
  • If apinit takes longer than expected, check logs:
    
    cd /var/log/appliance/apupgrade/
    

    Look for log files starting with apinit and the latest timestamp.

  • Start the Platform Manager:
    apstart -p
  • Enable the Web Console:
    ap apps enable webconsole