How to manually install the SphereShield Maintenance Service?

From version 3.7.0 the Housekeeping service name was changed to Maintenance which runs as a separate service from the Admin Portal.

Installation:

Install the Maintenance Service

1.Move the 'MaintenanceService'  whose default location is:

C:\Agat\SphereShield.Setup\Payload\MaintenanceService

to


C:\Agat


2.Open CMD in 'MaintenanceService' folder and run the following command:

AccessPortal.MaintenanceService.exe install

After a successful installation, you should see the Maintenance service listed in the service window:


Permissions

Give Local Service read permission to

C:\ProgramData\Microsoft\Crypto\RSA\MachineKeys to

This is needed to allow decryption of connection string from Access Portal configuration.

You should also give Local Service Write/Modify permissions to 

C:\Agat\Logs

Add to Groups

Add Local Service to the following groups:

  • Administrators
  • RTC Component Local Group
  • RTC Server Local

This is needed for UCMA tasks like sending an IM.

Event Viewer

To enabling logging in the Event Viewer you will need to add a new source.
You can do that by typing in the following Powershell command:

New-EventLog -LogName 'Application' -Source 'AGAT SphereShield Maintenance Service'

Configuration

The configuration folder default location is:

C:\Agat\MaintenanceService\Configuration

In that folder you should edit the following files to suit your environment:

  • SphereShield.MaintenanceService.config
  • SphereShield.MaintenanceService.log4net.config


SphereShield.MaintenanceService.config

In that file, you should edit  the 'AccessPortalPath' to point to your Admin Portal folder


SphereShield.MaintenanceService.log4net.config

Here you can specify where the logs of the Maintenance Service will be saved.