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 an Active Directory Domain Controller.
Download the Server Agent
1. Click the Download Server Agent link in the lower left hand corner of the Customers screen.
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.
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.
Note: You may receive a warning from Windows Defender asking for authorization to run the installer. In this case click More Info then Run anyway after. If user account control is enabled, click Allow to continue.
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.
2. When the Quickpass Server Agent Setup window appears click Install.
3. Click Next at the Quickpass Server Agent (64-bit) MSI Installer Setup screen.
4. Click the COPY ID button associated with your Quickpass customer in the Quickpass web portal Customers screen under the Setup column. This will copy the customer ID associated with your Quickpass customer to your computers clipboard.
5. At the Quickpass Portal Login page enter your Quickpass login email, password and paste the customer ID that you copied in step 4 from the Quickpass web portal into the Customer GUID field.
When done click Next.
6. Click Next at the Destination Folder window.
7. Click Install at the Ready to install window.
8. Click Finish when done.
9. Click Close at the Quickpass Server Agent Setup window to complete the install.
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.
3. In the DOS command prompt change the directory to the folder you downloaded or saved the server agent to.
4. Type in the agent installer executable followed by the following command line parameters.
Quickpass-Agent-Setup.exe /quiet AGENTUSERNAME="<AgentUserName>" AGENTPASSWORD="<AgentPassword>" CUSTOMERID="<CustomerGUID>"
Ie. Quickpass-Agent-Setup.exe /quiet AGENTUSERNAME="name@email.com" AGENTPASSWORD="PASSWORD123456789" CUSTOMERID="97f32597-88e7-4123-a0e4-11a7e595061e"
Note: The CUSTOMERID field can be copied from the Quickpass web portal Customers screen under the Setup column.
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.
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 AGENTUSERNAME="<AgentUserName>" AGENTPASSWORD="<AgentPassword>" CUSTOMERID="<CustomerGUID>
Ie. & "C:\Users\username\Downloads\Quickpass-Agent-Setup" /quiet AGENTUSERNAME="name@email.com" AGENTPASSWORD="PASSWORD123456789!" CUSTOMERID="97f32597-88e7-4123-a0e4-11a7e595061e"
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 Status column you will see a green dot next to Online.
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.
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.
Next Steps
- Import Users from Active Directory into Quickpass https://support.getquickpass.com/hc/en-us/articles/360035207914-How-to-Import-Users-into-Web-Admin-Console
Comments
0 comments
Please sign in to leave a comment.