www.lansweeper.

com

Installation and configuration of Lansweeper

Installation and configuration of Lansweeper .........................................................................................................1

Prerequisites ....................................................................................................................................................2
Configuring the database server (sql server express 2005) ......................................................................................3
Installing Lansweeper ........................................................................................................................................5
Installing the database ......................................................................................................................................6
Configuring the lansweeper service ......................................................................................................................7
Configuring the website .....................................................................................................................................8
Accepting the license agreement .........................................................................................................................9
Choose a folder for the installation..................................................................................................................... 10
Checking if the service is running ...................................................................................................................... 11
What is Lsclient.exe ........................................................................................................................................ 12
Using lsclient in a standard login script ............................................................................................................... 13
Deploying lsclient by using a GPO ...................................................................................................................... 14
Troubleshooting connection problems. ................................................................................................................ 15
Adding user pictures to the web interface............................................................................................................ 16
Configuring Internet explorer to allow custom actions ........................................................................................... 17
Configuring Firefox to allow custom actions ......................................................................................................... 18
Permanently deleting computers using the GUI console ......................................................................................... 20
Administering report settings ............................................................................................................................ 21
Configuring software license usage .................................................................................................................... 22
Configuring operating system license usage......................................................................................................... 23
Implementing custom actions ........................................................................................................................... 24
Configuring extra scanned files.......................................................................................................................... 25
Configuring extra scanned registry keys.............................................................................................................. 26
Configuring allowed local computer administrators................................................................................................ 27
Configuring allowed (safe) software ................................................................................................................... 28
Configuring Asset tag links ............................................................................................................................... 29
Configuring scanning options ............................................................................................................................ 30
Configuring scheduled scanning......................................................................................................................... 31
Configuring scanning exclusion.......................................................................................................................... 32
Running predefined database scripts .................................................................................................................. 33
Upgrading to the premium version ..................................................................................................................... 34
How to install the premium and other custom tools............................................................................................... 35
Premium only: Active scanning......................................................................................................................... 36
Premium only: Alternate credentials ................................................................................................................ 37
Premium only: Recover Microsoft product keys ................................................................................................ 38
Premium only: Lstrigger - triggered scanning of computers. ............................................................................ 39
Premium only: Using the report builder. ........................................................................................................... 40
Premium only: Remote screenshot - see what’s on a remote computer screen. ............................................... 43
Premium only: Remote control - Take remote control of your workstations by pushing VNC............................ 44
Premium only: Remote software uninstall – list and uninstall software on remote computers. ........................ 45
Premium only: Lsrunase : encrypted runas tool................................................................................................ 46
Premium only: Supercrypt : enhanced encrypted runas tool............................................................................. 47
(optional) Changing the service account ............................................................................................................. 48

1/48
 www.lansweeper.com

Prerequisites

Web server:
Windows 2000 or higher with Internet Information services installed.
The dotnet framework 2.0 installed (latest service pack).

Server where the Lansweeper service is installed:

Windows 2003 or higher. (Or optionally windows XP or vista)
The dotnet framework 2.0 installed.

Database server:
Windows 2000 or higher
SQL server 2000 SP4 or higher (or the free SQL express)

If you want to use SQL express 2005 or 2008 as a free database you can download it from:
http://www.microsoft.com/sql/editions/express/default.mspx

Also make sure to download SQL Server Management Studio Express if you are using SQL express.

Clients:
Windows 2000, windows XP, windows Vista, Windows 7, Windows 2000, 2003, 2008 server
(Windows 9x clients are not supported)

Active directory is required.

Lansweeper in a workgroup is not supported.

In this example the web console, database and service are installed on the same machine.

Server name: myserver

Domain: lansweeper.local
NetBIOS domain: lansweeper

2/48
 www.lansweeper.com

Configuring the database server (sql server express 2005)

SQL server 2000 doesn’t need any extra configuration

Open the “SQL server configuration Manager”

Enable “Named Pipes” and “TCP/IP”

3/48
 www.lansweeper.com

Set the SQL server Browser to automatic and start it (if not already started)

Restart the sql service.

4/48
 www.lansweeper.com
Installing Lansweeper

Click next to continue

You can choose to install Database, Service and Website on different servers if you want; in this example we are
going to install everything on one server.

5/48
 www.lansweeper.com

Installing the database

Choose your SQL server and authentication method:

6/48
 www.lansweeper.com

Configuring the lansweeper service

The user running the service should have administrative privileges on all clients being scanned by
lansweeper.

This is typically a domain administrator account.

7/48
 www.lansweeper.com

