Environment

ControlPoint 5.x

Situation

Sometimes in certain scenarios eg. unexpected shut down, upgrade, .etc ; ControlPoint and IDOL Services may fail to start, when looking at Health Check, this error can be seen:

"Unable to connect to remote server"

Resolution

First, go to: Program Files\Micro Focus\ControlPoint\LicenseServer

Open license.log, if this error is seen:

"Your License has expired"

Then go to: https://sld.microfocus.com/mysoftware/download/downloadCenter

And request a new Licensekey.dat file

Performing a License Reset should resolve the error in both normal case and License Expired case:

Note: the process should be done outside working hours and each step should be taken very carefully

Back up > Remove licensekey.dat file from LicenseServer folder:

Program Files\Micro Focus\ControlPoint\LicenseServer

Stop order for services (regardless of architecture/number of machines):
========================================

Stop any connectors first:

ControlPoint FileSystem Connector
ControlPoint FileSystem Connector Framework

etc

Then stop in this order (order important):

ControlPoint Metastore
ControlPoint Distributed Connector
ControlPoint IDOL
ControlPoint OGS
ControlPoint DataAnalysis Store
ControlPoint Content
ControlPoint LicenseServer

Then stop (order not important):

ControlPoint Controller
ControlPoint Controller Agent
ControlPoint SQL Agent
ControlPoint Engine
ControlPoint Licenser Service
ControlPoint Redirector

Check no processes listed in task manager are still lingering such as :
agentstore
category
community
dih
dah
view
connectors etc

If so kill them.

Delete via explorer these folders:
Program Files\Micro Focus\ControlPoint\LicenseServer\uid
Program Files\Micro Focus\ControlPoint\LicenseServer\\license

Delete via explorer these folders:
Program Files\Micro Focus\ControlPoint\Indexer\FileSystem Connector\uid
Program Files\Micro Focus\ControlPoint\Indexer\FileSystem Connector\license

Delete via explorer these folders:
Program Files\Micro Focus\ControlPoint\Indexer\FileSystem Connector Framework\uid
Program Files\Micro Focus\ControlPoint\Indexer\FileSystem Connector Framework\license

Repeat for any other connectors you may have.

Delete via explorer these folders:
Program Files\Micro Focus\ControlPoint\Indexer\IDOL\uid
Program Files\Micro Focus\ControlPoint\Indexer\IDOL\license

Invoke command prompt as administrator
Change directory to Program Files\Micro Focus\ControlPoint\Indexer\IDOL\agentstore
Type: _cleanup.bat
Delete via explorer these folders:
Program Files\Micro Focus\ControlPoint\Indexer\IDOL\agentstore\uid
Program Files\Micro Focus\ControlPoint\Indexer\IDOL\agentstore\license

Invoke command prompt as administrator
Change directory to Program Files\Micro Focus\ControlPoint\Indexer\IDOL\community
Type: _cleanup.bat
Delete via explorer these folders:
Program Files\Micro Focus\ControlPoint\Indexer\IDOL\community\uid
Program Files\Micro Focus\ControlPoint\Indexer\IDOL\community\license

Delete via explorer these folders:
Program Files\Micro Focus\ControlPoint\Indexer\IDOL\category\uid
Program Files\Micro Focus\ControlPoint\Indexer\IDOL\category\license

Delete via explorer these folders:
Program Files\Micro Focus\ControlPoint\Indexer\IDOL\dah\uid
Program Files\Micro Focus\ControlPoint\Indexer\IDOL\dah\license

Delete via explorer these folders:
Program Files\Micro Focus\ControlPoint\Indexer\IDOL\dih\uid
Program Files\Micro Focus\ControlPoint\Indexer\IDOL\dih\license

Delete via explorer these folders:
Program Files\Micro Focus\ControlPoint\Indexer\IDOL\view\uid
Program Files\Micro Focus\ControlPoint\Indexer\IDOL\view\license

Delete via explorer these folders:
Program Files\Micro Focus\ControlPoint\Indexer\Metastore\uid
Program Files\Micro Focus\ControlPoint\Indexer\Metastore\license
Program Files\Micro Focus\ ControlPoint\Indexer\Metastore\actions
Program Files\Micro Focus\ ControlPoint\Indexer\Metastore\archive
Program Files\Micro Focus\ ControlPoint\Indexer\Metastore\ingestfailed

Delete via explorer these folders:
Program Files\Micro Focus\ControlPoint\Indexer\IDOL\Distributed Connector\uid
Program Files\Micro Focus\ControlPoint\Indexer\IDOL\Distributed Connector\license

Delete via explorer these folders:
Program Files\Micro Focus\ControlPoint\Indexer\OGS\uid
Program Files\Micro Focus\ControlPoint\Indexer\OGS\license

Delete via explorer these folders:
Program Files\Micro Focus\ControlPoint\Indexer\Content\uid
Program Files\Micro Focus\ControlPoint\Indexer\Conten\license

Repeat for any other components not listed such as additional content engines etc.

Invoke command prompt as administrator
Change directory to Program Files\Micro Focus\ControlPoint\Indexer\Statistics
Type: _cleanup.bat
Delete via explorer these folders:
D:\Program Files\Micro Focus\ControlPoint\Indexer\IDOL\statistics\uid
D:\Program Files\Micro Focus\ControlPoint\Indexer\IDOL\statistics\license
 

Copy licensekey.dat (use the new licensekey.dat if it's License Expired) back to Program Files\ Micro Focus \ControlPoint\LicenseServer

Restart license server service.
Checked it started ok by inspecting its license.log

Then try starting each content engine one by one
If none start due to license not being acquired clean these files to allow license to be requested
e.g.
delete license folder
delete uid folder
delete *.lck

Then restart each content engine.
Checked they started ok by inspecting license.log

Start order (regardless of architecture/number of machines):
========================================

First start these (order important):

ControlPoint LicenseServer
ControlPoint Content
ControlPoint DataAnalysis Store
ControlPoint OGS
ControlPoint IDOL
ControlPoint Distributed Connector
ControlPoint Metastore

Then start (order not important):

ControlPoint Controller
ControlPoint Controller Agent
ControlPoint SQL Agent
ControlPoint Engine
ControlPoint Licenser Service
ControlPoint Redirector

Finally start your connectors:

ControlPoint FileSystem Connector
ControlPoint FileSystem Connector Framework

etc

Next, go back to ControlPoint Admin Page > perform Health Check > The issue should be resolved.

Access article on support portal