After creating the customer, access the menu Installations > Installers > Generate installer
In the Install Network Printer Monitoring option, click Select
Click Generate installer
In the side tab, select the desired customer
Click the Generate installer button
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.
When you click Send by email, a side tab will open
Define the recipients:
System emails: select users registered on the NDD Orbix portal;
External emails: enter the email address in the field indicated and click Add. Repeat the process until you have included all the desired emails;
Both.
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 all IP addresses configured (broadcast search): the agent will be installed ready to automatically search for all printers
After creating the customer, access the menu Installations > Installers > Generate installer
In the Install Network Printer Monitoring option, click Select
Click Customize
Select the desired customer
Enable the Automatic printer search option
Using the broadcast method, an automatic search for printers will be performed on all IP addresses in the subnets, using the SNMP protocol.
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.
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.
When you click Send by email, a side tab will open
Define the recipients:
System emails: select users registered on the NDD Orbix portal;
External emails: enter the email address in the field indicated and click Add. Repeat the process until you have included all the desired emails;
Both.
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 specific IP addresses configured: the agent will be installed ready to automatically search for the defined printers
After creating the customer, access the menu Installations > Installers > Generate installer
In the Install Network Printer Monitoring option, click Select
Click Customize
Select the desired customer
Disable the option Automatic printer search
Click the button Configure
To configure specific network addresses (supports IPv4 and IPv6):
Under Fixed network addresses, click View and edit
Click the ✚ button in the upper right corner
Under Add manually, enter the specific network address
Under Import CSV, upload a CSV file containing the addresses
Download the import template under Download template
Fill in the CSV file with the addresses
Save the CSV file and select or drag it to the portal
The maximum file size allowed is 100kb.
Click the Add button to add the addresses and remain on the add screen, or click the Add and Close button to add the addresses and return to the registration screen
To configure unicast search addresses (supports IPv4):
Under Search for unicast, click View and edit
Click the ✚ button in the upper right corner
Under Add manually, add the initial and final network addresses
In Import CSV, upload a CSV file containing the initial and final addresses
Download the import template at Download template
Fill in the CSV file with the initial and final addresses
Save the CSV file and select or drag it to the portal
The maximum file size allowed is 100kb.
Click the Add button to add the addresses and remain on the add screen, or click the Add and Close button to add the addresses and return to the registration screen
To configure broadcast search addresses (supports IPv4):
In Broadcast addresses, make the Search for printers by broadcast option active
To restrict the search to a specific location, click View and edit If no address is registered, the search will take place on the default subnet.
Click the ✚ buttonin the upper right corner
In Add manually, add the network address and subnet mask
In Import CSV, upload a CSV file containing the addresses and masks
Download the import model at Download template
Fill in the CSV file with the addresses and masks
Save the CSV file and select or drag it to the portal
The maximum file size allowed is 100kb.
Click the Add button to add the addresses and remain on the add screen, or click the Add and Close button to add the addresses and return to the registration screen
To configure the daily printer search:
In Schedule daily printer search, click View and edit
Click the ✚ button in the upper right corner
Enter the desired time
Click the Add button to add the time and remain on the add screen, or click the Add and Close button to add the time and return to the registration screen
To configure SNMP communication:
In Simple Network Management Protocol (SNMP) settings, click the + Add button
Enter the SNMP protocol settings
Click the Add button to add the SNMP protocol and remain on the add screen, or click the Add and Close button to add the SNMP protocol and return to the registration screen
Click the Save button
Click the Save button
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.
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.
When you click Send by email, a side tab will open
Define the recipients:
System emails: select users registered on the NDD Orbix portal;
External emails: enter the email address in the field indicated and click Add. Repeat the process until you have included all the desired emails;
Both.
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 (Windows and Linux)
Install manually on Windows operating system
Warning
If the gateway is used for communication between the agent and the portal, install the Gateway Connectorbefore 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.
Access the link generated by the portal to download the installer
Run the downloaded file
Select the desired language and click Próximo
First, the NDD - Queues Monitor, Microsoft .NET Runtime, Microsoft ASP.NET Core Runtime, and EpsonNet SDK for Windows applications will be installed. If they are already installed, steps 5 through 7 will be skipped, and the installation will proceed from step 8.
Click Next on the prerequisite installation welcome screen
Click Next to start installing the prerequisites
Wait for installation
Once the prerequisites have been installed, the installation of the DCA and Cloud Connector agent will begin.
Click Next on the agent installation welcome screen
Choose the Installation folder and Work folder and click Next
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.
Under Additional settings, if desired, select the type of communication (proxy or gateway) and click Next
If no option is selected, communication will take place directly between the agent and the portal
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
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.
Click Install
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 Connectorbefore 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.
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.
Step 3. Enable and configure monitoring rules (Windows and Linux)
Who can use this feature
Users with the Admin or Managing service rules and Enable or disable general service rule permissions
If the DCA and Cloud Connector agent is installed on Windows using the installer generated in Step 1. Generate the agent installer, the monitoring rules will be enabled and configured automatically, according to the computers or servers where it was installed.
Manual enablement and configuration are only necessary in the following cases:
When the agent was already installed to monitor another type of device.
When the agent is installed on Linux.
Go to Installations > Enable services
Locate the Network printer monitoring option
Click on the Edit button
Enable the service
If you enable it, all the registered rules will be activated. If you disable it, all the registered rules and the services that monitor network printers (NDD - Printer Monitor) will be deactivated.
Click the Save button
Click on the Configure Rules button
By default, the NDD Orbix portal will have a rule registered for all customers and all computers, but disabled. You therefore need to create specific rules to configure network printer monitoring for the computers you want.
Click the ✚button in the top right corner
In the side tab, select the computer you want to enable network printer monitoring on (the agents installed on the selected computer will be monitored)
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
You can select and add only one computer at a time.
When the rule is created, the services of the agents linked to the computer will be synchronized. The service will then be immediately available for other configurations.
If synchronization fails when the rule is created, select the desired rule in the grid and click the Synchronize button in the top right corner. If there is no synchronization, the service will only be available when the agent is next read.
If a rule is deleted and no new rules are registered for the same computer, device monitoring will stop.
Step 4. Configure the service (Windows and Linux)
Service configuration is only necessary in the following cases:
When the Windows installer was generated without previously configured IP addresses.
When the agent is installed on Linux.
In both scenarios, access the documentation below to define which printers will be monitored:
Step 5. Classify the printers to be managed (Windows and Linux)
Who can use this feature
Users with the Administrator or Manage new devices permission
After completing the previous steps, all network printers identified by the agent will be automatically registered in the portal. From that point on, the system will begin collecting registration data, meter readings, supplies, and events.
Newly identified printers remain available in the Devices > New devices menu for up to 15 days. If no action is taken within this period, the printer will be automatically classified as managed.
For this reason, manual classification of printers is an optional configuration. It allows the provider to evaluate newly identified printers and define which devices will be managed or unmanaged by the NDD Orbix portal before they are automatically classified as managed after the 15-day period.
Whenever the agent identifies new printers on the network, they will be made available in the Devices > New devices menu for classification. At that point, the 15-day period will begin. The entry date can be found in the corresponding column of the grid.
If you want to classify the devices manually before automatic classification, follow the steps below:
Go to the Devices > New devices menu
Select the desired devices
To access the device properties, click on its name
Click the Manage or Not manage button
Depending on the classification performed:
Managed printers will be moved to the Devices > Inventory and Monitoring > Printers menus.
Unmanaged printers will be moved to the Devices > Unmanaged menu.
In both cases, you can view the device’s entry date in the grid of the respective menu.
Warning
Moving a printer between customers does not cause it to be considered a new device. However, when a printer is moved between providers, it is processed as a new device and will become available again in the Devices > New devices menu for classification.
As long as the printer remains in the Devices > New devices menu, it will not be considered for provider billing purposes. However, the collection of registration data, meter readings, supplies, and events will continue as usual.
Information
The initial classification defines the device’s status after it is identified, but the management status can be changed later, as instructed at Stop managing or return to managing printers.