YSoft SafeQube 2 Deployment

Prerequisites

  • YSoft SafeQ Management Service installed and running.

  • YSoft SafeQube 2 with installed YSoft SafeQ Spoler Controller (SPOC), Terminal Server and IMS proxy application.

Deployment steps:

Start the device

  1. Plug in the network cable to any of its available Ethernet ports.

  2. Plug in the power cable and wait until the device is up.

Login to SafeQube 2 web management

Go to https://<device IP address>:8083

  • the IP address is displayed on the OLED display

  • Username: manager

  • Default password: oCfpB112g5bZpOcywAp7

Change manager password

The password is the same for all devices. Therefore, it is highly recommended to change it.

  1. Click on manager > Change password

  2. Fill the Current password and type new password twice for confirmation

  3. Press Save changes button.

images/download/attachments/160481524/image2019-2-19_9-40-49.png

Install/update your applications

  1. Go to Applications section in the left panel

  2. Check versions of the applications that are already installed on the device. If there are none, or they don't match the version of Management, continue with the next steps.

  3. Download the "Complete Pack" installation archive from the Partner portal and unpack the UA update package archive (you will find it under Complementary Solutions\Hardware Packages)

  4. In the UA update package archive, find the packages of the applications you want to install/update (with the .tar.gz extension)

  5. For each application, click INSTALL APPLICATION button in the Applications section of the SafeQube web interface and select the application package and click SUBMIT

    images/download/attachments/160481524/Screenshot_2020-08-04_at_13.31.43.png

Connect SafeQube 2 to Infrastructure Server (IMS)

  1. Make sure the IP address of the SafeQube is stable. Either set a static IP address or create a reservation in DHCP server.

  2. Fill in the Infrastructure server 1 with its valid address an Infrastructure Server (IMS) running on a Management Server. The default format is https://<management_server_address>:7348 (HTTPS is mandatory, 7348 is the default IMS port number). Using DNS records instead of IP addresses is possible.

  3. Test the connection by pressing Test button

  4. Press Save button.

images/download/attachments/160481524/image2019-2-19_10-5-42.png

After changing the IP address of the SafeQube, it is necessary to re-login to web management with the new IP address.

Configure Spooler Controller and Terminal Server

  1. Go to https://<device IP address>:8083

  2. Go to Applications section in the left panel

    images/download/attachments/160481524/image2019-2-19_11-0-14.png

  3. Click on configure icon for terminalserver application, fill in all fields and press Save and Restart Application.

    images/download/attachments/160481524/Screenshot_2020-08-04_at_14.30.25.png

    • for terminalserver the following parameters must be set if a WPS scan server is to be used:

      • TS_wpsBaseAddress – WPS server API endpoint URL (e.g. http://10.0.13.230:5600/). Please make sure the URL ends with a forward slash character as in the example.

      • TS_workflowStorageType – set to webdav if you will use a scan server (WPS), or leave as none .

      • TS_workflowStorageRoot – central WebDAV server for scanned data (e.g. http://10.0.13.55:8099/). Please make sure the URL ends with a forward slash character as in the example.

      • TS_workflowRemoteStorageUsername – the username for an account with WebDAV permissions.

      • TS_workflowRemoteStoragePassword – the password for an account with WebDAV permissions in encrypted form.

        • Login to Management Server as administrator

        • Go to Dashboard, enter text to encrypt to Text encryption widget and click on Encode

          images/download/attachments/160481524/encrypted.JPG
      • TS_validateWebDavServerCertificateOnUnix – set to false if you will use a scan server.

  4. Click on configure icon for spoc application, fill in all fields and press Save and Restart Application.

images/download/attachments/160481524/Screenshot_2020-08-04_at_14.14.13.png

  • for Spooler Controller following parameters must be set:

    • spoc.localGUID - SPOC GUID (e.g. local_GUID )

    • spoc.serverGUID1 - GUID of Management server (e.g. Management_GUID)

    • spoc.serverIP1 - IP address of Management server (e.g. 10.0.13.230)

    • spoc.serverPORT1 - communicator port of Management server (usually 6010)

    • spoc.smartQ-server-ip - Spooler Controller IP address (e.g. 10.0.5.145)

    • spoc.tenantDomain - tenant name on Management server (e.g. tenant_1)

Verify configuration

  1. Connect to SafeQube's management console (SSH connection using the IP address of SafeQube and the same credentials as are used for web management) and run console command "server test". It should return OK for configured IMS address.

  2. For terminalserver application check logs on https://<device IP address>:8083/logs. Look for message "TS fully started".

  3. For spoc application, check if Spooler Controller is registered and has status "Online" on the management interface (Devices > Spooler Controller groups).

  4. Check that imsproxy application is running.

All settings can also be performed from YSoft hardware management console. See YSoft hardware administrator guide for more details.

Troubleshooting

Spooler Controller

Spooler Controller reconnected to the different YSoft SafeQ Management Service does not register

Scenario

  • Spooler Controller has successfully registered to the first YSoft SafeQ Management Service

  • You changed value of parameter spoc.serverIP1 and restarted Spooler Controller application

  • Spooler Controller does not register to the second YSoft SafeQ Management Service because of SQ error:

    Sender GUID '<spoc.localGUID>' is not known to the tenant resolver service!"

Solution

After changing spoc.serverIP1, delete the Spooler Controller cache by rebooting the SafeQube.

Ricoh SOP Device

Installation of Ricoh SOP device takes too long and fails to configure the device

(This was observer mainly on Safe Qube 2 with Terminal Server MU59 and older)

Scenario

  • When adding a device of type Ricoh SOP (Management - Devices - New Device), the installation takes quite long (cause of multiple restarts)

  • The installation fails while sending the configuration to the MFD and the device is stacked with the "Installation in progress" on the screen of the MFD.

  • In the LOG of Terminal Server we can see the error:

    WPS server certificate is invalid ...

Solution

  • For Terminal Server on Safe Qube 2 check the TS_wpsBaseAddress parameter to be filled in.

    • Comment: It sets the Terminal Server property wpsBaseAddress in terminalserver.exe.config.

The empty/null value in wpsBaseAddress causes that the WPS certificate validation is used event if the WPS address is not set.