Configuring the website

Choose a name for the Virtual Directory (recommended) or install lansweeper as the default website.

8/48
 www.lansweeper.com

Accepting the license agreement

9/48
 www.lansweeper.com

Choose a folder for the installation

Everything should be installed now.

10/48
 www.lansweeper.com

Checking if the service is running

Surf to your server where the Lansweeper service is running (not the website) http://servername:9524

If there are any errors, the errorlog.txt is in your service folder:

If for some reason you cannot connect to your sql server:

Sqlcmd: Error: Microsoft SQL Native Client: An error has occurred while establishing a connection to the server. When
connecting to SQL Server 2005, this failure may be caused by the fact that under the default settings SQL Server does not
allow remote connections.

See this knowledgebase article: http://support.microsoft.com/kb/914277/en-us

11/48
 www.lansweeper.com

What is Lsclient.exe

Although the name would suggest otherwise lsclient is no real client or agent.
Basically it just sends a message to the server “hello, I’m here, scan me on this IP Address” and stops working.
The service queue’s this request and starts scanning the client when ready.
All the scanning is done by the lansweeper service.

Lansweeper Premium doesn’t require lsclient and uses active directory to scan your computers.

Lsclient.exe is copied to your installation folder

Usage: Lsclient.exe “name of server where the service is installed”

As a test we try from the command prompt:

“C:\Program Files\lansweeper\Client\lsclient.exe” myserver

or
“C:\Program Files\lansweeper\Client\lsclient.exe” myserver /showresult

12/48
 www.lansweeper.com

Using lsclient in a standard login script

In this example the startup script is called “startup.cmd”

Contents of the startup.cmd

%logonserver%\netlogon\lsclient.exe myserver

Now copy the lsclient.exe to your netlogon folder.

13/48
 www.lansweeper.com

Deploying lsclient by using a GPO

More technical info on: http://support.microsoft.com/kb/322241/en-us

Make sure that you use a logon script instead of a startup script because this is running in the context
of the user.

A sample vbs script that runs the lsclient hidden could look like this:

Set WshShell = CreateObject("WScript.Shell")

WshShell.run "%logonserver%\netlogon\lsclient.exe myserver",0

14/48
 www.lansweeper.com

Troubleshooting connection problems.

You can connect from the server to one of the clients to check if the WMI settings and access permissions are ok.

The test checks if WMI access and registry access using WMI is
possible.

If you find error errors please visit our knowledgebase

Errors are almost always caused by these problems:

• Windows firewall or other firewall blocking access.

• WMI and Dcom is not enabled on the client.
(in a default windows installation this is enabled)
• Access denied: the server user does not have
administrative permissions on the client.

If you have checked our knowledgebase and didn’t find an

answer, please visit our support forum
http://www.lansweeper.com/forum

15/48
 www.lansweeper.com

Adding user pictures to the web interface

If you want to add pictures for your users you can add them in the pictures folder of your web server:

Folder = NetBIOS name of your domain (change this to reflect the name of your domains)
Picture = username.jpg (SamAccountname)

16/48
 www.lansweeper.com

Configuring Internet explorer to allow custom actions

Make sure that the activeX controls are enabled.

You can add your website to the trusted sites for security reasons.

Go into Security Settings - trusted sites.

Change the following setting to "Enable"

[Initialize and script ActiveX control not marked as safe.]

17/48
 www.lansweeper.com

Configuring Firefox to allow custom actions

First download the plugin from http://www.lansweeper.com/firefoxplugin.zip

The zip file contains 2 files:

nsIScriptablePluginShellExec.xpt should be placed in your Firefox Components folder

nplansweepershellexec.dll should be placed in your Firefox Plugins folder

Afterwards restart Firefox if it was running.

You can disable/enable the plugin afterwards from the firefox menu/tools/add-ons.

18/48
 www.lansweeper.com
Logging on to the Configuration Console.

Server: your SQL-Server

Database: lansweeperdb

You can use integrated authentication or if you want to use sql authentication:

Logon: lansweeperuser
Default password: mysecretpassword0*

You can change the default password of the SQL user later if you want.

19/48
 www.lansweeper.com
Permanently deleting computers using the GUI console

Select all the computers in the grid (ctrl & shift) for multiple selections.

Click the “permanently delete selected computers” button.

This will delete the computer details and all related information from your database.

20/48
 www.lansweeper.com
Administering report settings

With the dropdown box you can select from all the available reports in the database.

Sort order = the lower the number, the higher the report will be displayed in the interface

Priority 1 : High priority

