xxnullxx - 67e3fe10c36b866c91b6a0ed

RICOH Data Collector

Ricoh Company, Ltd

1 RICOH Data Collector

RICOH Data Collector is a web-based application that lets you collect information from printers. The information is stored in the cloud where it becomes available to other connected applications.

1.1 Overview of RICOH Data Collector

RICOH Data Collector is a web-based application that lets you collect information from printers. The information is stored in the cloud where it becomes available to other connected applications.

You can configure the data sources that RICOH Data Collector queries and the type of information that you want to obtain, define security settings, and view activity logs.

    Important:
  • You cannot view the stored data on the RICOH Data Collector user interface. All the collected data is sent to connected applications, such as RICOH Predictive Insight, which process and display the information for easy monitoring and analysis.
  • When RICOH Data Collector is not connected to the cloud, you cannot add, edit, or delete a data source. When the connection with the cloud is restored, all functions are enabled.

1.1.1 What's New?

This page provides information about new or improved functions, fixed defects, and deprecated functionality.
Important: To benefit from the new or improved functions, fixes, and security updates, make sure that you always upgrade to the latest version of RICOH Data Collector.
December 4, 2025
  • Updated the list of supported operating systems. Removed support for Windows Server 2010. For more information, see Computer Requirements.
  • Updated the supported web browser versions to Google Chrome 135 or later, Mozilla Firefox 135 or later and Microsoft Edge 135 or later. For more information, see Computer Requirements.
  • Various security updates.
  • Minor bug fixes.
November 13, 2025
  • Various security updates.
  • Minor bug fixes.
October 23, 2025
October 2, 2025
  • Added support for RICOH Data Collector auto update, allowing scheduled updates based on configurable time zone, start time, and selected weekdays. Update results are shown in Notifications History. For more information, see Configuring Auto Updates in Data Collector.
  • Various security updates.
  • Minor bug fixes.
September 11, 2025
  • Added support for the Pro 8420S Fiery JPN-EB-36 and Pro 8420S Fiery EB-36 printers. For more information, see Supported Printers.
  • Various security updates.
  • Minor bug fixes.
August 21, 2025
  • Added support for the Pro 8420 GW and Pro 8420S GW printers. For more information, see Supported Printers.
  • Various security fixes including CVE-2025-48924.
  • Minor bug fixes.
July 31, 2025
  • Added support for the Pro C5410S GW printer. For more information, see Supported Printers.
  • Various security updates.
  • Minor bug fixes.
July 10, 2025
  • Added support for the PRO Z75 N-500 printer. For more information, see Supported Printers.
  • Various security updates.
  • Minor bug fixes.
June 19, 2025
  • Various security fixes including CVE-2025-46701.
  • Minor bug fixes.
May 29, 2025
  • Added guidelines about how to set your operating system's language settings to use UTF-8 encoding if you need to use special characters in the file path. For more information, see Common Problems.
  • Various security fixes including CVE-2021-42392, CVE-2022-23221, CVE-2021-23463, CVE-2018-14335, and CVE-2025-31651.
  • Minor bug fixes.
May 8, 2025
  • Various security updates.
  • Minor bug fixes.
April 17, 2025
  • Various security updates.
  • Minor bug fixes.
April 2, 2025
  • Changed the product name. RICOH Supervisor Data Collector is now called RICOH Data Collector.
  • Various security updates.
  • Minor bug fixes.
March 14, 2025
  • Various security updates.
  • Minor bug fixes.
March 6, 2025
  • Various security fixes including CVE-2024-50379 and CVE-2024-54677.
  • Minor bug fixes.
February 13, 2025
  • Various security updates.
  • Minor bug fixes.
January 31, 2025
  • Various security updates.
  • Minor bug fixes.
January 23, 2025
  • Various security fixes including CVE-2024-6763 and CVE-2024-47535.
  • Minor bug fixes.
December 31, 2024
  • Various security updates.
  • Minor bug fixes.
December 20, 2024
  • Various security updates.
  • Minor bug fixes.
December 5, 2024
  • Various security fixes including CVE-2024-52316.
  • Minor bug fixes.
November 21, 2024
  • Various security updates.
  • Minor bug fixes.
October 31, 2024
  • Various security updates.
  • Minor bug fixes.
October 10, 2024
  • Various security updates.
  • Minor bug fixes.
September 19, 2024
  • Various security updates.
  • Minor bug fixes.
August 29, 2024
  • Added the minimum supported code version for continuous form printers. For more information, see Supported Printers.
  • Various security fixes including CVE-2024-34750.
  • Minor bug fixes.
August 8, 2024
  • Various security updates.
  • Minor bug fixes.
July 18, 2024
  • Improved the information about the following ports: Port 80, Port 443, and Port 53. For more information, see Computer Requirements.
  • Various security updates.
  • Minor bug fixes.
June 27, 2024
  • Various security updates.
  • Minor bug fixes.
June 17, 2024
  • Various security updates.
  • Minor bug fixes.
June 6, 2024
  • Various security updates.
  • Minor bug fixes.
May 28, 2024
  • Various security updates.
  • Minor bug fixes.
May 21, 2024
  • Various security updates.
  • Minor bug fixes.
May 16, 2024
  • Various security updates.
  • Minor bug fixes.
April 25, 2024
  • Various security fixes including CVE-2024-29025.
  • Minor bug fixes.
April 4, 2024
  • Updated the list of allowed URLs and domains for installing RICOH Data Collector. For more information, see Computer Requirements.
  • Various security updates.
  • Minor bug fixes.
March 14, 2024
February 29, 2024
  • Various security updates.
  • Minor bug fixes.
February 22, 2024
  • Various security fixes including CVE-2023-46589.
  • Minor bug fixes.
February 1, 2024
  • Added support for Pro VC80000 TotalFlow Print Server and RICOH ProC7500 printers. For more information, see Supported Printers.
  • Various security fixes including CVE-2024-21634.
  • Minor bug fixes.
January 11, 2024
  • Various security updates.
  • Minor bug fixes.
December 21, 2023
  • Enable the RICOH API for Fiery feature for RICOH Pro9500 printers. For more information, see RICOH Fiery Cut Sheet Printer .
  • Various security updates.
  • Minor bug fixes.
November 29, 2023
  • Various security fixes including CVE-2023-35116, CVE-2023-40167, CVE-2023-36478, CVE-2023-4586, and CVE-2023-46233.
  • Minor bug fixes.
November 9, 2023
  • Updated the list of supported operating systems. Removed support for Windows Server 2012. For more information, see Computer Requirements.
  • Updated the supported web browser versions to Google Chrome 116 or later, Mozilla Firefox 116 or later and Microsoft Edge 116 or later. For more information, see Computer Requirements.
  • Added information about the length limit for job names for each printer type. For more information, see Collected Data and Common Problems.
  • Various security updates.
  • Minor bug fixes.
October 18, 2023
  • Various security updates.
  • Minor bug fixes.
September 28, 2023
  • Various security updates.
  • Minor bug fixes.
September 7, 2023
  • Various security updates.
  • Minor bug fixes.
August 17, 2023
  • Various security fixes including CVE-2023-35116 and CVE-2023-34462.
  • Minor bug fixes.
July 27, 2023
  • Improved the data collected from Fiery printers, by adding new RICOH API for Fiery attributes to the widget library. For Fiery printers, RICOH Data Collector starts collecting the following job data through RICOH API for Fiery:
    • Black & white printed pages
    • Color printed pages
    • Blank printed pages
    • Tabs printed
    • Rip duration (Seconds)
    For more information, see Collected Data.
  • Various security updates.
  • Minor bug fixes.
July 6, 2023
  • Various security updates.
  • Minor bug fixes.
June 15, 2023
May 18, 2023
  • Added support for enabling and disabling the feature number 5565 on the physical printer. For more information, see Editing Printer Properties.
  • Various security updates.
  • Minor bug fixes.
April 27, 2023
  • Added guidelines in the Troubleshooting and Support section about how to manually uninstall RICOH Data Collector. For more information, see Common Problems.
  • Various security updates.
  • Minor bug fixes.
April 6, 2023
  • Various security updates.
  • Minor bug fixes.
March 23, 2023
  • Various security updates.
  • Minor bug fixes.
March 16, 2023
  • Various security fixes including CVE-2022-41915.
  • Minor bug fixes.
February 23, 2023
  • Various security updates.
  • Minor bug fixes.
February 16, 2023
  • Various security updates.
  • Minor bug fixes.
February 2, 2023
  • Updated the list of supported operating systems. Added support for CentOS Stream 8, openSUSE Leap Desktop 15.4 or higher and removed support for Windows 8.1. For more information, see Computer Requirements.
  • Updated the supported web browser versions to Google Chrome 108 or later, Mozilla Firefox 108 or later and Microsoft Edge 108 or later. For more information, see Computer Requirements.
  • Various security updates.
  • Minor bug fixes.
January 31, 2023
  • Various security updates.
  • Minor bug fixes.
January 13, 2023
  • Added the RICOH Pro Scanner option for RICOH Pro VC 60000 and 70000 printers, that provides data about print head cleaning, quality control, and collected logs. For more information, see Editing Printer Properties.
  • Various security updates.
  • Minor bug fixes.
December 22, 2022
  • Added information about how to address issues with Blocked URLs in the Troubleshooting and Support section.
  • Various security fixes including CVE-2021-37137, CVE-2021-37136, CVE-2019-20445, CVE-2019-20444, CVE-2022-24823, CVE-2021-21290, CVE-2021-43797, CVE-2020-11612, and CVE-2022-31160.
  • Minor bug fixes.
November 17, 2022
  • Various security updates.
  • Minor bug fixes.
October 27, 2022
  • Various security updates.
  • Minor bug fixes.
October 6, 2022
  • Various security updates.
  • Minor bug fixes.
September 15, 2022
August 25, 2022
  • Various security fixes including CVE-2022-34305.
  • Minor bug fixes.
August 4, 2022
  • Various security fixes including CVE-2022-2047.
  • Minor bug fixes.
July 14, 2022
  • Various security fixes.
  • Minor bug fixes.
June 23, 2022
  • Updated the list of supported operating systems. Added support for Windows 11 and Windows Server 2022. For more information, see Computer Requirements.
  • Updated the supported web browser versions to Google Chrome 99 or later, Mozilla Firefox 99 or later and Microsoft Edge 99 or later. For more information, see Computer Requirements.
  • Various security fixes.
  • Minor bug fixes.
June 2, 2022
  • Improved the accuracy of job data collected through RICOH API for Fiery on Fiery printers. For more information, see RICOH Fiery Cut Sheet Printer .
  • Various security fixes.
  • Minor bug fixes.
May 16, 2022
  • Various security fixes.
  • Minor bug fixes.
April 21, 2022
  • Minor bug fixes.
April 14, 2022
  • Minor bug fixes.
March 10, 2022
  • Minor bug fixes.
February 17, 2022
  • Minor bug fixes.
February 10, 2022
  • Various security fixes.
  • Minor bug fixes.
January 27, 2022
  • Minor bug fixes.
January 6, 2022
  • Fixed security vulnerability issue CVE-2021-44228 and CVE-2021-44832. (Requires the new version of RICOH Data Collector)
  • Minor bug fixes.
December 16, 2021
  • Fixed security vulnerability issue CVE-2021-45105. (Requires the new version of RICOH Data Collector)
  • Minor bug fixes.
November 18, 2021
  • Various security updates.
  • Minor bug fixes.
November 11, 2021
  • Various security updates.
  • Minor bug fixes.
November 4, 2021
  • Various security updates.
  • Minor bug fixes.
October 14, 2021
  • Improved the preset and operator data collected from continuous form printers.

    For printers that are already registered in the system, RICOH Data Collector starts collecting operator data the next time an operator logs in to the printer.

  • Various security updates.
  • Minor bug fixes.
September 24, 2021
  • Various security updates.
  • Minor bug fixes.
September 2, 2021
  • Improved the upload diagnostic data function. For more information, see Uploading Diagnostic Data.
  • Various security updates.
  • Minor bug fixes.
August 12, 2021
  • Improved data privacy and security for the logs collected in RICOH Data Collector.
  • Various security updates.
  • Minor bug fixes.
July 22, 2021
  • Improved the printer click data collected from RICOH TotalFlow Print Server printers. Data for black-and-white, full-color, and fifth station printer clicks is now available through JMF communication.
  • Improved the job event handling for TotalFlow Print Server printers.
  • Fixed program shortcut issues that occurred when the RICOH Data Collector installation language was Spanish.
  • Various security updates.
  • Minor bug fixes.
July 1, 2021
  • Improved the upload diagnostic data function. For increased security, you can now use this function only after you sign in to RICOH Data Collector.
  • Fixed data collection issues caused by restarting the RICOH Data Collector service while RICOH Predictive Insight was under maintenance.
  • Improved overall connectivity for TotalFlow Print Server printers.
  • Various security updates.
  • Minor bug fixes.
June 10, 2021
  • Added support for tracking fifth station printer clicks from cut sheet printers.
  • Added support for tracking scanner and copier clicks from cut sheet printers.
  • Fixed issues with sudden and incorrect increases in printer click values.
  • Various security updates.
  • Minor bug fixes.
May 20, 2021
  • Added the Serial Number setting. RICOH Data Collector identifies the printer serial number based on the IP address or host name.

    If a data source with that serial number was previously registered in the system, you can either create a new instance or resume tracking the previous data source and append future data to the existing historical data.

  • Improved the data available for printer errors and the jobs that were running when the errors occurred. The correlation between jobs and printer errors is currently available only for Fiery and RICOH GW cut sheet printers.
  • Various security updates.
  • Minor bug fixes.
April 29, 2021
  • Added Microsoft Edge based on Chromium 87 or later to the list of supported browsers. Updated the supported Google Chrome version to 87 or later and the Mozilla Firefox version to 83 or later.
  • Improved the printer time zone identification.
  • Fixed issue with negative values displayed for the error duration.
  • Fixed issue with TotalFlow Print Server printers that did not automatically reconnect through JMF after they were restarted.
  • Fixed issue with serial numbers that were not correctly retrieved from the printer.
  • Fixed issue where the printer cards were not always visible after logging in to RICOH Data Collector.
  • Various security updates.
  • Minor bug fixes.
April 8, 2021
  • Added the Preset and Operator Name data fields for continuous form printers.

    For printers that are already registered in the system, RICOH Data Collector starts collecting preset data the next time there is a snapshot update and operator data the next time an operator logs in to the printer.

  • Fixed issues with printer character set values detected on the printer but not available in the default list from RICOH Data Collector. The new values are now saved in the list.
  • Various security updates.
  • Minor bug fixes.
March 18, 2021
  • Added support for adjusting the printer time zone based on daylight saving time.

    After you install the latest version of RICOH Data Collector, make sure that all the printers registered in the system have the correct time zone specified.

    When you upgrade or restore printers from an older version of RICOH Data Collector, the time zone of the data collector is automatically applied to all the printers that did not have a time zone specified. If necessary, you can edit the printer properties and select a different time zone.

  • Improved the order of the values from the Printer Character Set list. The values are now ordered based on the character set code.
  • Various security updates.
  • Minor bug fixes.
