Standard Installation

NOTE: If you are using an anti-virus software, please add the list of folders to exclude from antivirus scans. For more information, see Folders to Exclude from Antivirus Scans.

Use the standard installation steps if you do not have IIS set up, and you would like to install IIS through the PrinterLogic installation wizard.

Step 1: Provision a Server

Step 2: (Optional) Generate a SHA256 Certificate and then Install the Certificate in IIS

Step 3: (Optional) Replace a Security Certificate with your own Certificate

Step 4: (Optional) Enable SSL on Port 443

Step 5: Install PrinterLogic

Step 6: Set up your Admin Console Login Credentials

Step 7: Apply your PrinterLogic License to your Installation

Step 8: Log in to the Admin Console


Step 1: Provision a Server

A single server is required to install PrinterLogic. This server may be either physical or virtual (i.e. a VM), and must be running on a supported operating system. For a list of the hardware requirements for the server, see Requirements and Supported Environments. The following steps identify the process for provisioning a server to be used with PrinterLogic.

  1. Procure hardware or a virtual machine to host a supported operating system.
  2. Install the supported operating system on the server.
  3. Join the server to the domain.
  4. If a failover server is desired, simply provision a second server and complete the above steps for procuring the secondary server.
  5. Instead of connecting to the PrinterLogic server using the FQDN of the server, the recommendation is to create an alternate DNS record (either an A record (preferred) or a CNAME (record)) that points to the server, which is required for failover to a secondary server and usually makes it easier to remember and type (e.g. using printers.domain.com instead of HQ-PISRV08R2.domain.com).

Step 2: (Optional) Generate a SHA256 Certificate and then Install the Certificate in IIS

  1. Download and install OpenSSL from Shining Light.
  2. Create a folder in any location (My folder location is C:\OpenSSL).
  3. Open a command prompt [cmd] execute the following command.
  4. set OPENSSL_CONF=c:\OpenSSL-Win32\bin\openssl.cf

  5. Generate your Certificate request (CSR), specifying an SHA256 signature hash . Execute the following command.[point in to the OpenSSL installation folder\bin (C:\OpenSSL-Win32\bin)].
  6. openssl req -nodes -sha256 -newkey rsa:2048 -keyout C:\OpenSSL\PrivateKey.key -out C:\OpenSSL\CertificateRequest.csr

  7. When you are prompted for a few certificate fields, enter those fields as they appear.
  8. The following files will be generated:

    1. PrivateKey.key - contains the un-encrypted version of your private key – protect this file, as somebody who obtains it along with your signed public key can impersonate you.
    2. CertificateRequest.csr (your certificate signing request, which is not sensitive).

  9. Check which hash algorithm is currently used and execute the following command.
  10. certutil -getreg ca\csp\CNGHashAlgorithm

  11. If this command returns SHA256, skip to step 9.
  12. By default, the value shown above should return SHA1.

  13. Run the following command to configure the CA to use SHA256 for CNG hashes
  14. certutil -setreg ca\csp\CNGHashAlgorithm SHA25

  15. Restart Certificate Services.
  16. net stop CertSvc && net start CertSvc

  17. Execute Step 7 and make sure the current hash algorithm is SHA256
  18. Open a browser.
  19. Enter http://localhost/certsrv.
  20. Click Request a Certificate.
  21. Click Advanced Certificate Request.
  22. Click the second link as shown below.
  23. Navigate to the folder where CertificateRequest.csr is located (c:\OpenSSL).
  24. Open CertificateRequest.csr in a text editor and copy the encoded value.
  25. In the browser, paste the encoded values you copied in to the Base-64-encoded certificate request as shown below.
  26. Click Submit.
  27. Click the Base 64 encoded option and then click Download Certificate.
  28. Your .cer file will be downloaded.

  29. Copy your PrivateKey.key and CertNew.cer (from c:\OpenSSL) to the OpenSSL installation folder\bin (c:\OpenSSL-Win32\bin).

  30. Open a command prompt and execute the following script.
  31. openssl pkcs12 -inkey PrivateKey.key -in CertNew.cer -export -out CertNew.pfx

    Make sure you point to the OpenSSL-Win32 installation folder\bin (C:\OpenSSL-Win32\bin).

  32. Open the IIS Manager (run > inetmgr).
  33. Navigate to Server Certificates.
  34. Click Import.
  35. Select CertNew.pfx from the location you set up (c:OpenSSL-Win32\bin\CertNew.pfx).

Step 3: (Optional) Replace a Security Certificate with your Own Certificate

Install the Certificate

  1. Copy the SSL certificate to a location on the server.
  2. Click Start > Administrative Tools.
  3. Click Internet Information Services (IIS) Manager.
  4. In the Connections column, click the name of the server.
  5. Double-click Server Certificates.
  6. In the Actions column, click Complete Certificate Request.
  7. Click the Browse (...) button and select the server certificate you received from the certificate authority.
  8. If the certificate does not have a .cer extension, select View All Types.

  9. Type any friendly name you want so you can keep track of the certificate on the server.
  10. Click OK.
  11. If successful, you will see your newly installed certificate in the list. If you receive an error stating that the request or private key cannot be found, make sure you are using the correct certificate and that you are installing it to the same server that you generated the CSR on. If you are sure of those two things, you may just need to create a new Certificate Request and reissue/replace the certificate. Contact your certificate authority if you have problems with this.

