Breadcrumbs

Start remote administration of queues and drivers

Remote administration of queues and drivers begins with:

  • The installation of the DCA and Cloud Connector agent on all computers that will use or may use the print queues;

  • The enabling and configuration of monitoring rules;

  • The configuration of the SNMP protocol for network printers (if necessary, if the default settings do not meet requirements);

  • The configuration of the drivers and print queues.

Instructions

Follow the steps below to start remote administration of queues and drivers:

Step 1. Generate the agent installer

Who can use this feature

Users with the Admin or Generate installer permissions

The installer is generated directly in the NDD Orbix portal and can be customized according to the organization's needs:

Warning

If the agent is already installed to monitor another device, it is not necessary to reinstall it on the same computer.

In this case, go directly to Step 3. Enable and configure monitoring rules and following.

Generate an installer with direct or proxy communication
  1. Create the customer, as instructed at Create customer, site and department

  2. After creating the customer, access the menu Installations > Installers > Generate installer

  3. In the Install Local Monitoring option, click Select

  4. Click Generate installer

  5. In the side tab, select the desired customer

  6. Click the Generate installer button

  7. Copy the link of the generated installer or click Send by email to send the installer link to the configured emails
    When pasted into the browser, the file download will start automatically.

    1. When you click Send by email, a side tab will open

    2. Define the recipients:

      1. System emails: select users registered on the NDD Orbix portal;

      2. External emails: enter the email address in the field indicated and click Add. Repeat the process until you have included all the desired emails;

      3. Both.

    3. Click the Send installer button to immediately send the installer link to the configured emails

The link is valid for 90 days. After this period, you will need to generate a new installer.

Generate an installer with gateway communication
  1. Create the customer, as instructed at Create customer, site and department

  2. After creating the customer, access the menu Installations > Installers > Generate installer

  3. In the Install Local Monitoring option, click Select

  4. Click Customize

  5. Select the desired customer

  6. In the Communicator connection to the cloud field, if Gateway Connector is being used to communicate with NDD Orbix servers, enter the address (IP or hostname) and port of the computer/server where Gateway Connector was installed, in the following format: IP:port
    If filled in, the address and port will be predefined in the installer.

💡

Example

192.168.0.1:9635

Information

To install Gateway Connector, access Install the gateway on Windows.

  1. Click the Generate installer button

  2. Copy the link of the generated installer or click Send by email to send the installer link to the configured emails
    When pasted into the browser, the file download will start automatically.

    1. When you click Send by email, a side tab will open

    2. Define the recipients:

      1. System emails: select users registered on the NDD Orbix portal;

      2. External emails: enter the email address in the field indicated and click Add. Repeat the process until you have included all the desired emails;

      3. Both.

    3. Click the Send installer button to immediately send the installer link to the configured emails

The link is valid for 90 days. After this period, you will need to generate a new installer.

Step 2. Install the agent in the environment

Currently, the installation of DCA and Cloud Connector for remote queue and driver administration is only available for Windows operating systems.

Install manually on Windows operating system

Warning

If the gateway is used for communication between the agent and the portal, install the Gateway Connector before installing the DCA and Cloud Connector agent.

Note

The installer is customized for each customer and cannot be used for customers other than the one selected at the time of generation.

  1. Check the installation prerequisites at Agent installation prerequisites

  2. Access the link generated by the portal to download the installer

  3. Run the downloaded file

  4. Select the desired language and click Próximo

First, the Microsoft .NET Runtime, Microsoft ASP.NET Core Runtime, EpsonNet SDK for Windows, and PawnIO applications will be installed. If they are already installed, steps 5 through 7 will be skipped, and the installation will proceed from step 8.

  1. Click Next on the prerequisite installation welcome screen

  2. Click Next to start installing the prerequisites

  3. Wait for installation

Once the prerequisites have been installed, the installation of the DCA and Cloud Connector agent will begin.

  1. Click Next on the agent installation welcome screen

  2. Choose the Installation folder and Work folder and click Next

  3. Click Next on the provider and customer information screen.
    The fields will be filled in automatically according to the configurations generated in the installer portal.

  4. Under Additional settings, if desired, select the type of communication (proxy or gateway) and click Next

    1. If no option is selected, communication will take place directly between the agent and the portal

    2. If Use proxy for communication with NDD Orbix servers is selected, enter the necessary proxy connection settings (address, port and authentication, if any) and click Next

    3. If Use Gateway Connector to communicate with NDD Orbix servers option is selected, enter the address (IP or hostname) and port of the computer/server where the Gateway Connector was installed and click Next
      If the address and port have been previously configured in the NDD Orbix portal when generating the installer, these fields will already be filled in.

  5. Click Install

  6. Wait for installation and click Finish

Install silently on Windows operating system

Warning

If the gateway is used for communication between the agent and the portal, install the Gateway Connector before installing the DCA and Cloud Connector agent.

Note

The installer is customized for each customer and cannot be used for customers other than the one selected at the time of generation.

  1. Check the installation prerequisites at Agent installation prerequisites

  2. Run the downloaded file via Command Prompt

    1. Navigate to the directory where the agent executable is located via Command Prompt

    2. Enter the name of the executable (NDD - Network printer monitoring.exe or NDD - Local monitoring.exe)

    3. Enter the other desired parameters, listed below

💡

Example

C:\Downloads\DCA> NDD - Network printer monitoring.exe APPDIR=C:\test WORKFOLDER=C:\test /quiet

DCA and Cloud Connector silent installation parameters

The parameters with "*" are mandatory and must be observed.

