Troubleshooting YSoft SafeQ Embedded Terminal for Ricoh SOP

If errors or warnings appeared during device preparation or installation of the terminal, follow the instructions in this section to be sure the MFD is configured correctly for the terminal.

Problem: Unable to print on Ricoh driver (without using YSoft SafeQ client)

Solution: Configuring Ricoh SOP - Configuring Ricoh driver

Problem: Document server not available

Solution:

  1. Login as an admin to the device if required.

  2. In User Tools > Machine Features > Administrator Tools > Enhanced External Charge Unit Management (on 2nd page) unblock Document Server (see picture below).

images/download/attachments/188401975/unchecked_document_server_for_service_menu_access.png

Problem: Service menu inaccessible

Solution:

  1. Go to the Ricoh MFD web interface (Web Image Monitor).

  2. Login as an administrator.

  3. Make sure User Authentication Management is tuned off under Device Management > Configuration .

    images/download/attachments/188401975/image2020-4-17_12-24-40.png

Problem: Unable to login as admin in home menu

Solution:

  1. Go to the Ricoh MFD web interface (Web Image Monitor).

  2. Login as an administrator.

  3. Make sure User Administrator Authentication is turned on under Device Management > Configuration.

    images/download/attachments/188401975/adminAuthMgmt_marked.png


  4. Make sure User Authentication Management is tuned off under Device Management > Configuration.

    images/download/attachments/188401975/image2020-4-17_12-24-26.png

Problem: Card reader is not working.

Solution:

  1. Make sure the USB cable is plugged in directly into the SOP panel.

  2. See Configuring USB Card Reader in Configuring Ricoh for 2nd Gen. SOP Embedded Terminal.

Problem: Terminal installation hangs on last step

images/download/attachments/188401975/image2020-4-16_14-6-57.png

Solution:

  1. Go to the Ricoh MFD web interface (Web Image Monitor).

  2. Login as an administrator.

  3. In User Authentication Management set User Authentication Management to Custom Authentication.

images/wiki.ysoft.local/download/attachments/188392030/user_auth_management_settings_marked.png

Problem: Unable to install embedded terminal (device not reachable).

images/download/attachments/188401975/devicenotfound.png

Solution:

  1. Make sure Device IP is correct.

  2. Make sure there are no network issues and no ports used by management/MFD are blocked.

Problem: MFD is not responding correctly.

images/download/attachments/188401975/terminalnotresponding.png

(example of not responsive MFD, after clicking on print nothing happens as seen above)

Solution:

  1. Make sure there are no network issues and no ports used by management/MFD are blocked.

Problem: Unable to reinstall terminal (Configuration failed. Unable to connect to the remote configuration component on the target MFD.)

images/download/attachments/188401975/2a6bf0fa-71e7-4aa8-af7b-b14778b67727.PNG

Solution:

  1. Uninstall terminal

  2. Manually restart the MFD.

  3. Install terminal again.

Problem: Unable to install embedded terminal (Multiple packages of the same version were found).

images/stash.ysoft.local/rest/api/1.0/projects/TS/repos/terminalserver/attachments/633.png

Solution:

  1. Navigate to Apps\RicohSop directory in terminalserver install location (ex.: C:\SafeQ6\SPOC\terminalserver\Apps\RicohSop).

  2. Delete one of the files with the same package, as indicated by the error message.

Problem: A validity check error is displayed on a terminal. (Most probably Ricoh web API token is expired.)

Solution:

  1. Update YSoft SafeQ.

images/download/attachments/188401975/SOP_validity_check_error.png

Problem: Installation fails because of timeout.

Solution:

In Management → System → Configuration:

  1. Increase tsCommunicationTimeoutSecond value

    • Suggested value: 360

  2. Increase maxEmbeddedInstallationStatusAge value

    • Suggested value: 20m

images/download/attachments/188401975/InstallationFailsOnTimeout.png

Problem: Failed to remove existing application shortcuts during installation.

Solution:

This happens after the application crashed. Reboot the MFD and try the installation again. (Note that on MFD screen there can be "Installation in progress", but do the reboot anyway.)
If the issue persists:

  1. Go to MFD website > log in as admin.

  2. Device Management > Configuration > Extended Feature Settings > Uninstall > remove YSoft SafeQ applications (such as rxspServlet , YSoft SafeQ Authentication ).

  3. Reboot MFD and run the installation again.

images/download/attachments/188401975/Failed_to_remove_existing_application_shortcuts.PNG

Problem: USB reader stops working when MFD goes into sleep mode.

Solution:

  1. Login to service mode on SOP panel.

  2. Select "Screen Device Settings".

    images/download/attachments/188401975/Ricoh_SOP_Service_mode_01.PNG
  3. Select "Authentication priority mode" and turn on "Authentication priority mode".

    images/download/attachments/188401975/Ricoh_SOP_Service_mode_02.PNG


    images/download/attachments/188401975/Ricoh_SOP_Service_mode_03.PNG
  4. Turn on "Screen device always-connection Settings".

    images/download/attachments/188401975/Ricoh_SOP_Service_mode_04.PNG

Problem: G2.5 scan is accounted under -unknown- user

Solution: Ask the RICOH technician to set the SP option USER_AUTHENTICATION__SCANNER (SP-5-420-031) to the default value on the problematic devices.