AAE Auto Login Best Practice Troubleshooting Guide[1]
User Manual:
Open the PDF directly: View PDF .
Page Count: 11
Download | |
Open PDF In Browser | View PDF |
Automation Anywhere Enterprise Auto-Login Best Practices & Troubleshooting Guide Specifications and Strategies Covered in this document are subject to change Contents Auto-Login Best Practices & Troubleshooting Guide ....................................................................................... 1 Contents ................................................................................................................................................... 2 Overview ...................................................................................................................................................... 3 1. 2. 3. 4. Best Practices to setup Auto Login Feature........................................................................................ 4 1.1 Fully qualified name ..................................................................................................................... 4 1.2 Legal disclaimer enabled .............................................................................................................. 4 1.3 One user per machine .................................................................................................................. 4 1.4 Running Services .......................................................................................................................... 5 1.5 Application Path on Local Machine.............................................................................................. 5 Best Practices to use Auto Login Feature ........................................................................................... 6 2.1 Scenario 1: Auto login with Log Off status of BOT runner machine (Most preferred) ................ 6 2.2 Scenario 2: Auto login with lock status of BOT runner machine ................................................. 6 Auto Login Troubleshooting................................................................................................................ 6 3.1 Diagnosis Utility ........................................................................................................................... 6 3.2 Running Diagnosis Utility ............................................................................................................. 7 3.3 Verify Auto-Login Utility............................................................................................................... 9 3.4 Verify Auto-Login Utility............................................................................................................... 9 3.5 Running Instance WinLogon.exe.................................................................................................. 9 3.6 DLLs ............................................................................................................................................ 10 Capability Matrix ............................................................................................................................... 10 Sales hotline: Toll Free (USA): 1.888.484.3535 International Customers: 1.408.834.7676 Address: PO Box 41363 San Jose, CA 95160 Url: automationanywhere.co Email: sales@automationanywhere.com Overview Automation Anywhere Enterprise provides the Auto-Login functionality by which a bot can automatically login into a machine, run the scheduled automation task and then restore the machine to its original locked/logged off state once the task is finished. The Auto-Login functionality thus enables unattended Robotic Process Automation; which ensures high BotRunner utilization and less idle time. This document provides information regarding best practices and steps to troubleshoot the Auto-Login feature when it fails to work as expected. Sales hotline: Toll Free (USA): 1.888.484.3535 International Customers: 1.408.834.7676 Address: PO Box 41363 San Jose, CA 95160 Url: automationanywhere.co Email: sales@automationanywhere.com 1. Best Practices to setup Auto Login Feature 1.1 Fully qualified name When providing the credentials in the Login Settings of Tools -> Options of AAE Client, ensure that you provide the fully qualified name (DOMAIN\UserName) in the Username field. For e.g. US-AA\john.smith 1.2 Legal disclaimer enabled If the Bot-Runner machine shows up a legal disclaimer every time when the user logs in, ensure that the ‘Bypass legal disclaimer’ is ticked in the Login Settings of Tools -> Options of AAE Client 1.3 One user per machine Ensure that the Bot-Runner machine has only one user logged in when the scheduled task is supposed to run. You can manage the users from the Task Manager -> Users tab of the Bot-Runner machine. Sales hotline: Toll Free (USA): 1.888.484.3535 International Customers: 1.408.834.7676 Address: PO Box 41363 San Jose, CA 95160 Url: automationanywhere.co Email: sales@automationanywhere.com 1.4 Running Services Ensure that AAESchedulerService and AAAutoLoginService are running on the Bot-Runner machine. You can check this from the Task Manager -> Services tab. 1.5 Application Path on Local Machine Ensure that the AAE application path is on the local machine. AAE application path on network drive or share drive is not recommended. You can verify/change this from the Advanced Setting section of Tools>Options in AAE Client. Sales hotline: Toll Free (USA): 1.888.484.3535 International Customers: 1.408.834.7676 Address: PO Box 41363 San Jose, CA 95160 Url: automationanywhere.co Email: sales@automationanywhere.com 2. Best Practices to use Auto Login Feature Automation Anywhere recommends 2 scenarios to use Auto Login feature as described below 2.1 Scenario 1: Auto login with Log Off status of BOT runner machine (Most preferred) 1. 2. 3. 4. 2.2 Connect to the BOT runner machine from BOT user machine. Configure Auto Login settings as described in ‘Best Practices to setup Auto Login Feature’ section. Log off the BOT runner machine. Open the control room from BOT user machine and then deploy or schedule a task to the BOT runner machine. Scenario 2: Auto login with lock status of BOT runner machine 1. 2. 3. 4. Connect to the BOT runner machine from BOT user machine. Configure Auto Login settings as described in ‘Best Practices to setup Auto Login Feature’ section. Lock the BOT Runner machine. Please do not disconnect or minimize remote desktop session. Open the control room from BOT user and then deploy or schedule a task to the BOT runner machine. Note: User needs to perform Step 1 and step 2 only for first time of user of BOT runner machine. BOT user will also require to change a password in Auto login configuration as and when earlier configured password changes. 3. Auto Login Troubleshooting 3.1 Diagnosis Utility We have built a utility which will identify the prerequisite needed for the Auto Login and will validate if all the needed access and rights are available. The utility checks for the Auto-Login prerequisites, if they do not exist then corresponding action is performed. Use below link to download the utility. http://www.automationanywhere.com/techsupport/Customers/Support/Utility/Autologin_Diagnose_Fix_ Utility.zip Once downloaded, unzip the utility and copy the files in the client folder at the installation path of AAE. (e.g. C:\Program Files (x86)\Automation Anywhere Enterprise x.x\Client ) Sales hotline: Toll Free (USA): 1.888.484.3535 International Customers: 1.408.834.7676 Address: PO Box 41363 San Jose, CA 95160 Url: automationanywhere.co Email: sales@automationanywhere.com 3.2 Running Diagnosis Utility a. Double click to run the AutologinDiagnoseUtility.exe. You might be prompted with “User Access Control” dialog. Click Yes to continue. b. Below screen will appear with the details. c. Click on Validate button. d. You will see green tick against each of the item listed provided all the validation criterial are satisfied. Sales hotline: Toll Free (USA): 1.888.484.3535 International Customers: 1.408.834.7676 Address: PO Box 41363 San Jose, CA 95160 Url: automationanywhere.co Email: sales@automationanywhere.com e. Following steps are performed by utility under Validate Credential Providers. Sr No Registry Key HKEY_LOCAL_MACHINE\SOFTWARE\ Microsoft\Windows \CurrentVersion\Authentication\Credential Providers\{75A22DF0B81D-46ed-B119-CD30507BD614} 1 HKEY_CLASSES_ROOT\CLSID\ {75A22DF0B81D-46ed-B119CD30507BD614} 2 3 HKEY_CLASSES_ROOT\CLSID\ {75A22DF0B81D46edB119CD30507BD614} \InprocServer32 4 Name Type Value (Default) String Value (REG_SZ) Automation.CredentialProvider (Default) String Value (REG_SZ) Automation.CredentialProvider (Default) ThreadingModel String Value (REG_SZ) String Value (REG_SZ) Automation.CredentialProvider.dll Apartment Also ensures that Automation.CredentialProvider.dll is present in the system32 (e.g. C:\Windows\System32); if not, copies it from the installation path (e.g. C:\Program Files (x86)\Automation Anywhere Enterprise x.x\Client) from the appropriate folder (32 or 64 bit) depending on the machine config. f. Sr No 1 Following steps are performed under Validate Credential Providers. Ensures that the Ctrl+Alt+Del registry is present, if not then creates them. Registry Key HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\ Windows\CurrentVersion\Policies\System\ Name Type Value SoftwareSASGeneration DWORD (Hexadecimal) 3 g. Following steps are performed under Validate SAS. Ensure that SAS.dll is present in the system32 (e.g. C:\Windows\System32) folder. If not, then copies the same from the product installation folder (e.g. C:\Program Files (x86)\Automation Anywhere Enterprise x.x\Client) from the appropriate folder (32 or 64 bit) depending on the machine config. h. Following steps are performed under Validate Settings. Ensures that the user has got administrative rights. Ensures that the Auto-Login service is running, if not then starts it. Sales hotline: Toll Free (USA): 1.888.484.3535 International Customers: 1.408.834.7676 Address: PO Box 41363 San Jose, CA 95160 Url: automationanywhere.co Email: sales@automationanywhere.com 3.3 Verify Auto-Login Utility a. Click the below link to download the utility http://www.automationanywhere.com/techsupport/Customers/Support/Utility/AutoLoginDebugUtilit y.zip b. Unzip the package and save it anywhere on the system. c. Enter the user name with domain and password and then click on Auto-Login button on the utility. d. Once you lock the machine, it should unlock itself immediately. e. If it does, then Auto-Login should work properly. f. If it does not, then the issue is with the Credential Provider dll. g. So, re-register the credential provider dll. h. To do so, navigate to the Client folder (e.g. C:\Program Files (x86)\Automation Anywhere Enterprise x.x\Client). i. Locate the Register.reg in client folder and double click the file to register the Auto-Login registry entries. j. The registry entries will be registered again. k. Restart the computer. 3.4 Verify Auto-Login Utility Ensure that the SoftwareSASGGeneration key is present in the registry with the value as shown: Sr No Registry Key Name Type 1 HKEY_LOCAL_MACHINE\SOFTWARE\ Microsoft\Windows\ CurrentVersion\Policies\System\ SoftwareSASGeneration DWORD 3 (Hexadecimal) Value If the above key is not there, create it manually and restart the machine. Ensure that there are no policies set on the system that will delete/modify this registry key. 3.5 Running Instance WinLogon.exe Ensure that there is only 1 running instance of WinLogon.exe in the Task Manager. If there are more than one, restart the machine. Sales hotline: Toll Free (USA): 1.888.484.3535 International Customers: 1.408.834.7676 Address: PO Box 41363 San Jose, CA 95160 Url: automationanywhere.co Email: sales@automationanywhere.com 3.6 DLLs Ensure that the following dlls are present in the system32 folder (e.g. C:\Windows\system32). If not, copy them from the installation folder (e.g. C:\Program Files\Automation Anywhere X.X\Client\32Bit OR from 64-Bit; depending on OS) to system32 folder. 1) 2) 3) 4) 5) 6) 7) 8) Automation.CredentialProvider.dll msvcp100.dll msvcp100d.dll msvcp110.dll msvcr100.dll msvcr100d.dll msvcr110.dll sas.dll 4. Capability Matrix The following table provides the capability matrix of the Auto Login feature under various OSes and scenarios. Results are based on testing done on AAE 10.1. OS Win 7 Win (32 Bit) 7 (64 Bit) Scenario Win 8 Win 8 (32 (64 Bit) Bit) Win 10 (64 Bit) Server Server Terminal Citrix 2008 2012 Server (Xen (64 Bit) (64 Bit) Desktop) Local Schedule + Lock Y Y Y Y Y Y Y Y Y Local Schedule + LogOff Y Y Y Y Y Y* Y* N N Local Schedule + LogOff + Legel Disclaimer Y Y Y Y Y Y* Y* N N Lock + Deploy Y Y Y Y Y Y Y Y Y NA NA NA NA NA NA NA N N LogOff + Deploy Y Y Y Y Y Y Y N N RDP + Lock + Deploy Y Y Y Y Y Y Y Y Y RDP + Disconnect + Deploy N N N N N N N N N RDP + Lock + Disconnect + Deploy N N N N N N N N N RDP + LogOff + Deploy Y Y Y Y Y Y Y N N Lock + Disconnect + Deploy Sales hotline: Toll Free (USA): 1.888.484.3535 International Customers: 1.408.834.7676 Address: PO Box 41363 San Jose, CA 95160 Url: automationanywhere.co Email: sales@automationanywhere.com OS Win 7 Win (32 Bit) 7 (64 Bit) Scenario Win 8 Win 8 (32 (64 Bit) Bit) Win 10 (64 Bit) Server Server Terminal Citrix 2008 2012 Server (Xen (64 Bit) (64 Bit) Desktop) RDP + Local Schedule + Lock Y Y Y Y Y Y Y Y Y RDP + Local Schedule + Lock + Disconnect N N N N N N N N N RDP + Local Schedule + Disconnect N N N N N N N N N RDP + Local Schedule + LogOff Y* Y* Y* Y* Y* Y* Y* N N VM + RDP + Lock + Deploy Y Y Y Y Y Y Y Y Y VM + RDP + Lock + Disconnect + Deploy N N N N N N N N N VM + RDP + Disconnect + Deploy N N N N N N N NA NA VM + RDP + LogOff + Deploy Y Y Y Y Y Y Y NA NA VM + Lock + Deploy Y Y Y Y Y Y Y NA NA VM + LogOff + Deploy Y Y Y Y Y Y Y NA NA VM + RDP + Local Schedule + Lock Y Y Y Y Y Y Y NA NA VM + RDP + Local Schedule + LogOff Y Y Y Y Y Y Y NA NA VM + RDP + Local Schedule + Lock + Disconnect N N N N N N N NA NA VM + RDP + Local Schedule + Disconnect N N N N N N N NA NA * - Issues faced inconsistently. Known Limitations: 1) Auto login will not work in LOGOFF mode on cloud VMs (Azure, Amazon, Verizon etc) 2) Auto login will not work in LOGOFF mode in Citrix and Terminal Server (Multi-user session systems) 3) Auto login will not work in DISCONNECTED RDP systems. Sales hotline: Toll Free (USA): 1.888.484.3535 International Customers: 1.408.834.7676 Address: PO Box 41363 San Jose, CA 95160 Url: automationanywhere.co Email: sales@automationanywhere.com
Source Exif Data:
File Type : PDF File Type Extension : pdf MIME Type : application/pdf PDF Version : 1.5 Linearized : Yes Author : Automation Anywhere Create Date : 2016:12:22 16:45:20+05:30 Modify Date : 2017:03:14 07:40:42-07:00 Subject : Best Practices Guide for the AutoLogin Feature Language : en-US Tagged PDF : Yes XMP Toolkit : Adobe XMP Core 5.4-c005 78.147326, 2012/08/23-13:03:03 Format : application/pdf Creator : Automation Anywhere Description : Best Practices Guide for the AutoLogin Feature Creator Tool : Microsoft® Word 2016 Metadata Date : 2017:03:14 07:40:42-07:00 Producer : Microsoft® Word 2016 Document ID : uuid:dd80d89a-23b0-4efb-9965-c6a954f15b3c Instance ID : uuid:2cef6bf5-b908-8846-a804-45d013501a73 Page Count : 11EXIF Metadata provided by EXIF.tools