Windows Agent Deployment
Transcription
Windows Agent Deployment
LabTech Windows Agent Deployment WINDOWS AGENT DEPLOYMENT ................................................................................................................................................................................................................................................................................................................................................. 1 Overview ................................................................................................................................... 1 What Method Should I Use to Deploy Agents? .................................................................... 1 What is Required Before I Deploy? ....................................................................................... 2 Client Administrative Settings ............................................................................................... 2 Agent Deployment Settings.................................................................................................... 4 Downloading the Agent Installation File ............................................................................... 6 Agents Deployed via Login Script ......................................................................................... 8 Agents Deployed Manually ..................................................................................................... 9 Agents Deployed via GPO ...................................................................................................... 9 Agents Deployed via Probe Push ........................................................................................ 10 Agents Deployed by LabTech Deployment Script ............................................................. 25 Using the Deployment Script to Deploy to a Specific IP ................................................... 27 Agent Installation via Network Devices .............................................................................. 28 Agent Installation on Server Core 2008 .............................................................................. 30 Agent_Install.exe Command Line Parameters ................................................................... 30 Troubleshooting .................................................................................................................... 30 Network Probe Scan Not Successful ................................................................................ 30 Partial LabTech Reinstall Fix ............................................................................................ 31 .NET Cleanup .................................................................................................................... 32 LTAgent not checking in/offline ......................................................................................... 32 Agent Duplicating in Control Center.................................................................................. 32 Document Revision History.................................................................................................. 32 Overview LabTech agents are client applications that run as a service on a computer, and enable it to report into your LabTech server for reporting, monitoring, script execution, etc. Computers running the LabTech agent are sometimes referred to as agent computers, remote computers or just remotes. Before you deploy agents, the client and location must be configured in LabTech. The LabTech agent can be deployed through several methods. The agent may be installed on the workstation or server manually, through a login script, by group policy (GPO) or pushed by the network probe. What Method Should I Use to Deploy Agents? The environment to which you are deploying to should determine the best distribution to use. Here are some guidelines to consider when choosing which method to use: 1A.51.155.WindowsAgentDeployment.docx 1 Windows Agent Deployment Figure 1: Deployment Suggestions What is Required Before I Deploy? Clients and Locations must be set up and configured, including the Passwords and Deployment & Defaults tab. Default template needs to be configured. If using custom templates, at least one needs to be configured for deployment. .NET Framework 2.0 (minimum) is required for the installer to run; if you are not using the probe (the probe will automatically install .NET). LabTech recommends using version 3.5, SP1. Verify AV Exclusions: o For folders: Add %windir%\ltsvc | %windir%\temp\ltcache | %windir%\temp\_ltupdate o For file exclusions: Add %windir%\ltsvc\lltray.exe | %windir%\ltsvc\ltsvc.exe | %windir%\ltsvc\ltsvcmon.exe Client Administrative Settings Clients must be configured prior to deploying any agents. If you have not already added your clients to LabTech, do so now before continuing. Once your clients have been added, you are ready to continue. NOTE: If you want more detailed information on setting up clients, please refer to the Client Management documentation. 1A.51.155.WindowsAgentDeployment.docx 2 LabTech 1. In the Control Center, on the navigation tree, right-click on a client. Select Modify Client from the menu that displays or simply double-click on the client. Figure 2: Client Screen—General Information 2. Complete any remaining fields on the General screen. 3. Click on the Passwords tab. 4. You must add at least one administrative account. Right-click in the white area of the screen. From the menu that displays, select Add Entry. 1A.51.155.WindowsAgentDeployment.docx 3 Windows Agent Deployment Figure 3: Passwords—Add Administrative Account 5. Enter the type of password in the Title field. 6. Enter your domain\user name in the User Name field (e.g., simpledomainname\administrator. The domain must not not exceed 15 characters – use the name assigned by Windows. 7. Skip the URL field. This is for non-administrative passwords. 8. Enter the administrator password in the Password field and Repeat in the next. 9. Complete the Notes, Location and Expires field, if desired and click OK. 10. Click Save to save your changes. Agent Deployment Settings The agent deployment settings are set in Deployment & Defaults tab of the location. These must be configured prior to deploying any agents. This screen allows you to configure the default group for agents, administrative access, templates and alerting defaults by location. The following steps assume that you have already created the target client and location to which you are deploying. If you have not done so, please set this up before continuing. If you configured the Deployment & Defaults when you added 1A.51.155.WindowsAgentDeployment.docx 4 LabTech your locations, you may want to go back and verify your settings before proceeding with your deployment. The location’s custom agent installer is created using the values entered in the Deployment & Defaults screen. 1. In the Control Center, double-click the client’s location that you want to configure the deployment and default options for, or right-click and select Locations > Modify Location. 2. Click on the Deployment & Defaults tab. This screen covers multiple areas. The only section related to deployments is the Agent Deployment Settings section. Figure 4: Location—Deployment & Defaults tab 3. Select ‘Not Selected’ in the Default Group for New Agents field. Auto-join scripts handle this functionality. 4. Select the Login to use for Administrative Access from the drop-down list. This login is used to install the agent (when using the agent installer executable) and perform other administrative functions after the agent is installed. This password will be the default password used when performing the following: When commands are issued that require administrative credentials, this is the default used. Commands including pushing LabTech and running other administrative commands from the command prompt with the #prefix, this password will be used. Using some script functions (e.g., Shell as Admin and Execute as Admin). 1A.51.155.WindowsAgentDeployment.docx 5 Windows Agent Deployment NOTE: This list is populated from the Passwords tab. If you see ‘No Passwords for Location’, you will need to set these up before continuing. 5. Select the Template to include in deployment package from the drop-down list. The template selected will be the template that is used to build the deployment package. It will not be applied to existing agents, only agents that are installed using the custom agent installer. The benefits of configuring templates (modifications such as branding) are immediately realized after installing the agent. Best practice is to use the ‘Default’ template and create additional custom templates for out of the norm scenarios. 6. Click on Save if you made any changes and close this window when finished. 7. Repeat the above steps for any other clients you need to deploy to, if necessary. Downloading the Agent Installation File LabTech provides a default and custom agent installer that will allow you to install LabTech agents from any location. To retrieve the build file that will install the agent, follow these steps: NOTE: The default agent installer uses the information from the Deployments & Defaults tab of the New Computers location to create the installer. If the New Computers location is modified, the default agent settings will be changed and all subsequent agent installations will use the new default settings. Before downloading the agent installer, be sure that your clients and locations are configured. 1. Navigate to your LabTech server’s Web Control Center. This can be accessed by entering your LabTech servers FQDN: http://your.labtechserver.fqdn (use https://when applicable). NOTE: The default agent installation package is built partially from the URL that is typed into the browser to reach the LabTech webpage. Therefore, if you type ‘localhost’ on the server to download the default agent installation package, it will not be a publicly working installation package. You should always use the FQDN (with https:// when applicable) for the proper deployment package. 1A.51.155.WindowsAgentDeployment.docx 6 LabTech NOTE: If you are having issues accessing the Web Control Center, be sure you have Allow Web Access selected in the the User’s Permissions tab and ‘All Clients’ (if you want the user to have access to all clients) appears in the Group Membership section of the Groups and Clients tab. It is recommended that you do not give web access to a ‘super admin’ because SQL injection tests are bypassed. For step-by- step instructions for adding users, please refer to the User Access documentation. Figure 5: Web Control Center—Log in Page 2. The default agent installer can be installed from the main page. The default installer will not contain any location specific configuration so any agent installed as such will appear in the ‘New Computers’ location and will need to be moved to the appropriate location. Log in with the credentials used to log in to the Control Center to download any custom agent installers. 1A.51.155.WindowsAgentDeployment.docx 7 Windows Agent Deployment Figure 6: Web Control Center—Deployment List 3. Customized agent installers ready for download will be listed under the Deployment List section. Click on the desired agent installer to download. When prompted to run or save, click Save. Please note that the installers are named identically, so you may want to create a library to track agent installations or rename the executable. The .exe version would be used for login scripts and the .msi is for GPO (there is no longer a need for .mst files). TIP: If a template and administrative password have not been assigned to the location in the Deployment & Defaults tab, you will not see a custom installer for this location. Agents Deployed via Login Script Agent installation via the login script is the recommended method of deploying agents in environments that have more than 25 agents or do not have a domain controller. 1. Verify that the .NET v2.0 or better is installed. LabTech recommends using .NET v3.5, SP1. 2. Download the client’s custom agent installer from the Web Control Center to the domain controller’s netlogon folder. The netlogon’s real location is %windir%sysvol\sysvol\domain.com\scripts. For additional information on the Netlogon directory, please refer to the Microsoft site. NOTE: If you need step-by-step instructions on how to access/download from the Web Control Center, please refer to the Downloading the Agent Installation File section earlier in this document. 3. Edit the login batch file used for the client by adding the custom agent installer (agent_install.exe) to the end of the file. copy\\[servername]]\netlogon\agent_install.exe%windir%\temp call %windir%\temp\agent_install.exe /s 1A.51.155.WindowsAgentDeployment.docx 8 LabTech NOTE: By using the /s, it will be installed silently and you will not be notified if the agent was already installed. For other command line parameters, refer to the Agent_Install.exe Command Line Parameters section. Agents Deployed Manually Manually installing the LabTech agent is the least desirable option, in most cases because of the amount of time it takes if you have numerous computers to install it on. It is recommended to use if you have less than 10 clients. If you are having issues with any of the other methods, you should try installing manually. To manually install the agent, you may do any of the following: Log in to the computer and use the default agent installer. The default agent installer can be downloaded from the main page of the Web Control Center. Log in to the computer and use the custom agent installer. The custom agent installer can be downloaded from the Web Control Center, after logging in. NOTE: If for some reason you are unable to access your client’s computers remotely via RDP (remote desktop protocol) or the client wants to install the agent themselves, you can give them temporary access to the Web Control Center by adding them as a user with limited access. Agents Deployed via GPO Agent installation by GPO is the recommended and most reliable method of deploying agents in environments that have more than 25 agents. If you choose to use the group policy method for deployment, it is important to note that your clients must have the correct .NET framework installed (regardless of which method you choose to deploy agents). If it is not installed, the agent will not install properly. You can put it into the same group policy as the LabTech agent installer. Refer to this Microsoft KB article, .NET framework in a group policy object in Active Directory for additional information. NOTE: Refer to the MS KB article on, How to Use Group Policy to remotely install software in Windows Server 2003 and in Windows Server 2008 if you need information on how to create a group policy. The following instructions will walk you through downloading the LabTech Agent .msi file. If you need assistance with group policy, please refer to the links given above. 1. Open a browser window and navigate to your LabTech server. This will take you to the home page of the Web Control Center. 2. Enter your LabTech Username and Password. Click Login. You must be set up as a user in LabTech and have Allow Web Access permissions to access. 1A.51.155.WindowsAgentDeployment.docx 9 Windows Agent Deployment Figure 7: Web Control Center 3. Select the appropriate MSI package for the desired location from the drop-down and click on Generate MSI Package. 4. You will be prompted to save the file. Click Save. 5. Navigate to the location you want to save it to and click Save. Please note that if you are creating multiple MSI packages, they are all named Agent_Install. It is recommended that you rename Agent_Install.msi to Client-Location.msi. NOTE: An .mst file is no longer necessary. Agents Deployed via Probe Push A network probe is a service running on a designated computer per location that will scan the network for other devices without the LabTech agent installed on them. The probe will scan the network when the service is started, then once a day (default setting). IMPORTANT: The probe push will fail if the following conditions are met: Antivirus software is set to block VBScripts, antivirus software is set to block PSEXEC.exe. or the Windows Firewall is enabled or any additional 3rd party firewall is enabled. Enabling the Network Probe also enables: SNMP Trapping TFTP Server Syslog Event Trapping Agent installation by network probe is one of the recommended methods of deploying agents in environments that have more than 25 agents. In order to set up a probe, there must be an agent already installed in the location. The agent you use for the probe should be a computer that is constantly online and infrequently used. You do not need to install the .NET framework, it will automatically install with the probe. 1A.51.155.WindowsAgentDeployment.docx 10 LabTech Please note that if you change any information for a client (e.g., location) or the push is not working, it is best to refresh the installer. 1. To refresh the installer, right-click on the probe-enabled computer on the navigation tree. 2. Select Commands > Probe > Refresh Push Installer (LTSilent). NOTE: If the router between the probe machine and the targeted network devices caches ARPs, the probe will be able to recognize the devices but will not be able to obtain their MAC addresses, unless the devices are SNMP-enabled. If they are SNMP-enabled, LabTech can query them for the MAC address and they will be added to the system. In addition, any IP addresses that the probe finds in the scan range that it cannot identify will not be discarded; these devices will show up in Unknown Devices under the Network node of the navigation tree. To configure the probe, follow the steps listed below: 1. Double-click on the client or location on the navigation tree and click on the Passwords tab. Figure 8: Double-click on Location 1A.51.155.WindowsAgentDeployment.docx 11 Windows Agent Deployment Figure 9: Client Location—Passwords tab 2. If the administrative account that you want to use for the probe does not exist, right-click anywhere in this window and from the menu that displays, select Add Entry. 1A.51.155.WindowsAgentDeployment.docx 12 LabTech Figure 10: Edit Entry 3. Add the desired administrator account. a) Enter the Title (e.g., Administrator). b) Enter the User Name in domain\username (e.g., yourcorporatedomain\admin) format. The domain must not not exceed 15 characters – use the name assigned by Windows. c) If you enter the URL to the website that is associated with this location, you can open the website from within LabTech. If desired, enter the URL to the website that the password is associated with. You can use replacements for the password and username to auto replace in the URL (e.g., http://www.mywebsite.com/?user=%user%&password=%password%). In addition, you can use %title%, %notes% and %router% to use the current external IP address of the location. Once added, you can right-click on the URL and select Open URL from the main Passwords tab to open the website from within LabTech. d) Enter the Password. Click on the Ellipsis button to display the password. Please note that special characters in the Password field do not work with the probe push. e) Enter the password again in the Repeat field. 1A.51.155.WindowsAgentDeployment.docx 13 Windows Agent Deployment f) Enter any notes. g) Leave the Expires field unchecked. h) Click OK. 4. Click on the Deployments & Defaults tab. This screen covers multiple areas. The only section related to deployments is the Agent Deployment Settings section. Figure 11: Deployment & Defaults tab 5. Leave the Default Group for New Agents ‘Not Selected’. 6. Select the Login to use for Administrator Access from the drop-down list. 7. Select the Template to include in the deployment package from the dropdown list. 8. Click Save and close this window. 9. Double-click on the template (the one you included in the deployment package) from the navigation tree. On the Agent Settings tab, select the Turn on Agent Debug Logging checkbox to enable debugging. 1A.51.155.WindowsAgentDeployment.docx 14 LabTech Figure 12: Template Configuration—Agent Settings: Debugging Enabled 10. Double-click on the computer on the navigation tree that you want to be used as the probe. Figure 13: Computer—Welcome screen 11. Select Network Probe. You will be prompted to confirm the enabling of the network probe on this computer. 1A.51.155.WindowsAgentDeployment.docx 15 Windows Agent Deployment Figure 14: Enable Network Probe NOTE: If the probe is already enabled on another computer, you will be prompted to move the probe to this computer. Click Yes if you want to move the probe or No to cancel. 12. Click Yes to continue. This will start the Probe Express Setup Wizard. Figure 15: Probe Express Setup Wizard 13. Click Next. 1A.51.155.WindowsAgentDeployment.docx 16 LabTech Figure 16: Deployment Settings Any passwords that are currently set up for this client will display here. Passwords are typically set up by Location in the Passwords tab. 14. The probe requires the use of an administrative account for agent deployment. If necessary, add an administrative user to the list by right-clicking on the list and selecting Add Entry from the menu. User names must include your domain or ‘.\’ for local accounts (e.g., abccomputers\AAndrews or .\AAndrews). NOTE: Please note that the user you add in the list will not automatically populate the Passwords tab in the Location. If you want it on the Passwords tab, you will have to update it manually with the entry you just added. 15. Select the administrative login you want to use from the Login to use for Administrative Access drop-down. This field is required. Using the example above, you would have ‘Admin’ and ‘System Engineer’ as options to choose from. 16. Select the template you want to use for your agent deployment from the Template to include in deployment package drop-down. This field is required. 17. Click Next to continue. 1A.51.155.WindowsAgentDeployment.docx 17 Windows Agent Deployment Figure 17: Detection Settings 1A.51.155.WindowsAgentDeployment.docx 18 LabTech NOTE: Community strings are used in the communication process between the probe and SNMP enabled network devices. Depending on the manufacturer, a default value for the community string is often public. Almost all network devices support SNMP V1/V2c, both of which require a community string as a pass-phrase. Most manufacturers configure devices with a read-only community string of ‘public’. In order for the probe to communicate the string must match the device’s internally configured community string. 18. The Community Strings field is automatically populated with public, private and admin and should cover the majority, if not all of your SNMP devices. Add any additional strings, if necessary separated by commas. TIP: It is recommended that you have no more than 4-5 different strings as each string represents an additional test the probe must perform. Strings should be ordered in preferred search order, with the most often used strings first. 19. In addition to finding devices through a simple ping, the probe attempts to find network devices by opening commonly used ports. The Scanning Ports field defaults to port 80 (web), 21 (FTP) and 23 (Telnet). These will be the most likely ports that you will want to scan. Enter any additional ports you want scanned, separated by commas. Please note that each additional port you add does add processing costs so only add ports that are necessary to scan. 20. The Scan Frequency defaults to once a day. This is how often the probe will scan the network for new devices. Select the desired frequency from the dropdown. Times range from five minutes up to one day. Keep in mind that scanning can be intensive on networks of more than a few devices; therefore it is recommended that you do not set the frequency for less than an hour. 21. Select the Collection Network Device Data for this Location to start collecting data on every device at this location. This allows you to select which locations you want to collect data for. Please note that this will increase your bandwidth usage and disk usage on the LabTech server. 22. Click Next. 1A.51.155.WindowsAgentDeployment.docx 19 Windows Agent Deployment Figure 18: Probe Setup Complete 23. Click Finish to complete the initial setup. When an agent becomes a probe, it downloads all of the necessary tools it requires, including .net installers. This process may take several minutes. When it is complete, you will see the Network Probe flag selected and the Network Probe tab display on the Computer screen as shown below. Figure 19: Network Probe Tab 24. Click on the Network Probe tab. The basic settings have already been completed by using the wizard. 1A.51.155.WindowsAgentDeployment.docx 20 LabTech Figure 20: Network Probe—General Settings 25. The Passwords to Attempt field will already be populated with the values you entered during the wizard. If you want to add additional passwords to use for the probe, select the administrator account(s) you want to use from the drop-down list and click Add. The selected administrator account(s) should now display in the Passwords to Attempt field. These are the passwords the probe will use to attempt the LabTech agent install. It will try the top one first and then work its way down the list if the previous one did not work, until there are no further passwords to try. Use the Down and Up buttons to move passwords up or down in the list. NOTE: The Passwords drop-down list is populated from the passwords set in the Passwords tab of the Client and Location screen. The Add button will add the password to the Passwords to Attempt field. The Delete button will remove the password. 26. Select the Enable Automatic Network Installation checkbox to signal the probe to install LabTech on all Windows machines the next time the computer is fully scanned, which could be up to a week (depends on what your scan frequency is set at) for detected computers. 27. Enter any additional information pertaining to the probe in the Comments and Info field. For example, if you have a printer being disposed of in the next month you can indicate in the notes that you do not want to include a specific IP address in the scan range. 28. The Search Me field is currently not in use. 29. If you are recording serial numbers, you can enter the Serial Number. However, this field is not required and is not used in any reporting. 30. Select the alert template to use for when a SNMP trap is received or a Syslog event occurs. For instructions on how to create a new alert template or for additional information on the alert templates, please refer to the Alert Templates documentation. 1A.51.155.WindowsAgentDeployment.docx 21 Windows Agent Deployment Figure 21: Network Probe Configuration—Scan Settings 31. The Frequency field is automatically populated based on the information you entered during the Probe Wizard. The frequency dictates how often the probe will scan the network for new devices. If you want to make changes, just select the new frequency from the drop-down. 32. The Scanning Ports field is also automatically populated based on the information you entered during the Probe Wizard. Enter any additional ports you want scanned, separated by commas. Please note that each additional port you add does add processing costs so only add ports that are necessary to scan. 33. The Ping Timeout defaults to 50 milliseconds. For heavy traffic networks, you may want to adjust this time to approximately 75 because it will take longer for the ping results to return. 34. The Port Scan Timeout also defaults to 50 milliseconds. After the ping, the probe will attempt to scan the ports that appear in the Scanning Ports field and will time out after the specified time period. 35. The network probe scans based on the IP and count. Specify the Subnets that you want the probe to start scanning. Enter the Subnet (e.g., 192.168.1.1, must not end in 0) and 253 in the Count field and click Add IP. Count is equal to the number of additional hosts you want to scan for, typically this will be set to 253 (because you do not want to count 0 and 255). In the example below, the probe will start scanning at 192.168.1.1 and will continue scanning the network range until it reaches 192.168.1.254. Figure 22: Network Probe Configuration—TFTP Settings 36. The TFTP Settings will allow you to enter the allowed IP addresses. Enter a comma separated list of IP addresses that you want to allow to connect to the TFTP server (probe computer). Leave blank for all connections. 37. The Listening Port is the port it will listen on. The default TFTP port is 69. Set to ‘0’ to disable TFTP. 38. Select the Allow Upload checkbox to allow files to be uploaded to the probe machine. Uploads are disabled by default. 1A.51.155.WindowsAgentDeployment.docx 22 LabTech Figure 23: Network Probe Configuration—Syslog Settings The Syslog Settings will allow you to limit received syslog events from specific IP addresses. Any syslog messages from a valid IP address are stored to a text file on the probe computer and then periodically transmitted to the LabTech server. Syslog messages are transmitted in batches of 300 at a time. Any additional messages are not transmitted. So if you are performing any monitoring on received events at the server, make sure the amount of syslog messages sent to the probe is limited as much as possible. For selective monitoring, it is recommended to use the syslog filters (see syslog documentation). 39. Enter a comma separated list of IP addresses that you want to receive syslog events in the IP Filter field; otherwise if left blank, syslog events will be created for all events. 40. The Trap Port is the port it will listen on. The default syslog port is port 514. Set to ‘0’ to disable syslog for this probe. Figure 24: Network Probe Configuration—SNMP Settings 41. The Community Strings field in the SNMP Settings section determines what community strings to try when scanning devices via SNMP. This field is automatically populated based on information you entered during the Probe Wizard. Enter any additional community strings separated by commas. Strings will be tried in the order they appear in the list so it is recommended to use the most common first. IMPORTANT: Please note that the probe will try all strings on all found IP addresses, so each string will increase the total time of a network scan dramatically. 42. The Trap Port is the port it will listen on. The default SNMP port is port 162. Set to ‘0’ to disable SNMP trap listening. 43. The SNMP Timeout field will default to 15 seconds. If you plan on doing a large portion of SNMP walks on a heavy traffic network, you may want to change the value to 45 to allow enough time for a SNMP response from the device. Figure 25: Network Probe Configuration—SNMP V3 Settings 1A.51.155.WindowsAgentDeployment.docx 23 Windows Agent Deployment 44. For each probe, the system allows for the setting of one universal SNMP V3 access combination that can be tried on all found devices. SNMP V3 is only attempted if the Username field is not empty. Enter the Username to use SNMP V3; otherwise skip steps 45-48 to bypass. NOTE: The recommended practice is to not use the SNMP v3 settings. Devices in v3 may send alarms when an incorrect password is used and the probe could cause those alarms to fire generating false alarms. The only time you should use this is if all your v3 devices use the same password. 45. Enter the authentication phrase for the devices that are configured for authentication in the Auth Password field. This value needs to match all SNMP v3 enabled devices. 46. Select ‘MD5 (Message Digest 5)’ or ‘SHA (Secure Hash Algorithm)’ from the authentication Method drop-down. This value needs to match the device. 47. Enter the encryption phrase for the devices that are configured for encryption in the Enc Password field. This value needs to match the device. 48. Select the encryption Method from the drop-down. The available choices are: DES, AES, and 3DES. This value needs to match the device. NOTE: Select the Reveal Passwords checkbox to show the passwords. Select again (no checkmark) to hide the passwords. 49. Click the Save button to save your settings. By clicking Save, a command will automatically be sent to rescan the network. NOTE: At any time, you can click Rescan Network and Reinventory Devices to scan the network and reinventory network devices. 50. Confirm the network probe is scanning the network. Click on the Probe Commands tab. You should see a message similar to “Command Issued” in the Output column. Figure 26: Probe Commands tab 51. Basic setup is complete and for the majority of Partners, no additional configuration is necessary. The probe will use its library of known devices for discovery. However, advanced configuration using detection and collection templates will allow you to classify the devices that the probe finds and allow you to define the information that should be collected from these devices. It is highly recommended that you review all of the Probe documentation to determine if the advanced configuration will benefit you and your business. 1A.51.155.WindowsAgentDeployment.docx 24 LabTech TIP: For more information on how the probe is progressing, double-click on the probe-enabled computer from the Control Center’s navigation tree. Select the Tools, Tasks & Groups tab. When a scan is completed, it will show ‘Done’ in the Probe Scan Position. Agents Deployed by LabTech Deployment Script The LabTech Deployment script must be run from a probe computer. The probe should be a domain controller and the domain password must be set for the probe’s locations. The deployment script will update the LTSilent.exe on the probe before it runs. This will ensure that the script is updated with any new settings or passwords from the location. It script will also get a new VBScript every time its run to ensure it has any new changes. This script will email a report to the contact associated to the computer that the probe is enabled or you can create a property named DomainPushEmailOverride in Dashboard > Config > Configurations > Properties to override the default contact. NOTE: If an email is not being received, look at the script log on the computer as it will be logged here. Also, make sure to check the failed emails (Dashboard > Management > Failed Emails. A couple of things to keep in mind: This script does not require you to setup any settings on the Probe tab. You only need to enable the probe and set an administrator password in the location’s Deployment tab. REMEMBER to wait however long it’s going to take the probe computer to download 50mb from Microsoft. It has to get the framework files before you run the deployment script. To use the LabTech deployment script with a probe enabled computer, follow the steps listed below: 1. From the Control Center, right-click on the group where the probe enabled computer resides. From the menu that displays, select Scripts > System Commands > Deployment > Push LabTech to Domain. NOTE: The Push LabTech to Domain option is also available to schedule on a client, location or the probe computer. 1A.51.155.WindowsAgentDeployment.docx 25 Windows Agent Deployment Figure 27: Push LabTech to Domain—Schedule Script 2. Select the appropriate settings and click Create. 3. Double-click on the group in the navigation tree and select the Scripts tab to display the script schedule. 1A.51.155.WindowsAgentDeployment.docx 26 LabTech Figure 28: Script Status—Queued NOTE: You can modify the script schedule from this screen. After changes are made, click Save. The changes will take effect immediately. Using the Deployment Script to Deploy to a Specific IP To use the LabTech deployment script to deploy an agent to a specific IP address, follow the steps listed below: 1. From the Control Center, right-click on the network probe machine. From the menu that displays, select Commands > Probe > Push LabTech to PC. 1A.51.155.WindowsAgentDeployment.docx 27 Windows Agent Deployment Figure 29: Enter Hostname or IP Address 2. Enter the Hostname or IP address of the computer you want to push the LabTech Agent to and click OK. 3. LabTech will immediately issue the command. You can check the status of the command by double-clicking on the probe-enabled computer, and then select Network Probe > Probe Commands. Figure 30: Probe Command Status Agent Installation via Network Devices This method is used if you want to pick and choose which workstations and servers you want to push to after the network probe has detected all of the devices on the network. 1. From the Control Center, expand Clients > Client > Location to get to the desired location of where the network probe is located. 2. Expand Network. 1A.51.155.WindowsAgentDeployment.docx 28 LabTech Figure 31: Network Node All detected network devices will display. 3. Double-click on the desired computer. Figure 32: Network Device Properties 4. Click Install. This will send a command to the network probe to install the agent with the configuration that has been specified for this location. 1A.51.155.WindowsAgentDeployment.docx 29 Windows Agent Deployment Agent Installation on Server Core 2008 1. Edit the machine.config file located in the %windir%\microsoft.net\framework64\v2.0.50727\config folder. Where: locate the final closing </configuration> tag, and append the following: <system.net> <defaultProxy> <proxy usesystemdefault="false" bypassonlocal="true" /> </defaultProxy> </system.net> 2. Start the LabTech service by running SC START LTService. Agent_Install.exe Command Line Parameters Table 1: Command Line Parameters Parameter Description /h Options.Help /s Options.Silent (turns off the pop-up message and instead displays console message) /q Options.Quiet (turns off the pop-up message and console message) Need to use /s when you use /q, but /s can be used by itself. /u Options.ServiceAsUser address= Options.Address pass= Options.ServerPass location= Options.LocationID user_name= Options.LogonUsername password= Options.LogonPassword proxy= Options.ProxyServer proxyuser= Options.ProxyUsername proxypass= Options.ProxyPassword Troubleshooting Network Probe Scan Not Successful Issues can sometimes be caused by ARP caching problems for one of the hardware devices on the network. If this can be turned off and then have the network probe rescan, this will often will correct the issue. 1. If the initial scan is not successful, send the following command to the network probe from the CMD prompt: netsh interface ip delete arpcache. 2. Re-scan the network. 3. From the Control Center, expand the Location, then the Network to see if any new devices are listed. 4. Double-click on one of the devices. 1A.51.155.WindowsAgentDeployment.docx 30 LabTech Figure 33: Network Device—Install 5. Click Install to try to install the agent. 6. If agent does not install successfully and check-in, troubleshoot the agent: a) Check AV exceptions b) Verify .NET is installed and enabled c) Look for partial installs shown by existence of registry keys, etc. 7. If the probe computer will not enable at all, use the agent uninstaller, then reinstall with the default agent install and not a customized deployment package and try to enable again. If the location will not allow it, create a new location and move the network probe agent to it. Partial LabTech Reinstall Fix In the event that LabTech only partially installed, follow the steps listed below: 1. Stop the LabTech Agent Service (if you have it). 2. Kill the LabTech Agent processes from the Task Manager. 3. Navigate to HKLM\Software\LabTech and delete the key ‘labtech’ from the remote computer. 4. Delete the folder LTSVC from system drive\windows. 5. Reboot the computer. 1A.51.155.WindowsAgentDeployment.docx 31 Windows Agent Deployment 6. Re-run the agent installer to install the LabTech agent. .NET Cleanup Problems can occur with the .NET install preventing the agent installation. There is an automated cleanup tool that will remove selected versions of the .NET framework from a computer. This tool should be used as a last resort where install, uninstall or repair did not succeed. It is not intended as a substitute for the standard uninstall procedure. This cleanup tool will also delete shared files and registry keys used by other versions of the .NET framework. If you run the cleanup tool, you will need to perform a repair or reinstall for all other versions of the .NET framework that are on the computer or they will not work correctly afterwards. For a complete user’s guide on the cleanup tool, refer to this web article. Download .NET Framework Cleanup Tool LTAgent not checking in/offline 1. Check agent system to see if LT processes are running. 2. Check AV for exceptions for all possible scan types. 3. Can the agent system reach the FQDN in browser (IIS problem or site blocked)? 4. Try uninstall, remove reg keys and LT folder, and reinstall agent, if isolated incident. 5. Windows\LTSvc\LTErrors.txt log, Registry values in HKLM\software\labtech\service (is there an “ID”, “password”, “serveraddress” and “server password” key?) and HKLM\software\labtech\service\settings, LTSvc and LTSvcMon both running? What accounts are they running under? Agent Duplicating in Control Center 1. Delete all instances of agent system that duplicates. 2. Get registry info from labtech\service and labtech\service\settings keys. Get LTErorrs.txt. Check event logs (could be a .net issue). 3. Uninstall agent, remove registry keys, and reinstall the default agent installer. Document Revision History Date Notes 03/22/2011 Updated for 2011 release 05/10/2011 Changed AV File/Folder Exclusions 10/17/2011 Added agent install via network devices option and updated icons. 10/19/2011 Fixed menu option for deployment script and added additional information about the default deployment package. 01/13/2013 Added command line parameters 02/18/2013 Added additional information about adding administrator accounts – domain must not exceed 15 characters. If it exceeds 15 characters use the name assigned by Windows. 1A.51.155.WindowsAgentDeployment.docx 32