Installing Lansweeper

There are two main ways you can install the Lansweeper software, both documented in this installation guide. You can perform either an Easy or an Advanced Install.

  • If you perform an Easy Install, all Lansweeper components (Lansweeper scanning service, database and web console) are installed on the same machine. The database is installed under the SQL Compact database server, which is limited by Microsoft to 4GB of data, and the web console under the IIS Express web server.
  • If you perform an Advanced Install, you can choose which component (Lansweeper scanning service, database, web console) to install on which machine. The database can then be installed under the SQL Compact or SQL Server database server and the web console under the IIS or IIS Express web server. Express editions of SQL Server are limited by Microsoft to 4GB or 10GB of data, depending on the version. You can also install under a paid edition of SQL Server, which is not limited in size.
An Easy Install is sufficient in many cases. Performing an Advanced Install is required if one or more of the following is true:
• You have a network of more than 1,000 assets or you plan on using the Lansweeper help desk. A SQL Compact database may not be sufficient in this case, for database size as well as performance reasons.
• You want to install the database under SQL Server and/or the web console under IIS.
• You want to spread out the Lansweeper service, database and web console over several machines. SQL Compact doesn't allow services to remotely connect to the database.
• You want to configure an installation with multiple scanning servers.
• You want to connect external interfaces to the database.

Performing an Easy Install

 

To perform an Easy Install of the Lansweeper software, do the following:

  1. Download the latest Lansweeper installer and run it on the Windows computer you want to install Lansweeper on. All of the Lansweeper licensing plans use the same installer.
  2. Hit the Next button and hit I agree to accept the license agreement.
    accepting the license agreement
  3. Select the Easy install option and hit Next.
    selecting Easy Install
  4. Optionally, you can choose a custom HTTP and (if offered by the installer) HTTPS port to install the web console under. If you don't choose custom ports, the installer will automatically install the web console under the first available ports. Hit Next to continue.
    choosing the web console ports
  5. Optionally, you can choose a custom folder to install under. Hit Install to start the installation process.
    choosing the installation folder
    - The Lansweeper service will be installed under Windows Services.
    - The Lansweeper database will be installed under SQL Compact, which is limited by Microsoft to 4GB of data. The database file will be called lansweeperdb.sdf and should not be renamed.
    - The Lansweeper web console will be installed under IIS Express, which is installed and configured automatically, and your preferred ports.
  6. When you get to the screen that confirms the successful installation of Lansweeper, hit Finish to close the installer.
    finishing the installer

Performing an Advanced Install

 

To perform an Advanced Install of the Lansweeper software, do the following:

  1. Make sure you manually set up the SQL Server instance you want to host the Lansweeper database in, prior to running the Lansweeper installer. You'll need to point the Lansweeper installer to your existing SQL Server instance.
  2. Download the latest Lansweeper installer and run it on the Windows computer you want to install Lansweeper on. All of the Lansweeper licensing plans use the same installer.
  3. Hit the Next button and hit I agree to accept the license agreement.
    accepting the license agreement
  4. Select the Advanced install option and select the components you want to install on the machine.
    selecting Lansweeper components for installation
    If you're spreading out database, service and website over several machines, keep in mind that:
    • The database must be installed first, then the service and then the web console.
    • You need to reset the database password after installing all components, due to the installer adding a random password to the service and website configuration files. Instructions for resetting the database password can be found in this knowledge base article. If you don't reset the password, you'll see database login failures.
    • You need to copy the file below from the server hosting the web console to any servers hosting the Lansweeper service, replacing the default file generated on the servers. The Encryption.txt file is a key used to encrypt and decrypt credentials submitted in Lansweeper and must be the same on all servers hosting a Lansweeper component. If you're spreading out components over several machines, each server will have a unique file by default and you'll need to manually copy one of the files to all Lansweeper servers, so the encryption key is the same on all servers: Program Files (x86)\Lansweeper\Key\Encryption.txt
  5. Select the database server you want to use. If you are performing an Advanced Install, your preferred server will most likely be SQL Server. Hit Next to continue.
    selecting Lansweeper database server
  6. Submit the name of the SQL Server instance you want to install the Lansweeper database under. This should be the same SQL Server instance name you use when logging into other SQL tools like SQL Server Management Studio.
  7. Select the authentication method you want to use to connect to SQL Server and install the database from the Authentication dropdown. You can choose Windows authentication or SQL Server authentication. If you choose Windows authentication, the database installation is performed under the currently logged on Windows user. If you choose SQL authentication, you need to submit your SQL username and password. Hit Next to continue.
    selecting authentication method for database installation
    The user performing the database installation must be a member of your SQL Server's sysadmin server role. When the installation has completed, the Lansweeper service and web console will connect to the database with a newly created SQL user called lansweeperuser, which only has access to the Lansweeper database.
  8. If you are installing the Lansweeper web console, select the web server you want to install the console under. Selecting Recommended will install the web console under IIS Express, selecting Advanced will install the web console under IIS. The Advanced option will only be available if IIS is already enabled on your computer.
    selecting the Lansweeper web server
  9. Optionally, you can choose a custom HTTP and (if offered by the installer) HTTPS port to install the web console under. If you don't choose custom ports, the installer will automatically install the web console under the first available ports. Hit Next to continue.
  10. Optionally, you can choose a custom folder to install under. Hit Install to start the installation process.
    choosing the installation folder
    - The Lansweeper service will be installed under Windows Services.
    - The Lansweeper database will be installed under the SQL Server of your choice, will be called lansweeperdb and should not be renamed.
    - The Lansweeper web console will be installed under the web server of your choice and your preferred ports.
  11. When you get to the screen that confirms the successful installation of Lansweeper, hit Finish to close the installer.
    finishing the installer
  12. If you did not perform a full installation (service, database and web console), run the installer on any other machine you want to use to host Lansweeper. Click through the opening and license agreement screens and once again select the Advanced install option.
    selecting Lansweeper components for installation
    - Select the components (service and/or web console) you want to install on the machine.
    - Tick the SQL Server checkbox.
    - Point the installer to your existing SQL Server instance and Lansweeper database when prompted.
  13. If you spread out the installation over several machines, copy the file below from the server hosting the web console to any servers hosting the Lansweeper service, replacing the default file generated on the servers. The Encryption.txt file is a key used to encrypt and decrypt credentials submitted in Lansweeper and must be the same on all servers hosting a Lansweeper component. If you spread out components over several machines, each server will have a unique file by default and you'll need to manually copy one of the files to all servers, so the encryption key is the same on all servers.
    Program Files (x86)\Lansweeper\Key\Encryption.txt
  14. If you spread out the installation over several machines, reset the database password by following these instructions, to avoid seeing database login failures for the web console or scanning service. The Lansweeper installer adds a random database password to the scanning service and web console configuration files. If you don't reset the password, the scanning service and web console won't be able to connect to the database.

Related Articles