The parameters with "**" may become mandatory depending on other parameters used.

Warning

The silent installation of DCA and Cloud Connector must be performed using the parameters documented below. The other options displayed in the installer help (/? or /help) should be disregarded.

APPDIR – Configures the installation directory of DCA and Cloud Connector
  • Setup option: enter the path where you want to install the agent.

  • Requirement: optional.

  • Behavior if not configured: installs in the default directory: C:\Program Files (x86)\NDD TECH\DCA and Cloud Connector.

  • Example: APPDIR=C:\test

WORKFOLDER – Configures the directory of the DCA and Cloud Connector work folder
  • Setup option: enter the path where you want to create the agent's work folder.

  • Requirement: optional.

  • Behavior if not configured: installs in the default directory: C:\NDD TECH\Workfolder.

  • Example: WORKFOLDER=C:\test

ENABLEPROXY – Enables the use of the proxy
  • Setup option: checked = enabled.

  • Requirement: optional (do not use the parameter if you do not want the proxy to be enabled).

  • Behavior if not configured: proxy will not be enabled.

  • Example: ENABLEPROXY=checked

**PROXYADDRESS – Configures the proxy server address
  • Setup option: enter the proxy address.

  • Requirement: mandatory if proxy use is enabled (ENABLEPROXY=checked).

  • Behavior if not configured: proxy will not be configured correctly.

  • Example: PROXYADDRESS=192.168.17.10

**PROXYPORT – Configures the communication port of the proxy server
  • Setup option: enter the proxy port number.

  • Requirement: mandatory if proxy use is enabled (ENABLEPROXY=checked).

  • Behavior if not configured: proxy will not be configured correctly.

  • Example: PROXYPORT=12

ENABLEGATEWAY - Enables the use of the gateway
  • Setup option: checked = enabled.

  • Requirement: optional (do not use the parameter if you do not want the gateway to be enabled).

  • Behavior if not configured: gateway will not be enabled.

  • Example: ENABLEGATEWAY=checked

**GATEWAYADDRESS - Configures the gateway address
  • Setup option: enter the address (IP or hostname) of the computer/server where the Gateway Connector was installed.

  • Requirement: mandatory if gateway use is enabled (ENABLEGATEWAY=checked).

  • Behavior if not configured: gateway will not be configured correctly.

  • Example: GATEWAYADDRESS=192.168.17.10

**GATEWAYPORT - Configures the communication port of the gateway
  • Setup option: enter the gateway port number.
    The default gateway port is 9635, but you can enter another one if you wish.

  • Requirement: mandatory if gateway use is enabled (ENABLEGATEWAY=checked).

  • Behavior if not configured: gateway will not be configured correctly.

  • Example: GATEWAYPORT=12

Step 3. Enable and configure monitoring rules

Who can use this feature

Users with the Admin or Managing service rules and Enable or disable general service rule permissions

When you install the agent, no services will be enabled. The next step is to enable the service in the NDD Orbix portal according to your needs, so that the agent takes over the service and performs monitoring of the devices.

  1. Go to Installations > Enable services

  2. Locate the Print queues option

  3. Click on the Edit button

  4. Enable the service
    If you enable it, all the registered rules will be activated.
    If you disable it, all the registered rules and the print queues services (NDD - Print Queue) will be deactivated, and the print queues will be removed from the computers.

  5. Click the Save button

  6. Click on the Configure Rules button

By default, the NDD Orbix portal will have a rule registered for all customers, but disabled. It is therefore necessary to create specific rules to configure print queue management for the desired customers.

  1. Click the ✚ button in the top right corner

  2. In the side tab, select the customers you want the print queue service to be enabled for (the agents installed on the selected customers will be monitored)

  3. Click the Add button to create the rule and remain on the add screen, or the Add and Close button to create the rule and return to the grid

If a rule is deleted and no new rules are registered for the same customer, device monitoring will stop.

Step 4. Configure the SNMP protocol for network printers in the remote administration feature for queues and drivers

Configuring SNMP protocol for TCP/IP print queues is necessary so that printers can be identified when queues are created.

Note

The registered SNMP protocol settings will be applied to printers in the remote administration of queues and drivers, and EcoPrint.

In the SNMP connection, when using v1/v2 or v3, you can configure a time interval (in milliseconds) between each SNMP call made to the printer.

By default, the NDD Orbix portal will have an SNMP protocol registered for all customers, with the following settings:

  • Customer: All

  • SNMP entry name: Default

  • Answer time (ms): 3,000

  • Number of attempts: 3

  • Reading community: public

  • Protocol: v1/v2

Review the default configuration to identify whether it will meet your needs. It cannot be deleted.

If necessary, create specific configurations for customers who have different SNMP parameters than the default, as instructed below, considering that the specific configurations will take precedence over the default configuration.

Always keep SNMP connections up to date.

Information

The interval at which the agent searches for printers will depend on the answer time and the number of attempts configured in the protocol. Thus, each search can be a minimum of 5 minutes and a maximum of 30 minutes, depending on the configuration. However, if there is an error during the printer search, this time can be extended.

Who can use this feature

Users with the Admin or Administration of SNMP settings permission

  1. Go to Settings > SNMP protocol

  2. Click on the button ✚ in the top right corner

  3. Select the customer that will be linked to this protocol configuration

  4. Enter the other protocol settings

  5. Click the Save button

More than one SNMP protocol can be created per customer, as long as these settings contain different SNMP entry names.

Step 5. Configure the drivers and print queues

Access the documentation below to configure the drivers and print queues: