Changing the default external port that is used for communication between MOI and MSS

Products

• Mainframe Operational Intelligence

Issue/Introduction

The default port, 61616, for external communication between MOI and MSS was causing a conflict in their environment.   The default port had been manually changed in the past in their MOI appliance but that change did not survive a required reinstall of the MOI 2.1.   The steps included in the Resolution section below detail how the default external port can be changed if required.    

 

Environment

Release : 2.1

Component : MF OPERATIONAL INTELLIGENCE

Resolution

How to change the external port for communication between MOI and MSS:

For the Message Service Server software:

• Stop the MSS STC
• Edit the ZMSENVT member in your MSS <your deployment HLQ>.CAW0OPTV  data set and make the port change to 61615.
• Start the MSS STC

 

For the MOI appliance software:

Stop the msgservicehub service in the MTCAC

Once it is stopped, perform the following steps:

       On your MOI appliance Linux machine, perform the following commands: 

        >  cd /opt/moi

        >   vi msgservicehub/normal/docker-compose.yml

                And change the ports section to look like this.  The first port on the uncommented line below is the EXTERNAL port

                and that should match with MSS.

                         

               Save your change via the ESC key, wq  command. 

       Then perform the following commands to put the port change into effect:

       > cd /opt/moi/moi-utils/scripts 

       > moi-shutdown

       After the moi-shutdown script completes, execute the following command:   

       >  docker ps -a   

       Verify that no services are displayed and if that is true, execute the following command: 

       > moi-startup

        Once the moi-startup script completes, execute the following command:   

       > docker ps -a 

       All services should have a healthy status in 10 to 15 minutes. 

       After that wait 10 minutes  and then please verify that new metric data values are being displayed in the MPMUI by choosing

                Differential Analysis and selecting a metric like z/os processor>CPU%>....    and viewing its Green Highway  

 

Use of the 61615 port for the interface between MOI and MSS should now be in effect from the MOI Appliance.