Bind the Certificate to a Website

  1. In the IIS Manager under the Connections column, expand the Sites folder and click the website to which you would like to bind the certificate.
  2. Click Bindings.
  3. Click Add.
  4. In the Type: field, select https:.
  5. In the SSL Certificate field, select the certificate that you installed.
  6. Click OK.
  7. Click Close.

Install any Immediate Certificates

Most SSL providers issue server certificates off of an Intermediate certificate so you will need to install this Intermediate certificate to the server as well or your visitors will receive a Certificate Not Trusted Error. You can install each Intermediate certificate (sometimes there is more than one) using the following instructions.

  1. Download the intermediate certificate to a folder on the server.
  2. Double-click the certificate to open the certificate details.
  3. At the bottom of the General tab, click Install Certificate to start the certificate import wizard.
  4. Click Next.
  5. Select Place all certificates in the following store.
  6. Click Browse.
  7. Check Show Physical Stores and then expand the Intermediate Certification Authorities folder.
  8. Select the Local Computer folder.
  9. Click OK.
  10. Click Next.
  11. Click Finish.
  12. (Optional) Restart IIS to start giving out the new certificate.

NOTE: You can verify that the certificate is installed correctly by visiting the site in your web browser using https instead of http.

Step 4: (Optional) Enable SSL on Port 443

  1. Log in to the server you are using for PrinterLogic.
  2. Click Start.
  3. In the Search bar, type IIS Manager and then click Internet Information Services (IIS) Manager.
  4. When the IIS Service Manager window opens, click the arrow to the left of the server name.
  5. Click the arrow to the left of Sites.
  6. Click Default Web Site.
  7. Click Bindings.
  8. Click Add.
  9. When the Add Site Binding Window appears, select https in the Type field, enter 443 in the port field, and then select WMSVC in the SSL Certificate field.
  10. Click OK.
  11. In the Site Bindings window, click Close.
  12. Click Restart.

Step 5: Install PrinterLogic

Prior to the installation, you should have received an email with a link to the installation file you will use to download the installation files. If you have not received this email or link, please see your PrinterLogic sales representative. The following steps describe the process for installing PrinterLogic on your supported server.

  1. Open the installation email you received from your PrinterLogic sales representative or partner.
  2. Copy the link, which should appear as shown in the following example.
  3. NOTE: Do not copy and paste the link below into your browser. It is used here only as an example.

    http://downloads/printerlogic.com/PrinterInstallerSetup.exe

  4. Log in to your PrinterLogic server.
  5. Open a browser and paste the link you copied into the Address bar.
  6. Download the files to a folder on the PrinterLogic server.
  7. When the system finishes downloading the installation files, click Run.
  8. In the User Account window, click Yes when the system asks if you would like to make changes to the computer.
  9. Click Standard.
  10. Click Next.
  11. The following option will appear only if you have more than one website set up in the Internet Information Services (IIS) Manager on your PrinterLogic server.

    The following image shows the Internet Information Services (IIS) Manager with more than one website.

    You can delete one of the websites in the Internet Information Services (IIS) Manager and then try the PrinterLogic installation wizard again, or you can select one of the websites in the PrinterLogic installation wizard and then click Next.

    The installation wizard will run automatically and add the following items to your server.

    • IIS
    • PHP
    • PrinterLogic website files in the default website location
    • MySQL

    NOTE: The PrinterLogic database will not be created during installation. Rather, it is set up the first time you log in to the Admin Console.

    The installer will notify you when the installation is complete

  12. Click Close.

Step 6: Set up your Admin Console Login Credentials

  1. When the login screen appears, click anywhere in the Admin Username field and type the username of the person who will access the Admin Console.
  2. In the Email Address field, type the email address that the system will associate to the username.
  3. The email address will be used for features such as password recovery and alerts.

  4. Create a password that the user will enter to access the Admin Console.
  5. The password must be at least eight characters long and contain one number.

  6. Click Create and Log In.

Step 7: Apply your PrinterLogic License to your Installation

  1. Open the installation email you received from your PrinterLogic representative or partner.
  2. Copy the .dat file from the email.
  3. Open Windows Explorer on your PrinterLogic server.
  4. Navigate to c:\inetpub\wwwroot.
  5. Paste the printerinstaller.dat file into the wwwroot folder.
  6. If you are logged in to the Admin Console, log out and then log back in to ensure that any updates are applied to your installation.

Step 8: Log in to the Admin Console

  1. Open your preferred browser.
  2. In the Address Bar, enter the following information.
  3. <server name><fully qualified domain name>/admin

    The following image shows the login path as it should appear in the browser's Address bar.

  4. Press <ENTER> on your keyboard.
  5. The Admin Console will open in the browser window.