February 25, 2021
  • Added support for uploading diagnostic data that can help troubleshoot problems. For more information, see Uploading Diagnostic Data.
  • Added the Printer Character Set option for printers that use the Generic SNMP Printer, RICOH GW Cut Sheet Printer, or RICOH Fiery Cut Sheet Printer configuration. RICOH Data Collector uses the character set to process and display printer data and job data correctly.

    After you upgrade or restore printers from an older version of RICOH Data Collector, the Printer Character Set option is automatically set to Default - ISO-8859-1 - Western Alphabet for all the migrated printers, regardless of the printer settings. If necessary, you can edit the printer properties and select a different value.

  • Improved the region selection in the RICOH Data Collector installer. Troubleshooting information is now included for unreachable regions.
  • Ended support for RICOH Data Collector version 1.0. Make sure that you upgrade to the latest available version.
  • Various security updates.
  • Minor bug fixes.
February 4, 2021
  • Improved the RICOH Data Collector logging mechanism.
  • Fixed issue with the status displayed for TotalFlow Print Server cut sheet printers when the JMF communication was not working properly. The printer card now displays the Partial data transfer status when the printer is connected through SNMP but no JMF data is received.
  • Various security updates.
  • Minor bug fixes.
January 14, 2021
  • Fixed disk space issues caused by large RICOH Data Collector log files.
  • Fixed issues with the error message displayed in printer notifications. When the printer does not provide an error message, the notification now displays "Unknown error".
  • Fixed data source and login issues that occurred when RICOH Data Collector was installed on a virtual machine and the virtual machine was restarted or an older snapshot was restored.
  • Various security updates.
  • Minor bug fixes.
December 17, 2020
  • Improved the accuracy of data metrics collected when groups of jobs are submitted to a TotalFlow Print Server cut sheet printer.
  • Improved the processing and storing of printer events.
  • Fixed issue with simplex printers that were sometimes incorrectly displayed as duplex after the RICOH Data Collector service was restarted.
  • Various security updates.
  • Minor bug fixes.
December 3, 2020
  • Various security updates.
  • Minor bug fixes.
November 5, 2020
  • Updated the list of supported operating systems. Added support for Windows 8.1 and Windows Server 2019 and removed support for Windows 7 and Windows 8. For more information, see Computer Requirements.
  • Improved the accuracy of data metrics for aborted jobs on continuous form printers.
  • Improved the accuracy of data metrics for jobs that were suspended and resumed on Fiery printers.
  • Fixed tracking issues for jobs that were submitted using the process and hold option on Fiery printers.
  • Various security updates.
  • Minor bug fixes.
October 15, 2020
  • Added support for collecting data from all the printer engines. For printers with dual-simplex configuration, a separate printer card is displayed for each engine in the Real Time Display tab from RICOH Predictive Insight.

    After you upgrade to the latest version of RICOH Data Collector, in the Real Time Display tab from RICOH Predictive Insight, the printer cards for all existing dual-simplex printers are separated into two cards, one for each engine. All the initial data is displayed on the card for engine 1, while 0 is displayed on the card for engine 2 for all the data metrics. New data collected after the upgrade is tracked and displayed per engine.

  • Added support for tracking lifetime printer clicks for cut sheet printers.

    After you upgrade to the latest version of RICOH Data Collector, the lifetime printer clicks value for existing printers is initially 0 and updates to the correct value only after the next click is registered on the printer.

  • Improved the accuracy of printed impressions data for continuous form printers.
  • Fixed issues with the message displayed when a new version of RICOH Data Collector is available.
  • Various security updates.
  • Minor bug fixes.
September 24, 2020
  • Fixed printer status issues that occurred after the RICOH Data Collector service was stopped and restarted.
  • Fixed connectivity issues with TotalFlow Print Server printers when HTTPS was enabled for RICOH Data Collector.
  • Various security updates.
  • Minor bug fixes.
September 3, 2020
  • Added support for enabling HTTPS to secure the communication between the RICOH Data Collector server and the web browser user interface. For more information, see Enabling HTTPS for RICOH Data Collector .
  • Fixed display issues for job names with special characters.
  • Various security updates.
  • Minor bug fixes.
August 13, 2020
  • Added support for several printers. For more information, see Supported Printers.
  • Various security updates.
  • Minor bug fixes.
July 30, 2020
  • Improved the accuracy of printed copies data for continuous form printers.
  • Various security updates.
  • Minor bug fixes.
July 2, 2020
  • Various security updates.
  • Minor bug fixes.
June 11, 2020
  • Improved filtering precision when searching for events in logs.
  • More information is displayed on the printer cards. Now you can see the printer type on each printer card on the Printers page.
  • Various security updates.
  • Minor bug fixes.
May 21, 2020
  • You can now reset your user account password from the RICOH Data Collector sign-in page.
  • Added information about how to reach technical support in the Troubleshooting and Support section.
  • Fixed issues with data for reprinted jobs.
  • Various security updates.
  • Minor bug fixes.
April 30, 2020
  • Improved information about event time. Event logs now contain a timestamp corresponding to the printer time zone. This update applies to both cut sheet and continuous form printers.
  • Improved login experience. The user email field is no longer case-sensitive.
  • Various security updates.
  • Minor bug fixes.
April 9, 2020
  • Introduced a new version of the help system with design and functionality improvements. For easier access, the RICOH Data Collector documentation is now also available from the RICOH Predictive Insight help page.
  • Improved the accuracy of the job information collected from cut sheet printers. The data collectors can now receive accurate information from cut sheet printers about jobs, sheets, and impressions when users submit groups of jobs.
  • Improved communication between RICOH Data Collector and printers with TotalFlow Print Server controller. RICOH Data Collector now displays a warning message when the registration on the printer fails.
March 19, 2020
  • Enhanced connection between RICOH Data Collector and the data recipients by improving the communication routine of the data collectors.
  • Improved interface communication by replacing the messages received from SNMP with custom messages that match with the RICOH Productivity Tracker messages.
  • Improved the accuracy of the job information collected from cut sheet printers. The data collectors can now receive accurate information from cut sheet printers about Total Sheets, Total Pages, and Total Impressions of aborted jobs, too.
February 27, 2020
  • Improved the accuracy of the information gathered by data collectors. You can now select the time zone of the physical printer, for the data collector to be able to identify the printer correctly and collect more accurate data.
  • Added support for a new printer type in the printer definition dialog box. You can now collect job information from cut sheet printers with TotalFlow Print Server controller.
  • You can now view the printers that are already configured in RICOH Data Collector when selecting an IP range, so you can better choose which printers to add.
February 06, 2020
Improved the accuracy of printed jobs information for printers that use RICOH GW controllers. The events for the first job printed after the printer is restarted are now captured and counted on the Real Time Display and Dashboards tabs.

For common problems and possible solutions, see Common Problems.

1.1.2 RICOH Data Collector User Interface

RICOH Data Collector provides a comprehensive and intuitive web-based user interface for viewing and managing connected data sources.
Reference: For a video presentation of the RICOH Data Collector user interface, go to Ricoh How-to Videos.

You can access the user interface from a supported web browser. For information on the supported web browsers and the minimum requirements, see Computer Requirements.

Printers page

The RICOH Data Collector user interface consists of these areas:

  1. The Printers page, for viewing and managing printers as data sources for RICOH Data Collector.

  2. The Go to Analytics tab, for monitoring data sources, viewing collected data, and setting alerts for important changes.

  3. The Settings button Settings button, for viewing and editing RICOH Data Collector settings, configuring auto update options, and viewing the activity log.

  4. The Account button Account button, for viewing your user name and for signing out.

  5. The Help button Help button, for viewing information on how to configure and use RICOH Data Collector.

  6. The Search button Search button, for finding a data source configured in RICOH Data Collector.

  7. The Add Printer... and Scan for Printers buttons, for adding a printer manually or searching for printers automatically.

  8. The RICOH Data Collector footer, for viewing cloud and ground information about the data collector.

1.1.2.1 Printers Page

The Printers page displays information on the printers configured in RICOH Data Collector.
Printers page

On each printer card, you can view the printer name, IP address or host name, connectivity status, and printer type. If the printer status is Not connected or Partial data transfer, you can click the Details button to view details about connectivity.

On the Printers page, you can also add printers and edit or delete printers that are already configured in RICOH Data Collector.

To view the printers as a list, click List view button, the List view button, in the top-right corner of the page.

1.1.2.2 Go to Analytics Tab

You can click the Go to Analytics button to view the collected data, monitor the data sources, and set alerts for important changes.

When you click the Go to Analytics button, you are redirected to the RICOH Predictive Insight sign-in page.

RICOH Predictive Insight sign-in page

Enter your user account email and password to sign in to RICOH Predictive Insight.

For more information on how to monitor data sources, view collected data, and set alerts, see the RICOH Predictive Insight documentation.

1.1.2.3 Settings Tab

In the Settings tab, you can view and edit the general and the automatic update settings of the data collector and view the activity log.

Click Settings button, the Settings button, in the top-right corner of the RICOH Data Collector main page, and select General Settings, Configure updates, or Activity Log.

Settings menu
General tab

General tab

In the General tab, you can configure your data collector according to your needs:

Name
You can edit the name of the data collector.
Store Data Locally
To keep the collected data only locally, enable the Store Data Locally option. To set the storage location, you can enter a file path in the input field or you can click Browse for Folder button, the Browse for Folder button, to create or select a folder on the computer where RICOH Data Collector is installed. Enabling local data storage may require additional disk space.

Browse for Folder dialog box

    Important:
  • If you enable Store Data Locally, RICOH Data Collector does not send data to the cloud and, as a result, you cannot see the data in RICOH Predictive Insight. Use this option only if you have other means of analyzing data.
  • Even if Store Data Locally is enabled, you must have an internet connection for your subscription to be validated.
  • RICOH Data Collector does not manage your local data storage. If you enable Store Data Locally, the data collector creates a series of files with the data collected from the printers, in the specified location, each time new data is collected. Delete or move any unnecessary files created by the data collector in the data storage location.

Current version
This field displays the RICOH Data Collector version installed on your system.
Available updates
This field displays the latest RICOH Data Collector version that is currently available. If an update is available, you can click the download button to download the installation package for the new version.
Description
You can enter a description for the data collector.
Use HTTP Proxy Server
Enable the Use HTTP Proxy Server option if you want to enable proxy settings for the internet connection. Improper proxy configuration may cause connectivity issues with the cloud. If there are any connectivity issues, the system displays an offline status at the top of the main page.

Offline status

Host Address
Specify the IP address or the DNS name for the proxy server.
Port
Specify the port number for the proxy server.
Username
Enter a valid user name for the proxy server.
Password
Enter the password for the specified user name.
Bypass/Exclude Hosts
Specify the IP address or the DNS name for the proxy server exceptions. You can add or remove exceptions from the bypass list by using the plus or the minus button. Each exception must be listed on a separated line.

To save the changes, click OK. To discard the changes, click Cancel.

Automatic Update Settings tab

Automatic Update Settings

In the Automatic Update Settings tab, you can configure auto updates for your data collectors according to your needs. The RICOH Data Collector auto update runs silently in the background without requiring user interaction. For more information, see Configuring Auto Updates in Data Collector.

Activity Log tab

Activity Log tab

In the Activity Log tab, you can view information on system events and user actions. Data is stored in the activity log for 30 days.

This information is available in the Activity Log tab:

  • Severity
  • Timestamp
  • Issued by
  • Event Type
  • Component
  • Component Type
  • Message

1.1.2.4 RICOH Data Collector Footer

The RICOH Data Collector footer provides cloud and ground information on the configured data collector. The information in the footer is refreshed periodically with updates from the cloud or each time a device is added or deleted.

RICOH Data Collector footer

The following information is available in the footer:

Data Collector Name
The name of the data collector you configured. You can update the data collector name on the General Settings page.
Communication Status
The communication status between the data collector and the cloud. The status can be Connected or Not Connected.
Current version / Update
The RICOH Data Collector version installed on your system and the latest version that is currently available. If an update is available, you can click the download button to download the installation package for the new version.
Data Source Usage
The number of used data source entitlements from the total number of available data sources. Click the information button Information button to view the available data sources from your subscription. If you used all the available data sources from your subscription, you can view pricing details and purchase more data sources.
Automatic Update Status
Indicates whether the automatic update option for the RICOH Data Collector is enabled or disabled.
If auto-update is disabled, you have the option to enable it from the settings page.
If auto-update is enabled, you have the option to disable it from the settings page.

1.1.3 Notices

1.1.3.1 Important

To the maximum extent permitted by applicable laws, in no event will the manufacturer be liable for any damages whatsoever arising out of failures of this product, losses of documents or data, or the use of this product and operation manuals provided with it.

Make sure that you always copy or have backups of important documents or data. Documents or data might be erased due to your operational errors or malfunctions of the machine. Also, you are responsible for taking protective measures against computer viruses, worms, and other harmful software.

In no event will the manufacturer be responsible for any documents created by you using this product or any results from the data executed by you.

Do not remove or insert any disk while operating this application.

1.1.3.2 Cautions Regarding This Guide

  • Some illustrations or explanations in this guide may differ from your application due to improvement or change in the application.
  • The contents of this document are subject to change without notice.
  • No part of this document may be duplicated, replicated, reproduced in any form, modified or quoted without prior consent of the manufacturer.

1.1.3.3 Trademarks

RICOH Predictive Insight is a trademark of Ricoh Company, Ltd. in the United States, other countries, or both.

The EFI logo, Electronics For Imaging, Fiery, and the Fiery logo are registered trademarks of Electronics for Imaging, Inc. in the U.S. and/or certain other countries. EFI is a trademark of Electronics for Imaging, Inc. in the U.S. and/or certain other countries.

Google Chrome and Chromium are trademarks of Google LLC.

HP and LaserJet are registered trademarks of HP Development Company, L.P.

Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

JavaScript is a trademark of Oracle Corporation in the United States.

Linux is the registered trademark of Linus Torvalds in the U.S. and other countries.

Mac is a trademark of Apple Inc., registered in the U.S. and other countries and regions.

Microsoft, Windows, Windows Server, and Microsoft Edge are registered trademarks of Microsoft Corporation in the United States and/or other countries.

Mozilla and Firefox are trademarks of the Mozilla Foundation in the U.S. and other countries.

openSUSE is a registered trademark of SUSE LLC in the United States and other countries.

Red Hat, Red Hat Enterprise Linux, and Fedora are registered trademarks of Red Hat, Inc. or its subsidiaries in the United States and other countries.

Ubuntu is a registered trademark of Canonical Ltd.

The proper names of the Windows operating systems are as follows:

  • Windows 11 (24H2 or higher) Pro or Enterprise
  • Windows Server 2025 Standard, Essentials, or Datacenter with Desktop Experience
  • Windows Server 2022 Standard, Essentials, or Datacenter with Desktop Experience
  • Windows Server 2019 Standard, Essentials, or Datacenter with Desktop Experience
  • Windows Server 2016 Standard, Essentials, or Datacenter with Desktop Experience

Other product names used herein are for identification purposes only and might be trademarks of their respective companies. We disclaim any and all rights to those marks.

1.2 Getting Started with RICOH Data Collector

This section includes basic procedures for working with RICOH Data Collector.

1.2.1 Computer Requirements

To run RICOH Data Collector, your computer must meet these requirements. Before setup, make sure that all the requirements are met.

