Skip to main content
Sign in

How to install the Server Agent - Manual and Silent

Jim Jessup
  • Updated

Prerequisites

  • Microsoft .NET Framework 4.7.X or above must be installed. It can be downloaded using this link https://support.microsoft.com/en-ca/help/4054530/microsoft-net-framework-4-7-2-offline-installer-for-windows
  • Supported Operating Systems: Microsoft Windows Server 2008 R2, 2012, 2012 R2, 2016 and 2019.
  • Server agent must be installed on at least one Active Directory Domain Controller
  • Member Servers are supported for Service Account rotation.
  • Install agent on all Domain Controllers for redundancy and to ensure Quickpass catches password resets performed on directly on all domain controllers. 
  • Active Directory functional level must be minimum Windows Server 2008 R2 or above. 
  • Ensure all Domain Controllers have the latest service packs installed and are fully patched. 

Download the Server Agent

1. Click the Download Server Agent link in the lower left hand corner of the Customers screen. 

mceclip0.png

Note: This will download the generic agent installer to your computer. After you have downloaded the agent you can proceed to either manually installing the agent on your customers server or using the silent / unattended installation method. 

mceclip3.pngmceclip4.png

Manual Install

 1. Ensure you have the agent installer located on the customers Active Directory server. Then right-click the agent installer named Quickpass-Agent-Setup.exe and select run-as-administrator.

mceclip5.png

mceclip6.png

Note: You may receive a warning from User Account Control asking for authorization to run the installer. In this case click Yes.

Depending on the Anti-Virus or Endpoint Security solution you have on the Active Directory server you may also need to add the installer as an exception if it attempts to block the install.

mceclip0.png

 

2. When the Quickpass Server Agent Setup window appears click Install. 

mceclip10.png

 

3. Click Next at the Quickpass Server Agent (64-bit) MSI Installer Setup screen. 

mceclip11.png

 

4. At the Quickpass server agent Installation window select your region from the drop down list. North America or Europe.

Note: The default region for Quickpass tenants is North America and corresponds to the Web dashboard URL of https://admin.getquickpass.com. Only select Europe if the URL for your tenant is https://eu-admin.getquickpass.com 

mceclip0.png

5. Click the Copy Agent ID option associated with your Quickpass customer in the Quickpass web dashboard Customers screen from the right hand menu. This will copy the customer ID associated with your Quickpass customer to your computers clipboard. 

mceclip0.png

 

6. Paste the customer ID copied from the Quickpass web portal in step 4 into the Customer GUID field

  mceclip1.png

7. Go back to the Quickpass web portal and navigate to the Settings Menu and to the Admin Login Details section. Then click the COPY button for the Install Token.

mceclip4.png 

8. At the Quickpass server agent installation window paste the Install Token copied from step 6 into the Install Token field.

Click out of the install token field and click Next to continue the install. 

mceclip2.png

9. Select the role of the server. 

mceclip0.png

10. Click Next at the Destination Folder window. 

mceclip15.png

11. Click Install at the Ready to install window. 

mceclip16.png

12. Click Finish when done. 

mceclip17.png

13. To complete the installation click Restart or click Close and manually restart at a later point. Without restarting the agent is fully operational except that the Active Directory password filter will not function until after the restart. 

mceclip1.png

Silent / Unattended Installation

The silent install can be installed through a DOS or PowerShell command line interface (CLI). Similarly you can also deploy the agent through your RMM solution. For deploying through your RMM solution please consult your vendor's documentation on how to push software remotely through their RMM agent. 

DOS 

1. Make a note of the folder you saved the installer to on the server. 

2. Open a DOS command prompt from the server you wish to install from and ensure you select Run as Administrator.

mceclip20.png

3. In the DOS command prompt change the directory to the folder you downloaded or saved the server agent to. 

mceclip21.png

4. Type in the agent installer executable followed by the following command line parameters.

Quickpass-Agent-Setup.exe /quiet INSTALLTOKEN="<InstallToken>" CUSTOMERID="<CustomerGUID>"

Ie. Quickpass-Agent-Setup.exe /quiet INSTALLTOKEN="146f5ad05aaea1e5c2c25015d1fb7495" CUSTOMERID="107f4f54-33d5-4eee-8d65-e8ac5cb6accd"

mceclip7.png

Member Servers: The default is the agent will be installed with the domain controller role. If you are installing on an Active Directory Member Server you need to specify the MEMBERSERVER="1" option to your silent installer script.

Ie. Quickpass-Agent-Setup.exe /quiet INSTALLTOKEN="146f5ad05aaea1e5c2c25015d1fb7495" CUSTOMERID="107f4f54-33d5-4eee-8d65-e8ac5cb6accd" MEMBERSERVER="1" 

Region: The default region will always be North America for the silent installation. To specify the Europe region for the silent installer you must add the REGION="EU" to your silent installer script. 