Priority 2 : Important
Priority 3 : Informational

Color = show in red in the report contains items

Show % = shows the percentage of computers contained in this report

If you want to create new reports: the premium version includes a report builder.
21/48
 www.lansweeper.com
Configuring software license usage

On the left you see all the software found in your network.
If you want to track license usage of a software item, you can select it and add it to the list of tracked software.

# Purchased : amount of licenses that you bought for this product.

# Price : price for one license.

22/48
 www.lansweeper.com
Configuring operating system license usage

On the left you see all the windows operating systems found in your network.
If you want to track license usage of an operating system, you can select it and add it to the list of tracked
Operating systems.

# Purchased : amount of licenses that you bought for this product.

# Price : price for one license.

23/48
 www.lansweeper.com
Implementing custom actions

Description: what appears in the web interface

Action: the command to execute
Variables: {computer}, {domain}, {username}, {userdomain}, {tag},{ipaddress} can be used
Icon: which icon to show in the interface.
Sort order: the lower the number, the higher the report will be displayed in the interface
Enabled: show this action in the interface
Confirmation: ask for confirmation before executing this action.

You can add your own icons to the “actions” folder in the web folder.

24/48
 www.lansweeper.com

Configuring extra scanned files

Filename : you can use 2 parameters : %programfiles% and %windir%

Enabled : scan for this file.

File size, company, version and other info is scanned for this file.

Results of these file scans can be used to create custom reports using the premium report builder.

Examples:
Who doesn’t have the latest version of Firefox installed?
Who doesn’t have the latest version of Antivirusscanner X?
Who misses the needed DLL for application X?

25/48
 www.lansweeper.com

Configuring extra scanned registry keys

Rootkey: select the rootkey in the remote registry

Regpath: select the path to scan
Revalue: select the value to scan
Enabled: enable scanning of this item

26/48
 www.lansweeper.com

Configuring allowed local computer administrators

Add all users that are allowed to be local administrator on their computer to this list.
This will help you with the report : “Not allowed local administrators”

27/48
 www.lansweeper.com

Configuring allowed (safe) software

Add all approved and safe software to the list.

This will help you to find “illegal” software usage.

28/48
 www.lansweeper.com

Configuring Asset tag links

You can use the {assettag} and {model} parameter to link to computer vendors support pages.

29/48
 www.lansweeper.com

Configuring scanning options

This table defines when each item is scanned.

0 = always
X = every x days.

For example:
Cdrom = 60
Information about cdroms is only scanned every 60 days.

30/48
 www.lansweeper.com

Configuring scheduled scanning

If you want to use scheduled scanning (optional) you can add the computers + domains to this list.

31/48
 www.lansweeper.com

Configuring scanning exclusion

If you wish to exclude some computers from scanning you can add them to this list.

32/48
 www.lansweeper.com

Running predefined database scripts

On the lansweeper forum you will be able to download new reports, action scripts, ... created by other users.
You can install them using this interface.

33/48
 www.lansweeper.com

Upgrading to the premium version

After purchase you will receive a license key which you can copy/paste into this screen.

If you can’t find your license key, please contact us at lansweeper@hemoco.com and provide your orderID.

34/48
 www.lansweeper.com

How to install the premium and other custom tools

All the premium tools are standalone executable and don’t require any special installation, you can place them
wherever you like.

In this example we are going to place them on a shared folder so all administrators can use them from the action
screen.

1. Create a new share on the server, (LSTools in this example)

2. Set up security on the share
3. Unzip the tools to this share

Open management console and go to the custom actions.

Now change the Trigger scan action to point to the share we just created:

\\servername\LStools\lstrigger.exe myserver {computer} {domain}

Change myserver to the server where your lansweeper service is running.

35/48
 www.lansweeper.com

Premium only: Active scanning

Active scanning allows you to scan multiple domain and selected OU’s without the need to use
lsclient.exe in a login script.

36/48
 www.lansweeper.com
Premium only: Alternate credentials

On this page you can specify alternate credentials to scan other domains and forests.

If you want to use credentials from a computer that can not be verified (example: a dmz standalone computer)
you can check the box “Don’t try to authenticate username\password”

37/48
 www.lansweeper.com
Premium only: Recover Microsoft product keys

You can enable/disable Microsoft product keys you want scanned.

This list is extendable to add future product keys.

38/48
 www.lansweeper.com

Premium only: Lstrigger - triggered scanning of computers.

Use this tool to force/trigger remote scanning of a workstation from the command line.

Example:
lstrigger "servername" "computer" "domain"
Default port = 9524