System Requirements

This table lists the requirements for the computer where you install RICOH Data Collector:

Item Requirements
Computer
  • Server Class Computer
  • CPU: Quad Core Processor 2.7 GHz or higher (64–bit CPU)
  • Main memory: 4 GB RAM or higher (8 GB RAM or higher recommended)
Important: To avoid performance issues, we recommend that you register up to 15 printers for 4 GB available RAM.

If you want to monitor a larger number of printers, increase the available RAM or install additional data collectors.
Hard disk 30 GB of available disk space for the initial installation and up to 250 GB or more, depending on usage
Note: The amount of space required varies greatly, depending on the log size and whether the Store Data Locally feature is enabled within RICOH Data Collector. The log size depends on the number of printers connected, the printer type used, and the uptime of the application. Using a solid-state drive (SSD) is recommended for better performance.
Display 1280 × 1024 pixels or higher
Note: Maximize the browser window when you use this application. If the size of the browser window is not large enough to display the user interface, you might experience problems with truncated display.
Operating systems
  • Windows 11 (24H2 or higher) Pro or Enterprise
  • Windows Server 2025 Standard, Essentials, or Datacenter with Desktop Experience
  • Windows Server 2022 Standard, Essentials, or Datacenter with Desktop Experience
  • Windows Server 2019 Standard, Essentials, or Datacenter with Desktop Experience
  • Windows Server 2016 Standard, Essentials, or Datacenter with Desktop Experience
  • Ubuntu (24.04 LTS, 22.04 LTS)
  • CentOS Stream (9 or higher)
  • openSUSE Leap (15.6 or higher)
  • Red Hat Enterprise Linux (10, 9.4 or higher, 8.10)
    Important:
  • The 64-bit operating systems satisfy the minimum operating system requirements.
  • If you install RICOH Data Collector on an operating system that is running on VMware software, the system might experience slow performance. To avoid any RICOH Data Collector performance issues, make sure that you allocate a separate disk drive for the VMware software.
  • Make sure that the computer where you install RICOH Data Collector is not set to enter sleep mode. During sleep mode, RICOH Data Collector cannot collect data and the connection with the cloud is interrupted.
Network
  • Make sure that the Domain Name Services (DNS) name is configured on the machine where RICOH Data Collector is installed and contains a suffix that is registered in your DNS server database. The DNS name must be assigned to a reachable IP. Make sure that you use a static IP address.
  • Make sure that the DNS name contains only these ASCII characters:
    • English lowercase characters a-z
    • English uppercase characters A-Z
    • Numbers 0‒9
    • Hyphen-minus character -
TCP/IP ports To allow RICOH Data Collector to access the cloud and initiate outgoing connections, open these ports:
  • RICOH Data Collector user interface:
    • HTTP: 80

      Configure this port to connect to RICOH Data Collector user interface on your local network, if RICOH Data Collector is configured to use HTTP.

    • HTTPS: 443

      Configure this port to allow RICOH Data Collector to access the cloud (mandatory).

      Configure this port to connect to RICOH Data Collector user interface on your local network, if RICOH Data Collector is configured to use HTTPS.

To allow the RICOH Data Collector web server to communicate with the data sources, open these ports:
  • RICOH Data Collector: 19280.

    Configure this port to allow incoming connections from the intranet.

  • Domain Name System (DNS): 53.

    Configure this port to allow RICOH Data Collector to communicate with the data sources using their hostname, instead of the IP address.

    Configure this port to connect to RICOH Data Collector user interface using the hostname of the machine where RICOH Data Collector is installed.

  • Printer Web pages: 80.

    Configure this port to allow outgoing requests via TCP.

  • SNMP: 161/162.

    Configure this port to allow RICOH Data Collector to initiate outgoing requests via TCP/UDP to contact cut sheet printers.

  • JMF: 8010.

    Configure this port to allow RICOH Data Collector to initiate outgoing requests via TCP to contact cut sheet printers.

  • RICOH Productivity Tracker: 10000.

    Configure this port to allow RICOH Data Collector to initiate outgoing requests via TCP to contact continuous form printers.

    Important:
  • An IPv4 configuration is required.
  • If your firewall is configured to block the default ports or the ports that you set up during the installation, you must open them. For more information, see the documentation for the Windows firewall. If you are using a different firewall, read the documentation for the firewall on your computer to make sure that the RICOH Data Collector ports are open.
Web browser
  • Google Chrome 135 or later
  • Mozilla Firefox 135 or later
  • Microsoft Edge 135 or later
    Important:
  • You must enable JavaScript for the web browser.
Allowed URLs To install RICOH Data Collector in the United States, make sure that you allow access to these URLs:
  • https://ricohsoftware.com/datacollector/account-info.json
  • https://datacollector.app-ricohsoftware.com/account-details.json
To run RICOH Data Collector, make sure that you allow access to the following domains:
  • For the United States:
    • ricohsoftware.com
    • help.ricohsoftware.com
    • rpi.app-ricohsoftware.com
    • services.app-ricohsoftware.com
    • datacollector.app-ricohsoftware.com
    • fileupload.app-ricohsoftware.com
    • cognito-idp.us-west-2.amazonaws.com
  • For Europe:
    • ricohsoftware.eu
    • help.ricohsoftware.com
    • rpi.app-ricohsoftware.eu
    • services.app-ricohsoftware.eu
    • datacollector.app-ricohsoftware.eu
    • fileupload.app-ricohsoftware.eu
    • cognito-idp.eu-west-1.amazonaws.com
Supported languages Dutch, English, French, German, Italian, Japanese, Spanish

Client Computer Requirements

This table lists the requirements for any computer that accesses RICOH Data Collector:

Item Requirements
Display 1280 × 1024 pixels or higher
Operating system Any Windows, Linux, or Mac system that supports one of the required web browsers.
Network access Access to the target server by referring to the IP address or DNS host name.
Web browser
  • Google Chrome 135 or later
  • Mozilla Firefox 135 or later
  • Microsoft Edge 135 or later
Important: You must enable JavaScript for the web browser.
Supported languages Dutch, English, French, German, Italian, Japanese, Spanish

1.2.2 Downloading and Installing RICOH Data Collector on Windows

To start monitoring and gathering data from your printers, you must first install the RICOH Data Collector application. If a data collector is not available, the Install Data Collector to Get Printer Data page is displayed.
To download and install RICOH Data Collector on Windows:
  1. On the Install Data Collector to Get Printer Data page, prepare to install RICOH Data Collector to connect to your printer and click Next.
    Install RICOH Data Collector
  2. Check the computer requirements and click Next.
    Install RICOH Data Collector
  3. Check the ports that you need to open and click Next.
    Install RICOH Data Collector
  4. Check the URLs that need to be whitelisted from your firewall in order to be accessible for the data collector. Click Next.
    Install RICOH Data Collector
  5. On the Download & Install Data Collector page, click Download Data Collector for Windows or click here for Linux.
    Download RICOH Data Collector
  6. Save the installation file to your computer.
    The procedure for saving the file depends on the web browser.
  7. Launch the installer as an administrator.
  8. When the installer is displayed, select a language and click OK.
  9. In the Welcome dialog box, click Next.
  10. In the License Agreement dialog box:
    1. Read the license agreement.
    2. Click I accept the terms of the License Agreement.
    3. Click Next.
  11. In the Install Folder dialog box:
    1. If you want to change the default installation folder, click Choose.... Go to the folder where you want to install RICOH Data Collector and click OK.
    2. Click Next.
      Note:
    • If you want to restore the default installation folder, click Restore Default Folder.
    • Make sure that the installation path for RICOH Data Collector contains only characters from the same code page as the operating system.
    • Make sure that the specified installation location contains the recommended disk space for installing and running RICOH Data Collector.
  12. In the Shortcut Folder dialog box:
    1. Specify where you want to create the product icons.
    2. Click Next.
  13. In the Proxy Settings dialog box:
    1. Review and update the information, if necessary. The installer attempts to detect automatically your system proxy configuration.
    2. Click Next.
  14. In the Cloud Connection dialog box:
    1. Review the list of required domains.
      Check the connection status for each domain:
      • A check mark indicates the domain is reachable.
      • A red X indicates the domain is not reachable.
    2. The system displays a warning message when one or more domains are unreachable.
      Note: The installation will still continue, but it is recommended that all domains are accessible to ensure full functionality.
    3. Click Next.
  15. In the Automatic Updates dialog box:
    1. Enable or disable automatic RICOH Data Collector updates.
    2. Select a start time from the drop down list to define when updates begin.
    3. Select the time zone that applies to the scheduled update time.
    4. Choose the day or days when automatic updates should run.
      Note: You must select at least one day of the week. Otherwise, an error will occur and updates will not be scheduled.
    5. Click Next.
  16. In the Configure ports dialog box:
    1. Enter the port numbers for the RICOH Data Collector web server and the database server. You can change the default port number if you are already using the port.
    2. Click Next.
  17. In the Summary dialog box:
    1. Review the information you provided.
    2. To go back and edit the information you provided, click Previous.
    3. To proceed, click Install.
  18. After the installation is complete, select the Open RICOH Data Collector check box to open the application.
  19. Click Done to close the installer.
      Important:
    • After you install RICOH Data Collector, you must sign in and register the data collector. For more information, see Signing In.
When you upgrade RICOH Data Collector, you are prompted to restart the computer. Click Restart.

If RICOH Data Collector does not launch after the computer restart, launch the Change Installation executable file, run Repair, then restart the computer again.

You can also repair RICOH Data Collector with the command line option.

Run the command in the installation path on the computer where RICOH Data Collector is installed: 

"Change Installation.exe" -i silent -repair

1.2.3 Downloading and Installing RICOH Data Collector on Linux

To start monitoring and gathering data from your printers, you must first install the RICOH Data Collector application. If a data collector is not available, the Install Data Collector to Get Printer Data page is displayed.
To download and install RICOH Data Collector on Linux:
  1. On the Install Data Collector to Get Printer Data page, prepare to install RICOH Data Collector to connect to your printer and click Next.
    Install RICOH Data Collector
  2. Check the computer requirements and click Next.
    Install RICOH Data Collector
  3. Check the ports that you need to open and click Next.
    Install RICOH Data Collector
  4. Check the URLs that need to be whitelisted from your firewall in order to be accessible for the data collector. Click Next.
    Install RICOH Data Collector
  5. On the Download & Install Data Collector page, click Download Data Collector for Linux or click here for Windows.
    Download RICOH Data Collector
  6. Save the installation file to your computer.
    The procedure for saving the file depends on the web browser.
  7. Run the command:
    chmod 777 RICOH.Data.Collector-*.bin
  8. Launch the installer as root using the command:
    sudo ./RICOH.Data.Collector-*.bin
  9. When the installer is displayed, select a language and click OK.
  10. In the Welcome dialog box, click Next.
  11. In the License Agreement dialog box:
    1. Read the license agreement.
    2. Click I accept the terms of the License Agreement.
    3. Click Next.
  12. In the Link Folder dialog box:
    1. Specify where you want to create the product links.
    2. Click Next.
  13. In the Proxy Settings dialog box:
    1. Review and update the information, if necessary. The installer attempts to detect automatically your system proxy configuration.
    2. Click Next.
  14. In the Cloud Connection dialog box:
    1. Review the list of required domains.
      Check the connection status for each domain:
      • A check mark indicates the domain is reachable.
      • A red X indicates the domain is not reachable.
    2. The system displays a warning message when one or more domains are unreachable.
      Note: The installation will still continue, but it is recommended that all domains are accessible to ensure full functionality.
    3. Click Next.
  15. In the Configure ports dialog box:
    1. Enter the port numbers for the RICOH Data Collector web server and the database server. You can change the default port number if you are already using the port.
    2. Click Next.
  16. In the Summary dialog box:
    1. Review the information you provided.
    2. To go back and edit the information you provided, click Previous.
    3. To proceed, click Install.
  17. After the installation is complete, select the Open RICOH Data Collector check box to open the application.
  18. Click Done to close the installer.
      Important:
    • After you install RICOH Data Collector, you must sign in and register the data collector. For more information, see Signing In.
      Note:
    • The default installation location, /opt/RICOH/DataCollector, cannot be changed.
    • The RicohDataCollector Service commands are:
      sudo systemctl start RicohDataCollector
      sudo systemctl stop RicohDataCollector
      sudo systemctl restart RicohDataCollector
      sudo systemctl status RicohDataCollector

    • If the RicohDataCollector Service commands are not recognized after installation, restart the Linux server.

When you upgrade RICOH Data Collector, you are prompted to restart the computer. Click Restart.

If RICOH Data Collector does not launch after the computer restart, launch the Change Installation executable file, run Repair, then restart the computer again.

You can also repair RICOH Data Collector with the command line option.

Run the command:

./'Change Installation' -i silent -repair

1.2.4 Downloading and Installing RICOH Data Collector with Command Line

To start monitoring and gathering data from your printers, you must first install the RICOH Data Collector application. If a data collector is not available, the Install Data Collector to Get Printer Data page is displayed.
You can download and install RICOH Data Collector using the command line installation:
  1. On the Install Data Collector to Get Printer Data page, prepare to install RICOH Data Collector to connect to your printer and click Next.
    Install RICOH Data Collector
  2. Check the computer requirements and click Next.
    Install RICOH Data Collector
  3. Check the ports that you need to open and click Next.
    Install RICOH Data Collector
  4. Check the URLs that need to be whitelisted from your firewall in order to be accessible for the data collector. Click Next.
    Install RICOH Data Collector
  5. On the Download & Install Data Collector page, click Download Data Collector for Windows or click here for Linux.
    Download RICOH Data Collector
  6. Save the installation file to your computer.
    The procedure for saving the file depends on the web browser.
  7. Open a command prompt.
  8. Launch the installer as an administrator on a Windows system or as root on a Linux system. The installer contains the file name, including the installer version, followed by the extensions .exe or .bin. Depending on the operating system, use one of the command line options:

    RICOH.Data.Collector-*.exe -i silent -DC_PROXY_ADDR=<proxyAddress> -DC_PROXY_PORT=<proxyPort> -DC_PROXY_USER=<proxyUser> -DC_PROXY_PWD=<proxyPassword>] [-DC_SERVER_PORT=<serverPort>] [-DC_DB_PORT=<dbPort>] [-DC_RESTART_SYSTEM={true|false}] [-DUSER_SHORTCUTS=<userShortcuts>] [-DC_AUTO_UPDATE_ENABLED={0|1}] [-DC_AUTO_UPDATE_TIME=<time>] [-DC_AUTO_UPDATE_DAYS=<day>] [-DC_AUTO_UPDATE_TZ=<timezone>] or

    RICOH.Data.Collector-*.bin -i silent -DC_PROXY_ADDR=<proxyAddress> -DC_PROXY_PORT=<proxyPort> -DC_PROXY_USER=<proxyUser> -DC_PROXY_PWD=<proxyPassword>] [-DC_SERVER_PORT=<serverPort>] [-DC_DB_PORT=<dbPort>] [-DC_RESTART_SYSTEM={true|false}] [-DUSER_SHORTCUTS=<userShortcuts>]

    Command Line Options
    Command Line Options Mandatory Optional Details Values Default Values
    -DC_PROXY_ADDR No Yes Proxy server N/A System proxy settings
    -DC_PROXY_PORT No Yes Proxy port N/A System proxy settings
    -DC_PROXY_USER No Yes Proxy username N/A N/A
    -DC_PROXY_PWD No Yes Proxy password N/A N/A
    -DC_SERVER_PORT No Yes Web server port N/A 19280
    -DC_DB_PORT No Yes Database server port N/A 19293
    -DUSER_SHORTCUTS No Yes Shortcuts location N/A

    Desktop (Windows)

    Home directory (Linux)
    -DC_RESTART_SYSTEM No Yes Restart system after installation true/false false
    -DC_AUTO_UPDATE_ENABLED No Yes Enable or disable automatic update 1/0 0
    -DC_AUTO_UPDATE_TIME No Yes Automatic update start time N/A N/A
    -DC_AUTO_UPDATE_DAYS No Yes Day(s) for automatic updates N/A N/A
    -DC_AUTO_UPDATE_TZ No Yes Scheduled automatic update time zone N/A N/A
      Note:
    • The commands do not prompt for input when run from the command line.
    • After the command line installation, it takes approximately 2 minutes for RICOH Data Collector to become functional.
    • If you use the sudo command when launching the installer on a Linux system, the proxy settings (if not specified) default to the system proxy settings only if the -E option is specified:

      sudo INSTALLER -E -i silent -DC_PROXY_ADDR=<proxyAddress> -DC_PROXY_PORT=<proxyPort> -DC_PROXY_USER=<proxyUser> -DC_PROXY_PWD=<proxyPassword>] [-DC_SERVER_PORT=<serverPort>] [-DC_DB_PORT=<dbPort>] [-DC_RESTART_SYSTEM={true|false}] [-DUSER_SHORTCUTS=<userShortcuts>]

