How to Avoid an unexpected reboot of your Agent when you have deployed a package and specified that the user should be logged off.

Document ID : KB000027728
Last Modified Date : 14/02/2018
Show Technical Document Details

Symptoms:

With Software Delivery (USD) it is possible to specify that the users should be logged off before the job is run. This involves the use of the USD logon shield.

The Logon shield can either be configured to always logoff users prior to any package install or to logoff as required by individual jobs.

If you have never used the logon shield before and you specify in the job options that the user should be logged off prior to execution this can result in the agent rebooting before the job executes on the agent computer.

The reason for this is that the logon shield requires a GINA (sxpgina.dll which will be chaining with other GINA'S) but this is not installed on the agent PC when the USD agent is.

Instead it is installed when the Logon Shield is first configured.

The installation of a replacement GINA will require a reboot.

Therefore if you have never before used the Logon Shield and you configure the job option "Logoff User" in the "Bootlevel before execution" then the agent PC will actually reboot in order to install the GINA and then enforce the logoff until the job has run.

 

Environment:                                     

CA Client Automation - All Versions

 

Resolution:

To avoid this you should configure the Logon Shield prior to submitting a job with the "logoff User" defined in the job options.

To do this you simply need to run the USD agent procedure

Logon Shield: Enable per job

This procedure is provided by CA by default.

If you wish to do this for a single agent then you can right click in the USD agent installation item for this agent and select "Schedule Configure Job - Logon Shield: Enable per job" and set Procedure Job option "Bootlevel after execution -> Restart Machine"

Figure 1

Once this job has been run the agent will reboot and the GINA will be installed. Now when you use the job option "Logoff User" no further reboot is required to enable this.

If you wish to run this against multiple agents then simply expand the USD agent library item and you will find this listed in the procedures. You can then deploy this procedure as you would any package via USD.

 

Additional Information:                     

TEC312853 (Configuring Software Delivery to Support Third-Party GINA Applications) contains other relevant information pertinent to this article.