Install the Client & Web Extension

There are several methods for installing the Virtual Appliance Client on your device. The steps below guide you through the process on the Admin Console. Alternatively, you can visit your Self-service Portal, follow the prompts to install the extension, and then download and install the Client.

1. Generate an Authorization Code

You must use an authorization code to authorize the installed Client to communicate with your Virtual Appliance instance. You can use an existing code or generate a new one.

For more details refer to Device Authorization.

2. Download the Client

1. In the Admin Console, go to Tools Settings Client.
2. Scroll down to the Deployable Client Packages section.

3. Select the file type for the desired package.

   

4. Save the .pkg file in the /tmp file directory. You can use the following command to download the file and place it in the /tmp file directory:

PIC="PrinterInstallerClientSetup.pkg"
if [[ $(uname -m) == 'arm64' ]]; then
PIC="PrinterInstallerClientSetup_arm64.pkg"
fi
curl -o /tmp/PrinterInstallerClientSetup.pkg <HOME_URL_HERE>/client/setup/$PIC

Replace <HOME_URL_HERE> with your instance's URL.

3. Install the Client

1. After downloading the file, open a terminal window and navigate to the downloaded file.

2. Run the following command:

   Copy Code

   sudo installer -allowUntrusted -pkg /tmp/PrinterInstallerClientSetup.pkg -target / && sudo /opt/PrinterInstallerClient/bin/set_home_url.sh https <HOME_URL_HERE> && sudo /opt/PrinterInstallerClient/bin/use_authorization_code.sh <AUTH_CODE_HERE>

   Replace <HOME_URL_HERE> with your instance's URL, and replace <AUTH_CODE_HERE> with your authorization code.

3. After the installation completes, use the status menu (if enabled) or visit your Self-service Portal to confirm that the Client is installed and authorized.
   • To access your Self-service Portal, you can enter the URL in a new browser tab or, in the Admin Console, select Tools PrinterLogic Portal.

4. Initialize the Safari Extension

If you are using Safari for macOS, you must enable the browser extension using the steps below before visiting the Self-service Portal.

1. Run the following command to initialize the PrinterLogic Extension, and then press Enter:

   Copy Code

   open -gn /opt/PrinterInstallerClient/service_interface/PrinterInstallerClient.app

   

2. Open Safari again.

3. From the Safari menu, select Settings.

   

4. Select the PrinterLogic Extension, and then select Turn On.

   

5. In the Admin Console, navigate to Tools PrinterLogic Portal.
6. Log in to your Self-service Portal, and confirm that the Client and extension are installed and enabled.

The browser extension only ensures full functionality of Virtual Appliance while using the browser. Clicking the extension does not provide any additional options. Virtual Appliance features are only available through the Client in the status menu.

5. General Commands & Overrides

Refer to Client Commands and Override Options for Mac & Linux for scripts and variables to further adjust the Client to better suit your environment.

The following are required to install the Virtual Appliance Client:

• A Google admin account for a managed service.
• A Virtual Appliance authorization code.
• ChromeOS Client installation.

The ChromeOS Client is only compatible with the Google Identity service; it does not work with other Identity Providers (IdPs) An identity provider (IdP) is a system entity that creates and manages identity information for an organization and can be authenticated by a computer system or network. An IdP is referred to as a security principal in Java and Microsoft documentation. An IdP also provides authentication services to relying apps in a federation or distributed network..

1. Generate an Authorization Code

You must use an authorization code to authorize the installed Client to communicate with your Virtual Appliance instance. You can use an existing code or generate a new one.

For more details refer to Device Authorization.

2. Create the Client

1. Open a new browser tab.
2. Navigate to admin.google.com, and log in to your admin account.
3. From the left-side menu, select Devices Chrome Apps & extensions.

4. Select the Users & browsers tab.

   

5. Select the + (plus) icon in the lower-right corner.

6. Select the second button from the top: Add Chrome app or extension by ID.

   

7. Copy the following code, and paste it in the Add Chrome app or extension by ID modal.
   Copy Code

    llhfdhidddepenjnklbngmapjohlbekh

   

8. Select Save.

3. Configure the Client

1. Select the PrinterLogic Client Extension.

2. On the right side, select Allow install and select Force install + pin to browser toolbar from the dropdown menu.

   

3. Copy the following code:

   Copy Code

   1
   2
   3
   4
   {
   "pi url": {"Value":"<ENTER_URL_HERE>"},
   "auth_code": {"Value":"ENTER_CODE HERE"}
   }

4. On the right-side panel, scroll down to the Policy for extensions section and paste the code. By default, this section displays Enter a JSON value.

5. After you paste the code, you can edit it directly in the browser.

   Replace <ENTER_URL_HERE> with your instance URL, and replace ENTER_CODE HERE with your authorization code.

   

6. Select Save in the upper-right corner.

The ChromeOS Client includes features designed specifically for ChromeOS, such as spooling print jobs. The extension appears after the policy updates on the device.

The PrinterLogic Client extension policy applies to all users in the selected organizational group. You can skip the remaining sections in this topic.

We recommend using the latest version of Common UNIX Printing System (CUPS) printer to successfully install the Client.

1. Generate an Authorization Code

You must use an authorization code to authorize the installed Client to communicate with your Virtual Appliance instance. You can use an existing code or generate a new one.

For more details refer to Device Authorization.

2. Installation Instructions

The installation commands below support Ubuntu (LTS) 22.04 and 24.04.

1. Get the Client install .deb file from the server:

   Copy Code

   64 bit

   wget https://<HOME_URL_HERE>/client/setup/printerinstallerclient_amd64.deb

   Replace <HOME_URL_HERE> with your instance's URL.

2. Install the Client, set the home URL, and authorize the Client with the following command:

   Copy Code

   64 bit

   sudo apt update && sudo apt install -y ./printerinstallerclient_amd64.deb
   sudo /opt/PrinterInstallerClient/bin/set_home_url.sh https <HOME_URL_HERE> && sudo /opt/PrinterInstallerClient/bin/use_authorization_code.sh <AUTH_CODE_HERE>

   Replace <HOME_URL_HERE> with your instance's URL, and replace <AUTH_CODE_HERE> with your authorization code.

3. General Commands & Overrides

Refer to Client Commands and Override Options for Mac & Linux for scripts and variables to further adjust the Client to better suit your environment.

1. Generate an Authorization Code

You must use an authorization code to authorize the installed Client to communicate with your Virtual Appliance instance. You can use an existing code or generate a new one.

For more details refer to Device Authorization.

2. Installation Instructions

3. General Commands & Overrides

Refer to Client Commands and Override Options for Mac & Linux for scripts and variables to further adjust the Client to better suit your environment.