1.2.5 Updating RICOH Data Collector

Whenever a new version of RICOH Data Collector is available, a message is displayed on the footer and on the top banner of the interface. The message shows the version number and lets you know that you can download or auto-update the new version.
To download and install a new version of RICOH Data Collector when you already have RICOH Data Collector installed:
  1. On the RICOH Data Collector main page, click either DOWNLOAD UPDATE or Auto-update now on the top banner, or Download button, the Download button, on the RICOH Data Collector footer.
    RICOH Data Collector footer
    Note: Make sure that your system meets all the listed requirements.
  2. Save the installation file to your computer.
    The procedure for saving the file depends on the web browser.
  3. Launch the installer as an administrator on a Windows system or as root on a Linux system. The installer contains the file name, including the installer version, followed by the extensions .exe or .bin.
  4. When the installer is displayed, select a language and click OK.
  5. Follow the installer prompts to install the new version.
    You receive this message that lets know that you already have RICOH Data Collector installed on your computer.Warning message
  6. Click Continue.
  7. In the Automatic Updates dialog box:
    Note: Automatic updates are available only for users running RICOH Data Collector installed on Windows.
    1. Enable or disable automatic RICOH Data Collector updates.
    2. Select a start time from the drop down list to define when updates begin.
    3. Select the time zone that applies to the scheduled update time.
    4. Choose the day or days when automatic updates should run.
      Note: You must select at least one day of the week. Otherwise, an error will occur and updates will not be scheduled.
    5. Click Next.
  8. After the installation is complete, select the Open RICOH Data Collector check box to open the application.
  9. Click Done to close the installer.
When you update RICOH Data Collector, you are prompted to restart the computer. Click Restart.

If RICOH Data Collector does not launch after the computer restart, run Repair, then restart the computer again. For information on how to run Repair, see the documentation of your operating system.

You can also download the most recent version of RICOH Data Collector from the General Settings page. Click Download button, the Download button, under Available updates.General Settings page

To instantly start the automatic update of the most recent version of RICOH Data Collector, you can click the Auto-Update Now button on the top banner. This option allows the system to download and install the latest version without requiring manual steps.

1.2.6 Updating RICOH Data Collector with Command Line

Whenever a new version of RICOH Data Collector is available, a message is displayed on the footer and on the top banner of the interface. The message shows the version number and lets you know that you can download the new version.
To download and install a new version of RICOH Data Collector when you already have RICOH Data Collector installed:
  1. On the RICOH Data Collector main page, click either DOWNLOAD UPDATE on the top banner, or Download button, the Download button, on the RICOH Data Collector footer.
    RICOH Data Collector footer
    Note: Make sure that your system meets all the listed requirements.
  2. Save the installation file to your computer.
    The procedure for saving the file depends on the web browser.
  3. Launch the installer using one of the command line options, depending on the operating system:
    RICOH.Data.Collector-installerVersion.exe -i silent
    RICOH.Data.Collector-installerVersion.bin -i silent
    Note: The commands do not prompt for input when run from the command line.

1.2.7 Moving RICOH Data Collector to a New Server

You can move RICOH Data Collector to a new server.
To move RICOH Data Collector to a new server:
  1. Sign out from the RICOH Data Collector server and save the RICOH Data Collector name.
  2. Uninstall RICOH Data Collector. In the Uninstall RICOH Data Collector dialog box, make sure the Delete the Data Collector from the cloud check box is not selected. Click Uninstall and Done.
  3. Wait for 5-10 minutes before you continue.
  4. Install RICOH Data Collector on the new server.
  5. Under Restore from previous Data Collector, click RESTORE. Select the data collector that you want to restore from the list. Make sure that you select the correct data collector for the restore procedure.
      Note:
    • When you uninstall a data collector and then restore it on a different computer, make sure you follow the procedure above to be able to restore it again on the first computer.

1.2.8 Uninstalling RICOH Data Collector

To uninstall RICOH Data Collector:
  1. Start the uninstall process on the computer where RICOH Data Collector is installed:
    • On Windows, go to C:\Program Files\RICOH\DataCollector\_manage_installation and double-click Change Installation.exe.

      If you changed the default path, go to the install folder that you selected during the installation.

    • On Linux, open a terminal window as the root user and enter this command: 
      '/opt/RICOH/DataCollector/_manage_installation/Change Installation'
    If you chose to create shortcuts during the installation, you can also use the RICOH Data Collector - Change Installation shortcut to start the uninstall process.
  2. In the Maintenance Mode dialog box:
    1. Select Uninstall Product.
    2. Click Next.
  3. In the Uninstall RICOH Data Collector dialog box, select the Delete the Data Collector from the cloud check box if you want to delete your data collector from the cloud.
    Important: If you select the Delete the Data Collector from the cloud check box, the RICOH Data Collector application and all real-time data are permanently deleted. Historical data gathered by the data collector is still kept in the cloud. If you perform this action, you cannot restore your data collector at a later date.
  4. Click Uninstall.
  5. Click Done.

1.2.9 Uninstalling RICOH Data Collector with Command Line

To uninstall RICOH Data Collector using the command line option:
  1. Start the uninstall process on the computer where RICOH Data Collector is installed:
    • On Windows, go to C:\Program Files\RICOH\DataCollector\_manage_installation, open a command prompt and run the command:

      "Change Installation.exe" -i silent -uninstall [-DC_DELETE_FROM_CLOUD=<deleteFromCloud>] [-DC_RESTART_SYSTEM={true|false}]

    • On Linux, go to /opt/RICOH/DataCollector/_manage_installation, open a command prompt and run the command:

      ./'Change Installation' -i silent -uninstall [-DC_DELETE_FROM_CLOUD=<deleteFromCloud>] [-DC_RESTART_SYSTEM={true|false}]

    Command Line Options
    Command Line Options Mandatory Optional Details Values Default Values
    -DC_DELETE_FROM_CLOUD No Yes Delete RICOH Data Collector from cloud. true/false false
    -DC_RESTART_SYSTEM No Yes Restart system after the uninstall is finished. true/false installation setting
    Note: The commands do not prompt for input when run from the command line.

1.2.10 Restoring RICOH Data Collector

You can restore a previous configuration stored in the cloud and continue tracking your data sources. A data collector can be retrieved from the cloud only if you do not select the Delete the Data Collector from the cloud check box when you uninstall the application. You can connect to an existing data collector only after a fresh install.
To restore a previously configured data collector:
  1. Follow the installation steps from Downloading and Installing RICOH Data Collector on Windows.

    Restoring a data collector

  2. Under Restore from previous Data Collector, click RESTORE.
  3. Select the data collector that you want to restore from the list.
    The list contains uninstalled data collectors and data collectors that are currently offline, including active data collectors that are temporarily offline. Make sure that you select the correct data collector for the restore procedure. If you restore an offline data collector that is already installed on another machine, you will no longer be able to use that data collector on the initial machine.
  4. Click GET STARTED.

When you uninstall a data collector and then restore it on a different computer, you cannot restore it again on the first computer.

Important: To restore a data collector previously configured on a virtual machine, do not use the data collector from the VMware snapshot. Instead, run a new installation of RICOH Data Collector and recover the data collector from the cloud.

1.2.11 Signing In

After the installation procedure is completed, you must sign in to RICOH Data Collector from your machine or from client workstations using a web browser, and register the data collector.
Sign in page

Before you try to sign in, make sure that one of the supported web browsers is installed and configured.

To sign in from the computer where RICOH Data Collector is installed:

  1. Go to the folder where RICOH Data Collector is installed and double-click RICOH Data Collector in the bin subfolder. The default web browser opens and you see the Sign in page.

    If you chose to create shortcuts during the installation, you can also use the RICOH Data Collector shortcut to open the application.

  2. Enter the user name and the password you used to sign up for RICOH Data Collector.
  3. Click SIGN IN.

To sign in to RICOH Data Collector from a supported web browser:

  1. Open a web browser window.
  2. Enter this URL in the address bar:

    http://server_address:port_number/DataCollector

    where server_address is the host name or the IP address of the computer where RICOH Data Collector is installed and port_number is the web server port.

  3. On the Sign in page, enter the user name and the password you used to sign up for RICOH Data Collector.
  4. Click SIGN IN.
    Note: If your password expired or you forgot it, click Forgot password. An email containing a verification code is sent to the email address attached to your account. Follow the instructions in the email to reset your password.

After 15 minutes of inactivity, your session expires. You must log in to continue using the application. Even if you are logged out after 15 minutes of inactivity, RICOH Data Collector continues to run in the background.

    Important:
  • When you sign in to RICOH Data Collector for the first time, you must use the customer account email and password you obtained when you signed up, to ensure that the data collector is assigned to the proper account.
  • After you install RICOH Data Collector on your computer and you perform the first sign-in procedure, as an authorized administrator, you must register the data collector in the cloud. You can choose between creating a new data collector or restoring an existing data collector that is offline and currently not in use.
    • Name your data collector.
    • Click GET STARTED to register it.

To sign out from RICOH Data Collector, click Account button, the Account button, and select Sign out.

About your subscription
  • If you are using a trial version of RICOH Data Collector, a banner on top of the page displays the remaining days of your trial. To close the banner, click Close button, the Close button.
  • If you have subscribed to RICOH Data Collector, a banner on top of the page displays the expiration date of your subscription. The banner is visible 30 days before the expiration date. To close the banner, click Close button, the Close button.
  • If your subscription expired, the system displays a warning page and you cannot perform other actions within the application. Contact your Ricoh specialist to renew your subscription. The system keeps your data and history for 30 days after the subscription expiration.

1.3 Configuration

This section provides useful information for configuring the system.

1.3.1 Configuring the Data Collector

After you install RICOH Data Collector, you can configure your data collector according to your needs.
To configure your data collector:
  1. Under Create a new Data Collector, click CREATE NEW.
  2. On the main page, click Settings button, the Settings button, in the top-right corner.
  3. Select General Settings.
    The General Settings page is displayed.General Settings page
  4. Configure the settings from the General tab.
    These settings are available:
    Name
    You can edit the name of the data collector.
    Store Data Locally
    To keep the collected data only locally, enable the Store Data Locally option. To set the storage location, you can enter a file path in the input field or you can click Browse for Folder button, the Browse for Folder button, to create or select a folder on the computer where RICOH Data Collector is installed. Enabling local data storage may require additional disk space.

    Browse for Folder dialog box

      Important:
    • If you enable Store Data Locally, RICOH Data Collector does not send data to the cloud and, as a result, you cannot see the data in RICOH Predictive Insight. Use this option only if you have other means of analyzing data.
    • Even if Store Data Locally is enabled, you must have an internet connection for your subscription to be validated.
    • RICOH Data Collector does not manage your local data storage. If you enable Store Data Locally, the data collector creates a series of files with the data collected from the printers, in the specified location, each time new data is collected. Delete or move any unnecessary files created by the data collector in the data storage location.

    Current version
    This field displays the RICOH Data Collector version installed on your system.
    Available updates
    This field displays the latest RICOH Data Collector version that is currently available. If an update is available, you can click the download button to download the installation package for the new version.
    Description
    You can enter a description for the data collector.
    Use HTTP Proxy Server
    Enable the Use HTTP Proxy Server option if you want to enable proxy settings for the internet connection. Improper proxy configuration may cause connectivity issues with the cloud. If there are any connectivity issues, the system displays an offline status at the top of the main page.
    Host Address
    Specify the IP address or the DNS name for the proxy server.
    Port
    Specify the port number for the proxy server.
    Username
    Enter a valid user name for the proxy server.
    Password
    Enter the password for the specified user name.
    Bypass/Exclude Hosts
    Specify the IP address or the DNS name for the proxy server exceptions. You can add or remove exceptions from the bypass list by using the plus or the minus button. Each exception must be listed on a separated line.
    Important: You have access to data collector settings without authentication from the RICOH Data Collector host server. You must secure the host server and allow access only to authorized personnel.
  5. To save the changes, click OK.

1.3.2 Configuring Auto Updates in Data Collector

You can configure auto updates for your data collectors according to your needs. The RICOH Data Collector auto update runs silently in the background without requiring user interaction. This feature is available only for users running RICOH Data Collector installed on Windows.
To configure auto updates for your data collector:
  1. On the main page, click Settings button, the Settings button, in the top-right corner.
      Note:
    • Settings are only available when you are logged in to RICOH Data Collector.
  2. Select Configure Updates.
    The Settings page is displayed.
  3. Configure the settings from the Automatic Update Settings tab.Automatic Update Settings
    These settings are available:
    Enable or disable automatic RICOH Data Collector updates
    Toggle this option to enable or disable automatic RICOH Data Collector updates.
      Note:
    • This option is available for BETA customers only.
    • This option is available only if you have an administrator role.
    • By default, this option is disabled.
    • After enabling the RICOH Data Collector auto-update option, you can disable it at any time from the RICOH Data Collector interface.Automatic Update Settings
    Start time
    Select a start time from the drop down list to define when updates begin.
    Time zone
    Select the time zone that applies to the scheduled update time.
    Day of week
    Choose the day or days when automatic updates should run.
      Note:
    • You must select at least one day of the week. Otherwise, an error will occur and updates will not be scheduled.
  4. To save the changes, click OK.

To instantly start the automatic update of the most recent version of RICOH Data Collector, you can click the Auto-Update Now button on the top banner. This option allows the system to download and install the latest version without requiring manual steps.

1.4 Working with Printers

This section provides useful information for configuring printers as data sources for RICOH Data Collector.
Note: For best results, we recommend that you add one printer as data source for a maximum number of two data collectors.

