IBM BPM Advanced - Process Inspector, no go-go

I saw this: -

The attempt to establish a secure connection to the server has failed. See <a href="../../../BPMHelp/topic/com.ibm.wbpm.admin.doc/topics/troubleshooting_hostname_failure.html" target="_blank">SSL fails when host name configuration fails</a> for details.

when attempting to access Process Inspector, via Process Admin, in IBM BPM Advanced 8.5.5.

I also saw this: -

[09/03/16 09:17:07:483 GMT] 00000137 BPMInspectorR W   Exception during request processing:
javax.servlet.ServletException: com.ibm.processinspector.rest.ProcessAdminRestException: The attempt to establish a secure connection to the server has failed. See <a href="../../../BPMHelp/topic/com.ibm.wbpm.admin.doc/topics/troubleshooting_hostname_failure.html" target="_blank">SSL fails when host name configuration fails</a> for details.
        at com.ibm.processinspector.server.handlers.ProcessInstanceSearchHandler.handleRequest(ProcessInstanceSearchHandler.java:309)

in the AppCluster SystemOut.log.

The solution was simple: -

Update the BPM Virtual Host configuration

Start WSAdmin Client

/opt/ibm/WebSphereProfiles/PSCell1Dmgr01/bin/wsadmin.sh -lang jython

List Existing Virtual Host(s)

print AdminConfig.list('BPMVirtualHostInfo')

(cells/PSCell1/clusters/AppCluster|cluster-bpm.xml#BPMVirtualHostInfo_1424775281789)

Remove Existing Virtual Host(s)

for i in AdminConfig.list('BPMVirtualHostInfo').split():
 AdminConfig.remove(i)

Create new Virtual Host

cellID=AdminControl.getCell()
dePath='/Cell:'+ cellID+'/BPMCellConfigExtension:/BPMDeploymentEnvironment:/'
de=AdminConfig.getid(dePath)
webserver_vh = AdminConfig.create('BPMVirtualHostInfo',de,[['name','webserver_vh'],['transportProtocol', 'https'], ['hostname', 'ihs.uk.ibm.com'], ['port','8443']],'virtualHosts')
AdminConfig.modify(de,[['defaultVH',webserver_vh]])
 
Validate Virtual Host

print AdminConfig.show(webserver_vh)

[hostname ihs.uk.ibm.com]
[name webserver_vh]
[port 8443]
[transportProtocol https]

Retrieve IHS Signer Certificate into WAS Cell-Default Trust Store

AdminTask.retrieveSignerFromPort('[-keyStoreName CellDefaultTrustStore -keyStoreScope (cell):'+cellID+' -host ihs.uk.ibm.com -port 8443 -certificateAlias IHS -sslConfigScopeName (cell):'+cellID+' ]')

Save and sync

AdminConfig.save()

AdminNodeManagement.syncActiveNodes()

Quit

quit

Restart AppCluster

clusterName="AppCluster"
AdminControl.invoke('WebSphere:name='+clusterName+',process=dmgr,platform=common,node=dmgr,version=8.5.5.4,type=Cluster,mbeanIdentifier='+clusterName+',cell='+cellID+',spec=1.0', 'stop')
AdminControl.invoke('WebSphere:name='+clusterName+',process=dmgr,platform=common,node=dmgr,version=8.5.5.4,type=Cluster,mbeanIdentifier='+clusterName+',cell='+cellID+',spec=1.0', 'start')

The job, she's a good 'un