Ie. Quickpass-Agent-Setup.exe /quiet INSTALLTOKEN="146f5ad05aaea1e5c2c25015d1fb7495" CUSTOMERID="107f4f54-33d5-4eee-8d65-e8ac5cb6accd" REGION="EU"

No Restart: If desired there is also the option to force the installer not to reboot after installation. To use this option add a /norestart after /quiet in your silent installer script. 

Ie. Quickpass-Agent-Setup.exe /quiet /norestart INSTALLTOKEN="146f5ad05aaea1e5c2c25015d1fb7495" CUSTOMERID="107f4f54-33d5-4eee-8d65-e8ac5cb6accd"

The CUSTOMERID field can be copied from the Quickpass web dashboard Customers screen by clicking the Copy Agent ID option from the right hand menu. 

mceclip0.png

The INSTALLTOKEN can be copied from the Settings menu then Admin Login Details Section. 

mceclip4.png

5. When finished typing in the command type enter to execute the install. 

 

PowerShell

1. Make a note of the folder you saved the installer to on the server. 

2. Open a PowerShell command prompt and ensure you select Run as administrator. 

mceclip24.png

3. Type & followed by the full agent installer executable path in between "" followed by the following command line parameters.

& "C:\<PATH>\Quickpass-Agent-Setup.exe" /quiet INSTALLTOKEN="<InstallToken>" CUSTOMERID="<CustomerGUID>

mceclip8.png

Ie. & "C:\Users\username\Downloads\Quickpass-Agent-Setup" /quiet INSTALLTOKEN="146f5ad05aaea1e5c2c25015d1fb7495" CUSTOMERID="107f4f54-33d5-4eee-8d65-e8ac5cb6accd"

Member Servers: The default is the agent will be installed with the domain controller role. If you are installing on an Active Directory Member Server you need to specify the MEMBERSERVER="1" option to your silent installer script.

Ie. & "C:\Users\username\Downloads\Quickpass-Agent-Setup" /quiet INSTALLTOKEN="146f5ad05aaea1e5c2c25015d1fb7495" CUSTOMERID="107f4f54-33d5-4eee-8d65-e8ac5cb6accd" MEMBERSERVER="1" 

Region: The default region will always be North America for the silent installation. To specify the Europe region for the silent installer you must add the REGION="EU" to your silent installer script. 

Ie. & "C:\Users\username\Downloads\Quickpass-Agent-Setup" /quiet INSTALLTOKEN="146f5ad05aaea1e5c2c25015d1fb7495" CUSTOMERID="107f4f54-33d5-4eee-8d65-e8ac5cb6accd" REGION="EU"

No Restart: If desired there is also the option to force the installer not to reboot after installation. To use this option add a /norestart after /quiet in your silent installer script. 

Ie. & "C:\Users\username\Downloads\Quickpass-Agent-Setup" /quiet /norestart INSTALLTOKEN="146f5ad05aaea1e5c2c25015d1fb7495" CUSTOMERID="107f4f54-33d5-4eee-8d65-e8ac5cb6accd"

4. Type enter on your keyboard to execute the command. 

Verify Installation

Quickpass Web Portal

 

1. After the install is complete refresh the web page on the Quickpass web portal to verify that the server agent is checking in. Under the AD Status column you will see a green dot next to Online.

mceclip1.png

Note: If you navigate to the Quickpass Customer and select the Agents menu on the left hand side you will see more details about the agent. Also, if you install the agent on all of your domain controllers and members servers they will also show in this screen with their appropriate role. 

mceclip2.png

Services

Note: If you open the Services MMC snap-in by going to start -> run then typing services.msc you will see a service called Quickpass Server Agent.

mceclip9.png

mceclip2.png

MSA (Managed Service Account)

The Quickpass installer will create an MSA account to authenticate the Quickpass Windows Service. 

mceclip3.png

mceclip4.png

The MSA account will be added to the Domain Admins group to provide necessary permissions to Active Directory.

mceclip5.png

Note

  • MSA accounts cannot be used to log on locally to the server and can only be used to authenticate Windows Services
  • Quickpass will create a separate MSA account for each domain controller its installed on. 
  • For member servers or systems without Active Directory Quickpass will use the Local System Account for the Quickpass windows service authentication. 

Programs & Features

The server agent will contain two entries in Programs & Features. One is for the agent itself and the second if for the agent setup utility. 

mceclip10.png

Agent Auto Update 

The Quickpass server agent once installed will automatically update itself via a Windows Scheduled Task that will check Quickpass for new versions daily. You can verify find the Scheduled task by navigating to Administration Tools then Task Scheduler. The task will look similar to the image below. 

mceclip11.png

Next Steps

Related articles

Comments

0 comments

Please sign in to leave a comment.