1.4.1 Scanning for Printers

To add printers in RICOH Data Collector, you can scan the network for devices. The network scan is performed through SNMP v1/v2.
To start the automatic printer search:
  1. In the top-right corner of the Printers page, expand the Add Printer... menu and select Scan for Printers.
    The Add Printer... menu is disabled when the data collector is offline or when the data source usage limit has been reached.
  2. In the Scan for Printers dialog box, specify the IP range and the SNMP community name, and then click FIND PRINTERS.
    Scan for Printers dialog box
  3. Select the printers that you want to add and click ADD PRINTERS.
  4. Select a time zone for each printer in the list and click SAVE.
      Note:

    • RICOH Data Collector uses the printer time zone to correctly identify the printer and collect accurate data. Make sure that the value set for the Time Zone option matches the time zone settings configured on the printer.

      For time zones that observe daylight saving time, the Adjust for daylight saving time automatically check box is selected by default. You can clear the check box if you do not want to apply the daylight saving time adjustment. For time zones that do not observe daylight saving time, the Adjust for daylight saving time automatically option is disabled.

    • By default, this option displays the time zone received from the printer.
    • You can change the time zone of the first printer from the list and then click Apply Below to set the same time zone for the rest of the printers.
    The system displays the added printers as individual cards on the Printers page.
  5. To edit printer properties, right-click a printer card and select Properties.
    Important:
  • RICOH Data Collector can use the Scan for Printers function only if you enable the SNMP v1/v2 protocol on the physical printer. For more information, see the printer documentation.
  • When your data source limit is reached, based on your subscription, you cannot add another printer to the data collector. For information on managing account and user settings, see the RICOH Account Administration documentation.
  • You can add printers from different networks to the same data collector as long as the data collector can reach both networks. Otherwise, you need a separate data collector for each network.
  • To avoid duplicate historical data, make sure that you do not add the same printer to multiple data collectors.
  • When the data collector is not connected to the cloud, you cannot add, edit, or delete a data source. When the connection with the cloud is restored, all functions are enabled.

1.4.2 Adding Printers Manually

You can easily register new printers using the Add Printer... function.
To add a printer manually:
  1. On the Printers page, click the Add Printer... button.
    The Add Printer... button is disabled when the data collector is offline or when the data source usage limit has been reached.
  2. Edit the printer properties in the New Printer dialog box.
    New Printer dialog box
    For more information on the available settings, see Editing Printer Properties.
    Based on the specified IP address or host name, RICOH Data Collector identifies the printer serial number. If a data source with that serial number was previously registered in the system, you can either create a new instance or resume tracking the previous data source and append future data to the existing historical data. If you enter a different name for the data source, the new name also applies to the existing historical data.

    By default, the Resume tracking the previous data source option is enabled and a list with the names of the previous data sources identified in the system is displayed. Only inactive data sources that are no longer registered in any data collector appear in the list. You can disable the Resume tracking the previous data source option if you want to create a new data source instead.Serial Number setting

  3. Click OK.
    Important:
  • When your data source limit is reached, based on your subscription, you cannot add another printer to the data collector. For information on managing account and user settings, see the RICOH Account Administration documentation.
  • You can add printers from different networks to the same data collector as long as the data collector can reach both networks. Otherwise, you need a separate data collector for each network.
  • To avoid duplicate historical data, make sure that you do not add the same printer to multiple data collectors.
  • When the data collector is not connected to the cloud, you cannot add, edit, or delete a data source. When the connection with the cloud is restored, all functions are enabled.

1.4.3 Editing Printer Properties

You can edit the properties of newly added printers or of printers that are already configured in RICOH Data Collector.
To edit printer properties:
  1. Right-click a printer card and select Properties from the menu.
    Printer options menu

    If you add a printer using the Add Printer... button, you see the New Printer dialog box. New Printer dialog box

  2. Configure the printer settings.
    IP Address or Host Name
    Specify a valid printer IP address or host name. The printer IP address or host name is required and must be unique.
    Note: Use a static IP address or, if you use DHCP, make sure that the DNS provides the same IP address constantly for the MAC physical address of the printer network card. Manufacturer, Model, Printer Type, Serial Number, Time Zone, Printer Character Set, and JMF URL are updated whenever you change IP Address or Host Name and move focus from the field or press the Enter key.
    Name
    Specify the printer name. The printer name is required and must be unique.
    Description
    Add a description for the printer.
    Manufacturer
    Specifies the name of the printer manufacturer. The system updates the value whenever the IP Address or Host Name changes. You can change the value of this property.
    Model
    Specifies the printer model. The system updates the printer model whenever the IP Address or Host Name changes. You cannot change the value of this property.
    Printer Type
    Defines the communication channels that are used to collect printer data. RICOH Data Collector uses several communication channels and protocols to retrieve data from the printers you added in the application. Each printer type communicates with the printer through one or more different channels. The Printer Type value is updated whenever you change IP Address or Host Name. You can change the printer type, but we recommend that you do that only if you know that the type of data you need can be collected through a different communication channel.
      Important:
    • RICOH Data Collector determines the Printer Type by sending a query via SNMP to the specified IP address. Make sure that the SNMP settings are correct.
    • For the printer to communicate its details, make sure that the printer is turned on when you add it to RICOH Data Collector.

    The following printer types are available:

    RICOH Pro VC
    Used with RICOH continuous form printers from the Pro VC series: RICOH Pro VC40000, RICOH Pro VC60000, RICOH Pro VC70000, and RICOH Pro VC80000.
    InfoPrint 5000
    Used with RICOH continuous form printers from the InfoPrint 5000 series.
    InfoPrint 4100
    Used with RICOH continuous form printers from the InfoPrint series: InfoPrint 4000 and InfoPrint 4100.
    RICOH GW Cut Sheet Printer
    Used with printers that are operated through RICOH GW controllers.
    RICOH Fiery Cut Sheet Printer
    Used with printers that are operated through Fiery controllers.
    RICOH TotalFlow Print Server Cut Sheet Printer
    Used with cut sheet printers that are operated through TotalFlow Print Server controllers.
    Generic SNMP Printer
    Used with all printers that use SNMP and do not belong to any of the other supported printer types.
    Note: Generic SNMP Printer collects only printer information. If you need job information, select one of the other printer types and make sure that the communication channel is enabled at the printer.

    Depending on the selected Printer Type, a communication channel becomes available. Enter all the required information.

    For more information on the supported printers, see Supported Printers. For more information on the data collected for each printer type, see Collected Data.

    Serial Number
    Specifies the serial number of the physical printer.

    RICOH Data Collector identifies the printer serial number based on the IP Address or Host Name setting. If a data source with that serial number was previously registered in the system, you can either create a new instance or resume tracking the previous data source and append future data to the existing historical data. If you enter a different name for the data source, the new name also applies to the existing historical data.

    New Printer dialog box

    By default, the Resume tracking the previous data source option is enabled and a list with the names of the previous data sources identified in the system is displayed. Only inactive data sources that are no longer registered in any data collector appear in the list. You can disable the Resume tracking the previous data source option if you want to create a new data source instead.Serial Number setting

    Time Zone
    Specifies the time zone of the physical printer.

    RICOH Data Collector uses the printer time zone to correctly identify the printer and collect accurate data. Make sure that the value set for the Time Zone option matches the time zone settings configured on the printer.

    For time zones that observe daylight saving time, the Adjust for daylight saving time automatically check box is selected by default. You can clear the check box if you do not want to apply the daylight saving time adjustment. For time zones that do not observe daylight saving time, the Adjust for daylight saving time automatically option is disabled.

      Note:
    • After you specify the IP Address or Host Name setting, this option displays the time zone received from the printer.
    • If you change the time zone settings on the printer, you must manually update the Time Zone option.
    • The specified time zone applies to all future data collected from the printer.
    Printer Character Set
    Specifies the character set used to process and display printer data.

    RICOH Data Collector uses the character set to display printer data, such as job names, correctly. Make sure that the value set for the Printer Character Set option matches the language settings configured on the printer. For more information, see the printer documentation.

      Note:
    • After you specify the IP Address or Host Name setting, this option displays the character set received from the printer. If the printer does not provide character set information, RICOH Data Collector sets the value to Default - ISO-8859-1 - Western Alphabet.
    • If you change the printer language settings, you must manually update the Printer Character Set option.
    • The specified character set applies to all future data collected from the printer.
  3. Configure the RICOH Pro Scanner Option that provides data about print head cleaning, quality control, and collected logs.
    Note: The RICOH Pro Scanner Option is only available for RICOH Pro VC 60000, 70000 and 80000 printers.
    Status
    Specify the status of log collection service from the RICOH Pro Scanner server. You can enable or disable RICOH Pro Scanner server to collect and upload logs to cloud.
    RICOH Pro Scanner Server IP Address or Host Name
    Specify a valid RICOH Pro Scanner Server IP address or host name. The printer IP address or host name is required.
      Note:
    • Each time you modify the IP address or host name of the server and click the TEST button, RICOH Data Collector performs a test connection and tries to detect the server. If the IP address or host name of the RICOH Pro Scanner Server is correct, the server will appear ‘Connected’. The message ‘Cannot reach RICOH Pro Scanner Server’ indicates an incorrect IP address or a connection problem.
    • If the controller version is equal or greater than 6, the RICOH Pro Scanner Server IP Address or Host Name box is not displayed. In this case RICOH Data Collector uses the IP or hostname of the printer to communicate to the incorporated RICOH Pro Scanner.
  4. To save the changes, click OK.
    To discard the changes, click Cancel.
Note: When the data collector is not connected to the cloud, you cannot add, edit, or delete a data source. When the connection with the cloud is restored, all functions are enabled.

1.4.3.1 Generic SNMP Printer

Use this printer type for RICOH printers or any other printer that has Simple Network Management Protocol (SNMP) enabled and a proper printer Management Information Base (MIB) implementation. This printer type provides only printer information.

For more information on the data collected through this printer type, see Collected Data.

New Printer dialog box - Generic SNMP Printer

Select the Simple Network Management Protocol (SNMP) version to establish connectivity between the data collector and the data source. The following SNMP versions are available:

SNMP v1/v2

Select this option if you want to collect data from SNMP v1/v2 enabled printers. Make sure that SNMP is enabled on the printer. If you select SNMP v1/v2, you must specify the Read Community Name setting.

Read Community Name
Specifies the name of the SNMP community to which the printer belongs. This value must match the SNMP community name set on the physical printer.
SNMP v3

Select this option if you want to collect data from SNMP v3 enabled printers. Use SNMP v3 for RICOH printers or any other printer that has SNMP v3 enabled and a proper printer MIB implementation. Make sure that SNMP is enabled on the printer. If you select SNMP v3, you must specify the Username, Context Name, and Security Level settings.

Username
Specifies the name of the user the message is being exchanged for. The value specified in this field must match the user name set on the printer.
Context Name
Specifies the SNMP v3 context name as defined on the device. The value specified in this field must match the context name set on the printer.

This setting is optional.

Security Level
Specifies the SNMP v3 security level:

  • Minimum: without authentication and privacy.

  • Medium: with authentication, but without privacy.

  • Maximum: with authentication and privacy.

To use the Maximum level, this information is required:

Authentication Type
Specifies the authentication protocol used to encrypt and decrypt the messages exchanged between the data collector and the printer:

  • MD5: HMAC-MD5-96 authentication protocol.

  • SHA: HMAC-SHA-96 authentication protocol.

The specified authentication type must match the printer settings.

Authentication Password
Specifies the password used for encrypting the communication. The value specified in this field must match the password set on the printer.
Privacy Type
Specifies the type of privacy protocol between the data collector and the printer:
  • DES: The Data Encryption Standard uses a 56-bit key for each 64-bit block of data.
  • AES-128: The Advanced Encryption Standard uses a 128-bit key for a fixed block size of 128-bit.
  • AES-192: The Advanced Encryption Standard uses a 192-bit key for a fixed block size of 128-bit.
  • AES-256: The Advanced Encryption Standard uses a 256-bit key for a fixed block size of 128-bit.

The specified privacy type must match the printer settings.

Privacy Password

Specifies the privacy key to use with the privacy protocol. The privacy password set in this field and the privacy password set on the printer must match.

Note: To correctly display printer data, such as job names, when RICOH Data Collector receives information through SNMP, make sure that the value set for the Printer Character Set option matches the language settings configured on the printer. For more information, see the printer documentation.

1.4.3.2 RICOH Pro VC

Use this printer type for RICOH continuous form printers from the Pro VC series: RICOH Pro VC40000, RICOH Pro VC60000, RICOH Pro VC70000, and RICOH Pro VC80000.

For more information on the data collected through this printer type, see Collected Data.

Important: Before using this printer type, make sure that Printer Feature 5565 is enabled. This feature allows extended communication with the printer through RICOH Productivity Tracker.

New Printer dialog box - RICOH Pro VC

Select the Simple Network Management Protocol (SNMP) version to establish connectivity between the data collector and the data source. You can find instructions for this step in Generic SNMP Printer .

When RICOH Productivity Tracker is used, RICOH Data Collector polls the printer and sends data to the cloud every 60 seconds. This interval can cause delays in data availability and can affect the information displayed in the Real Time Display tab from RICOH Predictive Insight.

To enable an available feature on the physical printer:

  1. On the Configuration page, select DFE and Features.
  2. Click the Install button to display the list of available Feature Codes.
  3. Select the feature you want to enable and click OK.

Important: The data about printed paper length collected by RICOH Productivity Tracker might not always be exact due to the printer communication delays. Sometimes there might be a difference of a few feet between the reported data and the actual length of printed paper.

1.4.3.3 InfoPrint 5000

Use this printer type for RICOH continuous form printers from the InfoPrint 5000 series.

For more information on the data collected through this printer type, see Collected Data.

Important: Before using this printer type, make sure that Printer Feature 5565 is enabled. This feature allows extended communication with the printer through RICOH Productivity Tracker.

New Printer dialog box - InfoPrint 5000

Select the Simple Network Management Protocol (SNMP) version to establish connectivity between the data collector and the data source. You can find instructions for this step in Generic SNMP Printer .

When RICOH Productivity Tracker is used, RICOH Data Collector polls the printer and sends data to the cloud every 60 seconds. This interval can cause delays in data availability and can affect the information displayed in the Real Time Display tab from RICOH Predictive Insight.

To enable an available feature on the physical printer:

  1. To display the Features Administrator panel from the main panel in the operator console, select Printer Definition and Features.
  2. Click Install to display the list of available Feature Codes.
  3. Select the feature you want to enable or disable and click OK.
  4. To enable a selected feature, select Enable. To disable a selected feature, select Disable.
  5. Click Close.

Note: The printer must be stopped before this function can be performed.

To perform this function, you must have a service role.

Important: The data about printed paper length collected by RICOH Productivity Tracker might not always be exact due to the printer communication delays. Sometimes there might be a difference of a few feet between the reported data and the actual length of printed paper.

1.4.3.4 InfoPrint 4100

Use this printer type for RICOH continuous form printers from the InfoPrint series: InfoPrint 4000 and InfoPrint 4100.

For more information on the data collected through this printer type, see Collected Data.

Important: Before using this printer type, make sure that Printer Feature 5565 is enabled. This feature allows extended communication with the printer through RICOH Productivity Tracker.

