====== CEC Agent (PK) Setup ======

A CEC (Central Electronic Complex) is, for our monitoring purposes, a p595 frame .

The CEC agent is pre-installed with the VIOS software so only needs to be configured.

The CEC agent needs to run on the frame it is monitoring, so has been configured on one of the DEV VIOS servers on each frame (VIOS1SD).

1. Login as padmin to the VIOS server (e.g b0038-vios1sd). 

2. List available agents on the VIOS server: 

  $ lssvc

3. List configuration information for the CEC agent: 

  $ cfgsvc –ls ITM_cec
  HOSTNAME
  MANAGING_SYSTEM
  CEC
  DIRECTOR_HOST_ADDRESS
  DIRECTOR_AUTHENTICATION
  DIRECTOR_PORT_NUMBER
  RESTART_ON_REBOOT
  MIRROR

4.Set the configuration values for the agent (DIRECTOR values are not required): 

  $ cfgsvc ITM_cec -attr Restart_On_Reboot=true hostname=itmprtem.unix.brm.pri
    managing_system=hmc2.brm.pri CEC=Server-9119-595-3-SN836830F mirror=itmprtemf.unix.brm.pri

5. On the HMC to get the authkey for the agent: 

  viosvrcmd -m Server-9119-595-3-SN836830F -p B0038-VIOS1SD -c "cfgsvc -key ITM_premium"

6. On the HMC add the authkey to the HMCs authorized_keys2 file: 

  $ mkauthkeys --add 'output from viosvrcmd'

7. On the VIOS server ensure that the known_hosts file exists with the correct permissions. 

  $ touch /home/padmin/.ssh/known_hosts
  $ chown padmin:system /home/padmin/.ssh/known_hosts
  $ ssh hscroot@hmc2.brm.pri (and confirm the ssh prompt)
  
8. On the VIOS server update the /opt/IBM/ITM/config/pk.ini file to add the following lines for agent autonomy mode:

  CTIRA_RECONNECT_WAIT=600
  CTIRA_PRIMARY_FALLBACK_INTERVAL=1500
  
9. On the VIOS server start the agent 

  $ startsvc ITM_cec
  Starting Premium Monitoring Agent for VIOS ...
  Premium Monitoring Agent for VIOS started

The startup may complain about being unable to establish authenticity but 
the agent but should still start.