lstrigger "servername" "computer" "domain" "port"

C:\>lstrigger myserver lansweeper-001 lansweeper

Change “servername” to the name of the server running your lansweeper service.

When you trigger a scan all information for this computer is rescanned regardless of the waittime set.

Lstrigger only works on computers that are already in the database.

39/48
 www.lansweeper.com
Premium only: Using the report builder.

In this example we will create a sample report.

We want to display all software found in our network from the publisher “Apple Inc.”
To create a new report right click on the report list and click “New Report”

Drag the 2 needed table “tblcomputer” and “tblsoftware” to the query builder and select the needed fields.

Let’s filter out software only from “Apple Inc.”

40/48
 www.lansweeper.com

If you want to sort your report you will need to add the “TOP 100 percent” clause.

You can do this by right clicking en selecting “Properties”

Let’s save our report and give it a name:

41/48
 www.lansweeper.com

Our report is now available and can be exported to excel, XML, …

You can also add the report to the web interface.

You need the management console to configure this.

42/48
 www.lansweeper.com
Premium only: Remote screenshot - see what’s on a remote computer screen.

• Client requirements : Windows 2000 or higher

• No need to install software on the client.
• Both machines should be in trusted domains.
• The user should have administrative privileges on the client.
• TCP ports 139, 445 should be open on the server from the client.
• The “Server” service should be running on the target machine.
• The “Remote registry” service should be running on the target machine.
• The Default shares should be available on the client (C$, admin$)

You can also use this program from the command line or from the action screen.

Usage:
screengrab.exe {computer}

43/48
 www.lansweeper.com
Premium only: Remote control - Take remote control of your workstations by pushing VNC.

Remote control the screen of your workstations to give them remote support.
The free VNC service is automatically pushed to the client on first use.

• Client requirements : Windows 2000 or higher

• No need to install software on the client.
• Both machines should be in trusted domains.
• The VNC service is pushed to the client and removed after the remote control session.
• The user should have administrative privileges on the client.
• TCP ports 139, 445 and 5900 should be open on the server from the client.
• The “Server” service should be running on the target machine.
• The “Remote registry” service should be running on the target machine.
• The default administrative shares should be available on the client (C$, admin$)

You can also use this program from the command line or from the action screen.

Usage:
lsremote.exe {computer}

44/48
 www.lansweeper.com
Premium only: Remote software uninstall – list and uninstall software on remote computers.

You can also use this program from the command line or from the action screen.

Usage:
remoteuninst.exe {computer}

The only requirement is WMI and administrative rights on the remote computer.

There are 3 types of software:

MSI packages:
These are uninstalled by the MSIexec command.
Adding the /QN /NORESTART parameters makes the uninstall invisible to the remote users.

Other installers:
They might have optional parameters to run the uninstall hidden but this depends on the software and is not
always available.

Not allowed to remove:

Some software is not allowed to be removed by the software vendor because it will most likely break windows
functionality.

45/48
 www.lansweeper.com
Premium only: Lsrunase : encrypted runas tool.

LSrunase 2.0 can be used to run a command using another user account and passing the password as a
parameter.

Parameters:
1e parameter: specifies the username
2e parameter: specifies the domain
3e parameter: specifies the encrypted password
4e parameter: specifies the command
5e parameter: specifies the optional parameters

Examples:
lsrunase administrator Mydomain vA0j26NYqfc= notepad.exe

lsrunase administrator Mydomain vA0j26NYqfc= "C:\Program Files\Internet Explorer\iexplore.exe"

lsrunase administrator Mydomain vA0j26NYqfc= "C:\Program Files\Internet Explorer\iexplore.exe"

"http://www.google.be"

46/48
 www.lansweeper.com
Premium only: Supercrypt : enhanced encrypted runas tool.

Supercrypter 2.0 makes encrypted .lsc files based on your input

In this example we make the notepad.lsc file to start notepad with administrator privileges.

You can then use these encrypted .lsc files with Supercrypt to run the chosen program using the chosen account.

The executable variable makes sure that only the intended program can be run as administrator.
The technique for doing this is calculating the MD5 hash value of the executable (in this case notepad.exe).

Supercrypt makes sure that the user can only run the program it was intended to run!

Supercrypt has the following parameter:

1e parameter : specifies the .lsc file (create the file with SupercryptER)

Example:
supercrypt "c:\notepad.lsc"

47/48
 www.lansweeper.com
(optional) Changing the service account
Open the services MMC and go to Lansweeper Server service

Retype the password 2 times and click “Apply”

48/48