New Printer dialog box - InfoPrint 4100

Select the Simple Network Management Protocol (SNMP) version to establish connectivity between the data collector and the data source. You can find instructions for this step in Generic SNMP Printer .

When RICOH Productivity Tracker is used, RICOH Data Collector polls the printer and sends data to the cloud every 60 seconds. This interval can cause delays in data availability and can affect the information displayed in the Real Time Display tab from RICOH Predictive Insight.

To enable an available feature on the physical printer:

  1. To display the Features Administrator panel from the main panel in the operator console, select Printer Definition and Features.
  2. Click Install to display the list of available Feature Codes.
  3. Select the feature you want to enable or disable and click OK.
  4. To enable a selected feature, select Enable. To disable a selected feature, select Disable.
  5. Click Close.

Note: The printer must be stopped before this function can be performed.

To perform this function, you must have a service role.

Important: The data about printed paper length collected by RICOH Productivity Tracker might not always be exact due to the printer communication delays. Sometimes there might be a difference of a few feet between the reported data and the actual length of printed paper.

1.4.3.5 RICOH GW Cut Sheet Printer

Use this printer type for printers that are operated through RICOH GW controllers.

For more information on the data collected through this printer type, see Collected Data.

New Printer dialog box - RICOH GW Cut Sheet Printer

Select the Simple Network Management Protocol (SNMP) version to establish connectivity between the data collector and the data source. You can find instructions for this step in Generic SNMP Printer .

RICOH Data Collector polls the printer and sends data to the cloud every 30 seconds. This interval can cause delays in data availability and can affect the information displayed in the Real Time Display tab from RICOH Predictive Insight.

Note: To correctly display printer data, such as job names, when RICOH Data Collector receives information through SNMP, make sure that the value set for the Printer Character Set option matches the language settings configured on the printer. For more information, see the printer documentation.

1.4.3.6 RICOH Fiery Cut Sheet Printer

Use this printer type for printers that are operated through Fiery controllers. You can receive limited job data through SNMP or you can use RICOH API for Fiery to receive detailed job information.

For more information on the data collected through this printer type, see Collected Data.

New Printer dialog box - RICOH Fiery Cut Sheet Printer

Select the Simple Network Management Protocol (SNMP) version to establish connectivity between the data collector and the data source. You can find instructions for this step in Generic SNMP Printer .

RICOH API for Fiery - Status Enabled
When Status is Enabled, job data is collected through RICOH API for Fiery. The data collector receives detailed job information, such as job ID, job name, job state, copies, pages, sheets, and impressions.

Make sure that the printer has Fiery API version 5.2.27.01 or later and the Fiery patch for RICOH Predictive Insight. See the Fiery Command WorkStation documentation for information on updating Fiery API.

To use RICOH API for Fiery, you must authenticate with a user name and password that match the credentials used to register on the RICOH Fiery Cut Sheet Printer. If you did not change the default credentials, enter admin for the user name and Fiery.1 for the password.

Click TEST to make sure that there are no connection or authentication issues. RICOH Data Collector verifies the connection with the printer and retrieves the printer time zone. If you want to set a different time zone, select another value from the Time Zone list.

    Note:
  • This function is only available with the RICOH API for Fiery feature. If you want to purchase this feature, contact your Ricoh representative.
  • When configuring the printers with RICOH Fiery controllers (Pro C9500 Series, Pro C7500 Series, and PRO Z75), the user name and password are not required. RICOH Data Collector logs in automatically.
  • Make sure that you have the Fiery patch installed: FIT102429972 (for Windows-based Fiery controllers) or FIT102430496 (for Linux-based Fiery controllers).
  • For RICOH Pro9500 printers, make sure that you have the minimum version of RICOH API for Fiery installed: 5.2.75.00 and the Fiery patch installed: SP3_FIT102693514 (for Windows-based Fiery controllers).
  • For RICOH ProC7500 printers, make sure that you have the minimum version of RICOH API for Fiery installed: 5.2.75.00 and the Fiery patch installed: SP3_FIT102693519 (for Windows-based Fiery controllers).
  • For Z-75 N-500 printers, make sure that you have the minimum version of RICOH API for Fiery installed: 5.2.72.00 and the Fiery patch installed: SP1_FIT102697536 (for Windows-based Fiery controllers).
  • If you want to use RICOH API for Fiery with printers that are already registered in RICOH Data Collector, you must edit the printer properties and enable the RICOH API for Fiery option. Then, follow the steps to authenticate and connect to the printer and adjust the printer time zone as necessary.
  • For jobs submitted directly through Fiery Command WorkStation, Fiery Hot Folders, or FTP, the printing side information might not be reported correctly. To solve the problem, you can set the printing side for each submitted job manually. Right-click the job and select Properties.... In the Job properties dialog box, go to Layout and select a Duplex option. For exact instructions, see the documentation for your Fiery Command WorkStation version.
  • The number of copies is only available for jobs that have finished printing.
  • In some cases, when 2-sided jobs with an uneven number of pages are submitted through PostScript from external applications, the printing side information is not registered correctly on the printer and the job is reported as 1-sided.
RICOH API for Fiery - Status Disabled
When Status is Disabled, data is collected using SNMP. The data collector only receives limited job information, such as job state or error messages.
    Note:
  • To correctly display printer data, such as job names, when RICOH Data Collector receives information through SNMP, make sure that the value set for the Printer Character Set option matches the language settings configured on the printer. For more information, see the printer documentation.
  • For accurate job data, set the printed queue limit to 99 in Fiery Command WorkStation. Go to Servers ⇒ Device Center ⇒ Server Configuration and click the Configure button in the bottom-right corner. Then, go to Job Management ⇒ Printed Queue and enter 99 under Jobs saved in printed queue. For exact instructions, see the documentation for your Fiery Command WorkStation version.
  • In some cases, when printing together multiple short-run jobs, it is possible that some jobs will not be reported in RICOH Predictive Insight while collecting job data using SNMP.

1.4.3.7 RICOH TotalFlow Print Server Cut Sheet Printer

Use this printer type for printers that are operated through TotalFlow Print Server controllers.

For more information on the data collected through this printer type, see Collected Data.

New Printer dialog box - RICOH TotalFlow Print Server Cut Sheet Printer

Select the Simple Network Management Protocol (SNMP) version to establish connectivity between the data collector and the data source. You can find instructions for this step in Generic SNMP Printer .

You can use the JMF URL field to monitor the printer through JMF communication.

When JMF communication is used, RICOH Data Collector polls the printer and sends data to the cloud every 30 seconds. This interval can cause delays in data availability and can affect the information displayed in the Real Time Display tab from RICOH Predictive Insight.

1.4.4 Supported Printers

This section lists the printers supported by RICOH Data Collector.
    Note:
  • The list of printers is kept up to date as support is added for new printers. Check this section periodically to make sure that you have the latest information.
  • Only the printers that have been officially tested are included in the list. You can also register other printers that can communicate through SNMP and collect data using the Generic SNMP Printer configuration. For more information, see Generic SNMP Printer .
Printers with Fiery controllers:
  • Pro C5200 Series Fiery E-24B/E-44B
  • Pro C5300 Series Fiery E-27B/E-47B
  • Pro C7100 Series Fiery E-43A/E-83A
  • Pro C7200 Series Fiery E-35A/E-36A
  • Pro C7200 Series Fiery E-45A/E-46A/E-85A/E-86A
  • Pro C9100 Series Fiery E-43/E-83
  • Pro C9200 Series Fiery E-45/E-46/E-85/E-86
  • Pro 8200 Fiery EB-34
  • Pro 8300 Fiery EB-35
  • Pro 8420S Fiery JPN-EB-36
  • Pro 8420S Fiery EB-36
Printers with RICOH Fiery controllers:
  • Pro C9500 Series Fiery N-50/N-70
  • Pro C7500 Series Fiery N-50A/N-70A
  • PRO Z75 N-500
    Note:
  • When configuring the printers with RICOH Fiery controllers (Pro C9500 Series, Pro C7500 Series, and PRO Z75), the user name and password are not required. RICOH Data Collector logs in automatically.
  • When importing jobs on printer using Print and Hold, canceled jobs on the PRO Z75 printers may not be visible to user.
  • When a job is printed using Print and Hold on the PRO Z75 printers and then reprinted with a different number of copies, the reported number of copies is incorrect. All other metrics, such as impressions and sheets, are reported correctly.
  • The PRO Z75 printer does not report Ink mist Filter errors when one of the Ink mist Filters reaches end-of-life.
Printers with RICOH controllers (GW):
  • Pro C5100 GW
  • Pro C5210 GW
  • Pro C5310S GW
  • Pro C5410S GW
  • Pro C7110 GW
  • Pro C7200 GW
  • Pro C7210 GW
  • Pro C8110 GW
  • Pro C8200EX GW
  • Pro 8300S GW
  • Pro 8300S GW
  • Pro 8420 GW
  • Pro 8420S GW
Continuous form printers:
  • InfoPrint 4100
  • InfoPrint 5000
  • Pro VC40000 TotalFlow Print Server
  • Pro VC60000 TotalFlow Print Server
  • Pro VC70000 TotalFlow Print Server
  • Pro VC80000 TotalFlow Print Server

Note: The minimum supported code version for continuous form printers is:

Printer Minimum Supported Code Version
InfoPrint 4100 bos4.25.14_v15.10.108
InfoPrint 5000 Power bos5.25.20_v1.07.135
InfoPrint 5000 Intel v11.1 bos111.08.55_v2.16.132
InfoPrint 5000 Intel v12.3 bos123.25.010_v3.16.132
Pro VC40000 TotalFlow Print Server bos151.41.106_v5.40.051
Pro VC60000 TotalFlow Print Server bos151.41.106_v5.40.051
Pro VC70000 TotalFlow Print Server bos151.41.106_v5.40.051
Pro VC80000 TotalFlow Print Server bos153.09.123_v8.30.050

TotalFlow Print Server cut sheet printers:
  • Pro C7100 Series TotalFlow Print Server R-60
  • Pro C7200 Series TotalFlow Print Server R-62A
  • Pro C7200SX Series TotalFlow Print Server R-62A
  • Pro C9000 SeriesTotalFlow Print Server R-62
Other printers:
  • RICOH MP 6055SP
  • RICOH SP 4520DN
  • HP Color LaserJet CP2025

1.4.5 Collected Data

This table shows the type of data that RICOH Data Collector can receive from data sources, depending on the selected printer type.
Collected Data RICOH Pro VC InfoPrint 5000 InfoPrint 4100 RICOH GW Cut Sheet Printer RICOH Fiery Cut Sheet Printer (See note 4*) Generic SNMP Printer RICOH TotalFlow Print Server Cut Sheet Printer
Printer current state Yes Yes Yes Yes Yes Yes Yes
Printer usage statistics Yes Yes Yes Yes Yes Yes Yes
Printed paper length (See note *1) Yes Yes Yes No No No No
Number of clicks No No No Yes Yes Yes Yes
Ink Yes No No No No No No
Printer warnings and errors Yes Yes Yes Yes Yes Yes Yes
Number of printed jobs Yes Yes Yes Yes Yes No Yes
Number of sheets Yes Yes Yes Yes Yes No Yes (See note 3*)
Number of copies Yes Yes Yes Yes Yes No Yes (See note 2*)
Number of pages Yes Yes Yes No Yes No Yes (See note 3*)
Job name (See note *5) Yes Yes Yes Yes Yes No Yes (See note 2*)
Job ID Yes Yes Yes Yes Yes No Yes
Number of impressions Yes Yes Yes Yes Yes No Yes
Job state Yes Yes Yes Yes Yes No Yes
Job warnings and errors Yes Yes Yes Yes Yes No Yes
Job size Yes Yes Yes Yes Yes No Yes
Operator data Yes Yes Yes No No No No
Preset data Yes Yes Yes No No No No
Black & white printed pages - RICOH API for Fiery No No No No Yes No No
Color printed pages - RICOH API for Fiery No No No No Yes No No
Blank printed pages - RICOH API for Fiery No No No No Yes No No
Tabs printed - RICOH API for Fiery No No No No Yes No No
Rip duration (Seconds) - RICOH API for Fiery No No No No Yes No No
Note:
1* The data about printed paper length collected by RICOH Productivity Tracker might not always be exact due to the printer communication delays.
2* For IPDS jobs, RICOH Data Collector does not collect this information from TotalFlow Print Server cut sheet printers.
3* Number of total pages for the entire printing session.
4* When RICOH API for Fiery option is enabled.
5* This field only supports a limited number of characters. The limit varies based on the printer you receive information from:
  • Continuous form printers - maximum 255 characters
  • Printers that are operated through Fiery controllers:
    • SNMP - maximum 64 characters, or
    • Fiery API - maximum 256 characters
  • Cut sheet printers that are operated through TotalFlow Print Server controllers - maximum 255 characters
  • Other printers that use SNMP - maximum 64 characters

1.4.6 Editing Multiple Printers

You can select multiple printers and specify their time zone.
To edit multiple printers and set their time zone:
  1. Right-click a printer card and choose Select.
  2. Select the printers that you want to edit.
    You can use the Select All check box if you want to select all the printers.
  3. Click Set Time Zone... in the top-right corner of the page.
  4. In the Set Time Zone dialog box, select a time zone for each printer in the list.
      Note:

    • RICOH Data Collector uses the printer time zone to correctly identify the printer and collect accurate data. Make sure that the value set for the Time Zone option matches the time zone settings configured on the printer.

      For time zones that observe daylight saving time, the Adjust for daylight saving time automatically check box is selected by default. You can clear the check box if you do not want to apply the daylight saving time adjustment. For time zones that do not observe daylight saving time, the Adjust for daylight saving time automatically option is disabled.

    • You can change the time zone of the first printer from the list and then click Apply Below to set the same time zone for the rest of the printers.
    • The specified time zone applies to all future data collected from the printer.
  5. Click SAVE.
Note: When the data collector is not connected to the cloud, you cannot add, edit, or delete a data source. When the connection with the cloud is restored, all functions are enabled.

1.4.7 Printer Connectivity Status

You can monitor the state of the connection between the data collector and each individual data source by looking at the printer cards.

Printer connection status

The printer connection states are:

Not configured
No communication channel communicates with the printer.
Connected
The enabled communication channels are gathering and transferring all required data.
Partial data transfer
One or more enabled communication channels are not transferring data. Not all the necessary data metrics are gathered from the device. This might affect the data available in RICOH Predictive Insight. The system displays the date and time of the first connectivity issue.
Not connected
There is no data transfer. None of the communication channels are gathering data. The device might be offline or the configuration settings of the communication channels might be wrong. The system displays the date and time of the first connectivity issue.
    Note:
  • To receive accurate information on the printer status, make sure that you enable the SNMP protocol on the physical printer and that you configure RICOH Data Collector printers with SNMP.
  • The system displays a warning message when the connection with the cloud is interrupted. If the connection with the cloud is not active, the sign-in page and the main page display a warning banner.

1.4.8 Reordering and Selecting Printers

You can manually change the layout of the printer cards on the Printers page.
  • To move a printer card, click the printer card and hold the mouse button, then drag the printer card to the new location.

    Printers page

  • To view printers in a list, click List view button, the List view button. To view printers in cards, click Tile view button, the Tile view button.
  • To view printer properties, delete printers, or select printers, right-click a printer card and use the options available in the menu.
  • To add a printer, scan for printers, or select all the printers, right-click the empty space in the Printers page.
  • Hold the Shift key while selecting so that all the printer cards selected are added to the current selection.
  • Hold the Ctrl key while selecting so that any selection on a printer card changes its state from selected to not selected and from not selected to selected.
  • Hold the Alt key while selecting a printer card to deselect all the other printer cards.
  • You can select multiple printer cards and drag the entire selection in the desired order on the Printers page. To select more printer cards, click and drag a selection rectangle starting from the empty space on the Printers page. When using the rectangle selection, use the Ctrl or Shift key to add printers to the selection and the Alt key to remove a printer from the selection.

To close the printer selection, click Close button, the Close button.

1.4.9 Finding Printers

The search function lets you find printers based on their properties.
To find a printer:
  1. On the Printers page, click Search button, the Search button, in the top-right corner.
    You can search for a printer by entering the printer name, model, manufacturer, IP address or host name, status, or type. The search results are displayed in a table along with all the printer properties.
  2. Select the printer that you want to view.

1.4.10 Deleting Printers

You can remove the printers that you no longer need.
To delete a printer configured in RICOH Data Collector:
  1. Right-click the printer card and select Delete... or click Menu button, the menu button, on the printer card and select Delete....
  2. To delete the printer, click Yes.
    To cancel the delete action, click No.
      Important:
    • The delete action cannot be undone. The system displays a warning dialog box.
    • After you delete a printer, you no longer receive information from that printer, but historical data is still available in the system.
    • The deleted printer no longer counts towards your data source usage limit.
    • When the data collector is not connected to the cloud, you cannot add, edit, or delete a data source. When the connection with the cloud is restored, all functions are enabled.
You can also delete multiple printers at once. Right-click a printer card and choose Select. Then, select all the printers that you want to delete and click Delete... in the top-right corner of the page.

1.5 Security

Authorized users can access RICOH Data Collector using a registered email address and a valid password. The levels of access and the actions the users can perform depend on the associated user role.

1.5.1 User Roles and Permissions

Everyone who works with RICOH Data Collector has a user account that is assigned to a role. Roles define the levels of access and the actions the users can perform.

These user roles are available:

Administrator
The administrator role has full access rights throughout the RICOH Data Collector system:
  • Can install RICOH Data Collector.
  • Can manage the list of data sources.
  • Can manage the settings and plug-ins.
Viewer
  • Can only view the list of already defined data sources.
  • Can view data source properties.
  • Can monitor the connection status.
None
This account is for authenticated users with no role in RICOH Data Collector.
    Note:
  • After your authentication in RICOH Data Collector, the system retrieves the roles and permissions attached to your account.
  • You have access to data collector settings without authentication from the RICOH Data Collector host server. You must secure the host server and allow access only to authorized personnel.

1.5.2 Enabling HTTPS for RICOH Data Collector

RICOH Data Collector provides support for using the HTTPS protocol. The HTTPS protocol facilitates secure network communication by establishing an encrypted link between the server and the web browser user interface and ensures the privacy and integrity of all transmitted data.

1.5.2.1 Enabling HTTPS on Windows Servers

This procedure provides the steps for enabling HTTPS on Windows 11. There might be minor differences in other versions of Windows.
To enable HTTPS, you need a digital certificate. You can use a certificate signed by a certificate authority (CA) or a self-signed certificate.
    Important:
  • This procedure uses the Java keytool command. For details about using keytool, see the Java documentation or the documentation provided by the certificate authority.
  • If you changed the default installation path, make sure that you replace C:\Program Files\RICOH\DataCollector\ with the path where RICOH Data Collector is installed everywhere in the procedure.
  • Save copies of these files in a safe location in case you need to restore them in the future:
    • C:\Program Files\RICOH\DataCollector\apache-tomcat\conf\server.xml
    • C:\Program Files\RICOH\DataCollector\apache-tomcat\conf\web.xml
    • C:\Program Files\RICOH\DataCollector\config.json
  1. Obtain the digital certificate and store it on the computer where RICOH Data Collector is installed.
    • To use a certificate signed by a certificate authority:
      1. Follow the instructions provided by the certificate authority for obtaining a signed certificate and importing it into a keystore file.
      2. Copy the keystore file to the computer where RICOH Data Collector is installed. Make sure that you know the password for the keystore file.
      3. Open a Command Prompt window as an administrator.
      4. Go to the folder that contains the Java keytool: 
        cd "C:\Program Files\RICOH\DataCollector\jre\bin"
      5. Import the keystore file into the Java trusted certificates store used by RICOH Data Collector: 
        keytool -importkeystore -srckeystore "keystore_path" -destkeystore "C:\Program Files\RICOH\DataCollector\jre\lib\security\cacerts" -srcstorepass keystore_password -deststorepass changeit

        Replace keystore_path with the path to your keystore file. Leave the quotation marks.

        Replace keystore_password with the password for your keystore file.

    • To create a self-signed certificate:
      1. On the computer where RICOH Data Collector is installed, open a Command Prompt window as an administrator.
      2. Go to the folder that contains the Java keytool: 
        cd "C:\Program Files\RICOH\DataCollector\jre\bin"
      3. Generate a local keystore file and a self-signed certificate: 
        keytool -genkey -keyalg RSA -alias ricohdatacollector -keypass keystore_password -keystore "C:\Program Files\RICOH\DataCollector\ricohdatacollector-localkeystore.jks" -storepass keystore_password -validity certificate_validity -keysize 2048 -ext san=dns:localhost

        Replace keystore_password with the password that you want to set for the keystore file.

        Replace certificate_validity with the number of valid days for the certificate. For example, enter 90 for 90 days.

      4. Import the generated keystore file into the Java trusted certificates store used by RICOH Data Collector: 
        keytool -importkeystore -srckeystore "C:\Program Files\RICOH\DataCollector\ricohdatacollector-localkeystore.jks" -destkeystore "C:\Program Files\RICOH\DataCollector\jre\lib\security\cacerts" -srcstorepass keystore_password -deststorepass changeit

        Replace keystore_password with the password that you set for the keystore file.

  2. Stop the RICOH Data Collector service:
    1. Go to Control Panel ⇒ Administrative Tools and double-click Services.
    2. In the list of services, right-click RICOH Data Collector Web Server and select Stop.
  3. Enable HTTPS:
    1. Go to C:\Program Files\RICOH\DataCollector\apache-tomcat\conf and edit the server.xml file as an administrator.
    2. Find this code:
      <!--
<Connector executor="tomcatThreadPool"
 	port="19280"  URIEncoding="UTF-8" protocol="HTTP/1.1"
	connectionTimeout="20000"
 	redirectPort="8443" />
-->
    3. Insert this code below it:
      <Connector protocol="org.apache.coyote.http11.Http11NioProtocol" 
	port="8443" maxThreads="200" scheme="https" secure="true" 
	SSLEnabled="true" keystoreFile="keystore_path" 
	keystorePass="keystore_password" clientAuth="false" 
	sslProtocol="TLS" sslEnabledProtocols="TLSv1.2" />
    4. Replace keystore_path with the path to your keystore file. Leave the quotation marks.
      If you generated a self-signed certificate, use "C:\Program Files\RICOH\DataCollector\ricohdatacollector-localkeystore.jks".
    5. Replace keystore_password with the password for your keystore file. Leave the quotation marks.
    6. Save and close the file.
  4. Redirect HTTP requests to HTTPS:
    1. Go to C:\Program Files\RICOH\DataCollector\apache-tomcat\conf and edit the web.xml file as an administrator.
    2. Go to the last line in the file, </web-app>.
    3. Insert this code right before the last line:
      <security-constraint>
	<web-resource-collection>
		<web-resource-name>Entire Application</web-resource-name>
		<url-pattern>/*</url-pattern>
	</web-resource-collection>
	<!-- auth-constraint goes here if you require authentication -->
	<user-data-constraint>
		<transport-guarantee>CONFIDENTIAL</transport-guarantee>
	</user-data-constraint>
</security-constraint>
    4. Save and close the file.
  5. Change the internal server address:
    1. Go to C:\Program Files\RICOH\DataCollector and edit the config.json file as an administrator.
    2. Replace the line "webAddress": "http://localhost:19280", with "webAddress": "https://localhost:8443",.
    3. Save and close the file.
  6. Start the RICOH Data Collector service:
    1. Go to Control Panel ⇒ Administrative Tools and double-click Services.
    2. In the list of services, right-click RICOH Data Collector Web Server and select Start.
  7. Verify that requests are forwarded to the secure connection:
    1. Open a supported web browser window.
    2. Enter this URL in the address bar:

      http://server_address:port_number/DataCollector

      where server_address is the host name or the IP address of the computer where RICOH Data Collector is installed and port_number is the web server port.

      When the page loads, the address should change to https://server_address:port_number/DataCollector.

When users access the system, they are redirected to the secure protocol without having to take any action themselves. However, if you use a self-signed certificate or if the certificate is not specifically tied to the server, the web browser issues a warning that the certificate is not trusted.

Make sure that you repeat the procedure for enabling HTTPS whenever the certificate is about to expire. You must also repeat this procedure each time you run the installation process to reinstall, upgrade, or repair RICOH Data Collector.

After you repair RICOH Data Collector, if you no longer want to enable HTTPS, you must change the internal server address back to HTTP:

  1. Go to C:\Program Files\RICOH\DataCollector and edit the config.json file as an administrator.
  2. Replace the line "webAddress": "https://localhost:8443", with "webAddress": "http://localhost:19280",.
  3. Save and close the file.
  4. Restart the RICOH Data Collector service.

1.5.2.2 Enabling HTTPS on Linux Servers

This procedure provides the steps for enabling HTTPS on Red Hat Enterprise Linux. There might be minor differences in other Linux distributions.
To enable HTTPS, you need a digital certificate. You can use a certificate signed by a certificate authority (CA) or a self-signed certificate.
    Important:
  • This procedure uses the Java keytool command. For details about using keytool, see the Java documentation or the documentation provided by the certificate authority.
  • Save copies of these files in a safe location in case you need to restore them in the future:
    • /opt/RICOH/DataCollector/apache-tomcat/conf/server.xml
    • /opt/RICOH/DataCollector/apache-tomcat/conf/web.xml
    • /opt/RICOH/DataCollector/config.json
  1. Obtain the digital certificate and store it on the computer where RICOH Data Collector is installed.
    • To use a certificate signed by a certificate authority:
      1. Follow the instructions provided by the certificate authority for obtaining a signed certificate and importing it into a keystore file.
      2. Copy the keystore file to the computer where RICOH Data Collector is installed. Make sure that you know the password for the keystore file.
      3. Open a terminal window as the root user.
      4. Go to the folder that contains the Java keytool: 
        cd /opt/RICOH/DataCollector/jre/bin
      5. Import the keystore file into the Java trusted certificates store used by RICOH Data Collector: 
        ./keytool -importkeystore -srckeystore "keystore_path" -destkeystore "/opt/RICOH/DataCollector/jre/lib/security/cacerts" -srcstorepass keystore_password -deststorepass changeit

        Replace keystore_path with the path to your keystore file. Leave the quotation marks.

        Replace keystore_password with the password for your keystore file.

    • To create a self-signed certificate:
      1. On the computer where RICOH Data Collector is installed, open a terminal window as the root user.
      2. Go to the folder that contains the Java keytool: 
        cd /opt/RICOH/DataCollector/jre/bin
      3. Generate a local keystore file and a self-signed certificate: 
        ./keytool -genkey -keyalg RSA -alias ricohdatacollector -keypass keystore_password -keystore "/opt/RICOH/DataCollector/ricohdatacollector-localkeystore.jks" -storepass keystore_password -validity certificate_validity -keysize 2048 -ext san=dns:localhost

        Replace keystore_password with the password that you want to set for the keystore file.

        Replace certificate_validity with the number of valid days for the certificate. For example, enter 90 for 90 days.

      4. Import the generated keystore file into the Java trusted certificates store used by RICOH Data Collector: 
        ./keytool -importkeystore -srckeystore "/opt/RICOH/DataCollector/ricohdatacollector-localkeystore.jks" -destkeystore "/opt/RICOH/DataCollector/jre/lib/security/cacerts" -srcstorepass keystore_password -deststorepass changeit

        Replace keystore_password with the password that you set for the keystore file.

  2. Stop the RICOH Data Collector service:
    sudo systemctl stop RicohDataCollector
  3. Enable HTTPS:
    1. Go to /opt/RICOH/DataCollector/apache-tomcat/conf and edit the server.xml file as the root user:
      sudo gedit /opt/RICOH/DataCollector/apache-tomcat/conf/server.xml
    2. Find this code:
      <!--
<Connector executor="tomcatThreadPool"
 	port="19280"  URIEncoding="UTF-8" protocol="HTTP/1.1"
	connectionTimeout="20000"
 	redirectPort="8443" />
-->
    3. Insert this code below it:
      <Connector protocol="org.apache.coyote.http11.Http11NioProtocol" 
	port="8443" maxThreads="200" scheme="https" secure="true" 
	SSLEnabled="true" keystoreFile="keystore_path" 
	keystorePass="keystore_password" clientAuth="false" 
	sslProtocol="TLS" sslEnabledProtocols="TLSv1.2" />
    4. Replace keystore_path with the path to your keystore file. Leave the quotation marks.
      If you generated a self-signed certificate, use "/opt/RICOH/DataCollector/ricohdatacollector-localkeystore.jks".
    5. Replace keystore_password with the password for your keystore file. Leave the quotation marks.
    6. Save and close the file.
  4. Redirect HTTP requests to HTTPS:
    1. Go to /opt/RICOH/DataCollector/apache-tomcat/conf and edit the web.xml file as the root user:
      sudo gedit /opt/RICOH/DataCollector/apache-tomcat/conf/web.xml
    2. Go to the last line in the file, </web-app>.
    3. Insert this code right before the last line:
      <security-constraint>
	<web-resource-collection>
		<web-resource-name>Entire Application</web-resource-name>
		<url-pattern>/*</url-pattern>
	</web-resource-collection>
	<!-- auth-constraint goes here if you require authentication -->
	<user-data-constraint>
		<transport-guarantee>CONFIDENTIAL</transport-guarantee>
	</user-data-constraint>
</security-constraint>
    4. Save and close the file.
  5. Change the internal server address:
    1. Go to /opt/RICOH/DataCollector and edit the config.json file as the root user:
      sudo gedit /opt/RICOH/DataCollector/config.json
    2. Replace the line "webAddress": "http://localhost:19280", with "webAddress": "https://localhost:8443",.
    3. Save and close the file.
  6. Start the RICOH Data Collector service:
    sudo systemctl start RicohDataCollector
  7. Verify that requests are forwarded to the secure connection:
    1. Open a supported web browser window.
    2. Enter this URL in the address bar:

      http://server_address:port_number/DataCollector

      where server_address is the host name or the IP address of the computer where RICOH Data Collector is installed and port_number is the web server port.

      When the page loads, the address should change to https://server_address:port_number/DataCollector.

When users access the system, they are redirected to the secure protocol without having to take any action themselves. However, if you use a self-signed certificate or if the certificate is not specifically tied to the server, the web browser issues a warning that the certificate is not trusted.

Make sure that you repeat the procedure for enabling HTTPS whenever the certificate is about to expire. You must also repeat this procedure each time you run the installation process to reinstall, upgrade, or repair RICOH Data Collector.

After you repair RICOH Data Collector, if you no longer want to enable HTTPS, you must change the internal server address back to HTTP:

  1. Go to /opt/RICOH/DataCollector and edit the config.json file as the root user: 
    sudo gedit /opt/RICOH/DataCollector/config.json
  2. Replace the line "webAddress": "https://localhost:8443", with "webAddress": "http://localhost:19280",.
  3. Save and close the file.
  4. Restart the RICOH Data Collector service.

1.6 Troubleshooting and Support

If you encounter problems while working with RICOH Data Collector, you might be able to solve them by using the information in this section.

1.6.1 Uploading Diagnostic Data

If you encounter issues while using RICOH Data Collector, you can easily upload diagnostic data that can help troubleshoot the problem.
To upload diagnostic data:
  1. Make sure that you have at least 10 GB of free space available on the drive where RICOH Data Collector is installed.
  2. Sign in to RICOH Data Collector.
  3. On the menu bar, click Help button, the Help button, and select Send Diagnostic Data.
  4. In the Send Diagnostic Data dialog box, provide more information about the encountered issue and upload the diagnostic data.
    Send Diagnostic Data dialog box
    1. Under Topic, select the type of issue.
      For example, you might encounter connectivity issues or issues with missing or inaccurate data.
    2. Under Printers, select the printers that we should focus on during the investigation of the issue.
      Data is still collected and sent for all the printers registered in the system.
    3. Under Message, enter any other useful information that you would like to include with the diagnostic data.
    4. Click SUBMIT.
    Once the diagnostic data is uploaded, software support can use it to investigate the reported issue. For more information on the collected data, click What information is being sent?.
    Note: You can upload diagnostic data only when the data collector is connected to the cloud. If the data collector is not connected to the cloud, you can instead download the data locally and provide it to your Ricoh support representative.
You can check the status of the data upload in the Activity Log tab. If the upload encountered problems, such as file size or disk space issues, and was unsuccessful, collect the traces manually.

1.6.2 Common Problems

If you encounter problems while using RICOH Data Collector, you might be able to solve them by using the information in this section.
Collecting Traces

To help troubleshoot a problem, you can gather traces from your data collector. RICOH Data Collector uses a tracing mechanism that records the code activity.

Use one of these methods to collect the data collector traces together with any additional system information, such as installation details and disk space:

  • Upload diagnostic data. For more information, see Uploading Diagnostic Data.

      Note:
    • The traces are automatically collected and uploaded to cloud.
    • You need to sign in to upload diagnostic data.

  • Download the traces by entering this URL in the address bar of your web browser:

    http://server_address:port_number/DataCollector/traces

    where server_address is the host name or the IP address of the computer where RICOH Data Collector is installed and port_number is the web server port.

    If you are on the computer where RICOH Data Collector is installed and you are using the default port, you can go to http://localhost:19280/DataCollector/traces.

    The resulting package is named dc_traces_yyyymmdd_hhmmss_code.zip, where yyyymmdd and hhmmss represent the date and time when the traces were collected and code is a randomly generated identification code.

      Note:
    • The first part of the URL for collecting traces matches the RICOH Data Collector URL. You can simply add /traces at the end of the URL that you are using to access the application.
    • You can collect the traces without signing in.
    • You must send the traces to a Ricoh representative.

  • Manually generate a zip file with collected traces, following these steps:

    1. Log in remotely on the machine where RICOH Data Collector is installed.
    2. Download the traces by launching the getTraces.bat script on Windows or the getTraces.sh script on Linux. If RICOH Data Collector is installed in the default location, the location of the .bat is C:\Program Files\RICOH\DataCollector\bin for Windows and the location of the .sh on Linux is/opt/RICOH/DataCollector/bin for Linux.
    3. The resulting package is named DataCollector-Traces-timestamp.zip, where timestamp represents the timestamp in milliseconds when the traces were collected.

    Note: You can collect the traces when RICOH Data Collector is not accessible via web browser.
Your Region Is Unreachable During the Installation

If the region where you want to store your data cannot be selected in the Choose Region dialog box, make sure that the proxy or firewall settings do not block access to the region URL:

  • United States: https://datacollector.app-ricohsoftware.com/account-details.json
  • Europe: https://datacollector.app-ricohsoftware.eu/account-details.json

Using Specials Characters in the Installation Path

When installing RICOH Data Collector, you may encounter an issue if you need to use special characters in the file path. Verify that your operating system's language settings are set to use UTF-8 encoding. This setting allows the software to recognize special characters in file paths. Make sure you select the Beta: Use Unicode UTF-8 for worldwide language support check box.

Issues with Blocked URLs

For installing RICOH Data Collector, make sure that you allow access to these URLs:

  • For the United States:
    • ricohsoftware.com
    • help.ricohsoftware.com
    • rpi.app-ricohsoftware.com
    • services.app-ricohsoftware.com
    • datacollector.app-ricohsoftware.com
    • fileupload.app-ricohsoftware.com
    • cognito-idp.us-west-2.amazonaws.com
  • For Europe:
    • ricohsoftware.eu
    • help.ricohsoftware.com
    • rpi.app-ricohsoftware.eu
    • services.app-ricohsoftware.eu
    • datacollector.app-ricohsoftware.eu
    • fileupload.app-ricohsoftware.eu
    • cognito-idp.eu-west-1.amazonaws.com

Restarting the RICOH Data Collector Service

Use this procedure if you encounter problems and need to restart the RICOH Data Collector service manually:

To restart the RICOH Data Collector service, follow these steps on the computer where RICOH Data Collector is installed:

  • On Windows, go to Control Panel ⇒ Administrative Tools and double-click Services. In the list of services, right-click RICOH Data Collector and select Restart.
  • On Linux, use this command: 
    sudo systemctl restart RicohDataCollector

In the RICOH Data Collector application, check the status of the data collector and of your registered printers.

Make sure that there are no connectivity or data collection issues.

The Data Collector Appears to Be Unregistered from the Cloud, Your Subscription Is Valid, and This Instance of RICOH Data Collector Has Been Previously Registered

Your data collector might get unregistered from the cloud if there is a power outage, the disk is full, or the internal database gets corrupted. The internal database is used for storing data source information until the data collector is connected to the cloud. Data source information might be lost during a power outage or if the disk is full.

Repeat the authentication steps in RICOH Predictive Insight and restore your data collector. Instead of selecting a new instance, select the data collector corresponding to your previous installation.

To prevent data loss:

  • Make sure that you use an Uninterruptible Power Supply (UPS) for power outages.
  • Limit access to the computer where RICOH Data Collector is installed.
  • Check your disk integrity and space availability periodically.
  • It is recommended to keep your data collector connected to the cloud.

Cannot Launch the Application

If RICOH Data Collector does not launch after you restart the computer, run Repair, then restart the computer again.

Or uninstall and reinstall RICOH Data Collector. Make sure that you do not select the Delete the Data Collector from the cloud check box when you uninstall the application. Otherwise, any stored data is lost.

RICOH Data Collector Service No Longer Available after Running Repair

If the RICOH Data Collector service is no longer available after you run Repair, try running Repair again.

Cannot Sign In

Make sure that you enter your email address and password correctly. The password is case-sensitive.

If you forgot your password, click Forgot password on the sign-in page and follow the required steps. After you provide the email address for your account, you receive a verification code for resetting the password.

Cannot Access the Application After Changing the RICOH Data Collector Server IP Address or Host Name

To avoid issues, restart the RICOH Data Collector server after you change its IP address or host name.

Cannot Access the Application on openSUSE

On openSUSE, make sure you install the insserv-compat package before installing RICOH Data Collector. Install RICOH Data Collector and restart the computer.

If RICOH Data Collector was installed before the insserv-compat package, run Repair, then restart the computer again.

Incorrect Display of a Page

The page was not loaded correctly. Clean the web browser cache and reload the page. See your web browser documentation for instructions on how to clean the cache and reload a page.

Make sure that you are using a supported web browser that is properly configured.

Events Are No Longer Received in the Cloud

Make sure that the data collector is online.

Disable the Store Data Locally option in the General Settings tab.

Disable power saving on the computer where RICOH Data Collector is installed. Otherwise, the computer might enter sleep or power save mode and the communication with the cloud might be interrupted.

Events Collected by RICOH Data Collector While RICOH Predictive Insight Is in Maintenance Are Lost

If events are not stored locally and sent to the cloud after the scheduled RICOH Predictive Insight maintenance period, you might have an older version of RICOH Data Collector. Upgrade to the latest version.

The Data Collector Is Not Connected to the Cloud

Check your internet connection and your proxy settings.

Cannot Add, Edit, or Delete a Data Source

Make sure that you are connected to the cloud. When the data collector is not connected to the cloud, you cannot add, edit, or delete a data source.

Make sure that you still have available data sources. See the application footer for information on data source usage.

Make sure that you have appropriate user authority. Contact your Ricoh representative to verify the user role provided by your account.

Printers Are Not Automatically Discovered Through the Scan for Printers Function

For RICOH Data Collector to find printers through the Scan for Printers function, you must first enable the SNMP v1/v2 protocol on the physical printer. For more information, see the printer documentation.

Make sure that the scanned printers are online.

Information About Printer Status Is Missing

Make sure that you enable the SNMP protocol on the physical printer and that you configure RICOH Data Collector printers with the SNMP communication channel. For information on enabling SNMP on the printer, see the printer documentation.

Information About Jobs Is Missing

Make sure that you select the correct printer type for your printer model and enable the SNMP protocol on the physical printer. For information on enabling SNMP on the printer, see the printer documentation.

Job Names Are Displayed Incorrectly

There is a limited number of characters for the job name field. The limit varies based on the printer you receive information from. If you use more, the printer will send truncated or modified data. To correctly display the job name, limit the field characters to:

  • Continuous form printers - maximum 255 characters
  • Printers that are operated through Fiery controllers:
    • SNMP - maximum 64 characters, or
    • Fiery API - maximum 256 characters
  • Cut sheet printers that are operated through TotalFlow Print Server controllers - maximum 255 characters
  • Other printers that use SNMP - maximum 64 characters.

To correctly display printer data, such as job names, when RICOH Data Collector receives information through SNMP, make sure that the value set for the Printer Character Set option matches the language settings configured on the printer. For more information, see the printer documentation.

The Printer Character Set option is available when you add or edit printers that use the Generic SNMP Printer, RICOH GW Cut Sheet Printer, or RICOH Fiery Cut Sheet Printer configuration.

Information About Ink or Roll Usage Is Missing

Make sure that you select the correct printer type for your printer model and enable the RICOH Productivity Tracker communication channel.

Access to RICOH Data Collector Settings Is Allowed Without Authentication from the RICOH Data Collector Host Server

You must secure the RICOH Data Collector host server and allow access only to authorized personnel.

RICOH Data Collector Does Not Manage Local Data Storage

If you enable the Store Data Locally option in the General Settings tab, RICOH Data Collector creates a series of files with the data collected from the printers, in the specified location, each time new data is collected. It is your responsibility to process or remove the files.

Cannot Access the RICOH Data Collector Online Help System

The RICOH Data Collector online help system can be viewed only from computers with internet access. Enable internet access on your computer or use the on-screen field help for useful information.

Data Collected for 1-Sided or 2-Sided Jobs Is Not Accurately Reported Through SNMP

If you are submitting jobs with the same printing side, either 1-sided or 2-sided, make sure that they are all completed and reported as printed by RICOH Data Collector, before submitting another set of jobs with the same printing side.

If you want to print jobs with different printing sides, 1-sided or 2-sided, make sure that you submit the jobs one by one. After each submitted job is completed and reported as printed by RICOH Data Collector, you can submit the next job.

Performance Issues Caused by Insufficient Random Access Memory (RAM)

To avoid performance issues, we recommend that you register up to 15 printers for 4 GB available RAM.

If you want to monitor a larger number of printers, increase the available RAM or install additional data collectors.

Missing or Inaccurate Data after Power Outage

In case of a power outage, we recommend that you uninstall and reinstall RICOH Data Collector. Make sure that you do not select the Delete the Data Collector from the cloud check box when you uninstall the application. Otherwise, any stored data is lost.

To prevent any power outage related issues, make sure that you use an Uninterruptible Power Supply (UPS) for power outages.

Manually Uninstall RICOH Data Collector

Manually deleting the RICOH Data Collector service does not allow installing a new data collector.

This procedure provides the steps for manually uninstalling RICOH Data Collector.

Make sure that you have appropriate user authority. You must have administrator role to complete the procedure. Contact your Ricoh representative to verify the user role provided by your account.

  • On Windows:

    1. Stop the RICOH Data Collector service using one of these methods:
      • Use the Services app.
      • Use this command:
        net stop RicohDataCollector
    2. Remove the RICOH Data Collector service using one of these methods:
      • Use the regedit tool, following these steps:
        • Open regedit.
        • Go to HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\RicohDataCollector.
        • Right click on RICOH Data Collector and select Delete.
      • Use this command:
        reg delete "HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\RicohDataCollector" /f

        If the RICOH Data Collector service entry from the Services app is still available, restart the machine where RICOH Data Collector is installed.

    3. Remove the RICOH Data Collector uninstall entry from Control Panel using one of these methods:
      • Use the regedit tool, following these steps:
        • Open regedit.
        • Go to HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\RICOH Data Collector.
        • Right click on RICOH Data Collector and select Delete.
      • Use this command:
        reg delete “HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\RICOH Data Collector” /f
    4. Edit the Zero G Registry file:
      • Open File Explorer and change the View options by making the system files and folders visible.
      • Go to C:\Program Files\Zero G Registry and edit the .com.zerog.registry.xml file by deleting everything related to RICOH Data Collector and to the path where RICOH Data Collector was installed.

      If there are other products mentioned in this file, make sure you only delete the entries related to RICOH Data Collector.

      If there is only information related to RICOH Data Collector, you can delete the file.

    5. Delete the installation folder (Example: C:\Program Files\RICOH\DataCollector).
    6. Delete the RICOH Data Collector shortcuts from the Desktop.

  • On Linux:

    1. Stop the RICOH Data Collector service using one of these commands:
      sudo service RicohDataCollector stop
      or 
      sudo systemctl stop RicohDataCollector
    2. Remove the RICOH Data Collector service using this command:
      sudo rm -f /etc/init.d/RicohDataCollector
    3. Edit the Zero G Registry file:
      • Search for .com.zerog.registry.xml (Example: /var/.com.zerog.registry.xml) or use this command: 
        sudo find -iname *zerog.registry.xml
      • Edit the file by deleting everything related to RICOH Data Collector and to the path where RICOH Data Collector was installed.

    4. Delete the installation folders (Example: /opt/RICOH/DataCollector) using the commands:

      sudo rm -rf /opt/RICOH/DataCollector
      sudo rm -rf /root/.DataCollector

Contacting Ricoh Support

If you need help with a RICOH Data Collector issue, you can contact a Ricoh support representative.

For technical support inside the United States, contact 1-877-318-8968. For all other regions, contact your Ricoh sales representative or technical support.