Brother Terminal

MFD Prerequisites

The default administrator password on the MFD has been set.
The MFD supports the Brother Solution Interface(BSI).
‘Scan to Email’ must be enabled on the MFD

Brother Solutions Interface BSI

Supported devices list can be found in Dispatcher Paragon Portal.

Installing

Installing Terminal Application

  1. Make sure your secondary gateway is configured according to Secondary Gateway mapping.

  2. Push the Embedded configuration from embedded screen in Dispatcher Paragon Cloud.

    embedded_templates_detail.png

Up until 3.27, the server address had to be a hostname that the printer could verify to make a proper secure connection. If an IP-setup was used configure the embedded client, the user would have to access the webpage of the printer and manually change it to using non-secure HTTP and port 8704 to be able to use the Brother client. Starting from 3.27, this is now done automatically, if it is detected during installation that an IP is used.
This means that, if an IP setup is used, for some instances of communication with Dispatcher Paragon Cloud and local communication on the printer, non-secure HTTP and port 8704 is used. For Dispatcher Paragon Cloud, this includes installation and uninstallation. Locally on the printer, this occurs whenever the Brother system initiates a redirect; on login, logout and when the embedded app is accessed through the solutions app on the printer.
To see (or change this setting), access the webpage of the printer -> login -> Administrator -> Solutions -> Solutions Application Entry -> press Login / Logout /Menu1.

Deploying CA Certificate

To enable communication between the gateway and the MFD, install the CA certificate that signed the gateway certificate on the MFD.

  1. First, obtain the CA certificate. You can either:

    • Use a CA certificate signed by a trusted authority

    • Generate a self-signed certificate (only if you understand and accept the security risks)

  2. Then import the CA certificate to:

    1. SQC server certificate trust store (see Certificates)

    2. MFD certificate trust store:

      • ca-certificate.png

      • Some MFDs have a limit of 4 certificates. You may need to delete existing certificates before installing new ones. This can also be an issue if multiple leaf certificates must be installed.

Uninstalling

Uninstalling the Brother client is straight-forward (as in using the uninstall-button through Dispatcher Paragon Cloud). However, a currently running embedded instance must be exited after uninstallation, either manually or through waiting for the automatic timeout on the printer to trigger, or they will still be able to use the embedded client. Also, If a user was logged while the uninstallation took place, they must manually logout.

Troubleshooting

BSI

If BSI is missing, then you have to request access to development resources at the link below:
Enable BSI

Once BSI is enabled, the “Solutions” (or “Solutions Settings”) section will appear in the MFD web interface, and you should be able to set “Solutions” to “On.” Please note manual change is not required for the installation to complete, as the installer can enable it automatically.

Customize login message

The printer has the option to customize the login message from the printer web page. Under Administrator -> Solutions you can change Login Portal Message to the message you want, the default english text is “Login Requested”

Scan to email

Verify that there is an entry ‘Scan to email-server’ in the scan-menu. The scan menu can be reached, on the printers display, from the main screen.

If the ‘Scan to email-server’ is not present, you’ll need to install a firmware addition.

Card readers

As standard only a few card readers are supported on the Brother devices.

Remember to enable USB card reader support.

To add support for additional readers you have to set up External Card reader on the printer web page.
external-cardreader.png

Solutions Application Entry

There needs to be 3 entries, Login, Logout and a menu.

For login URL should be https://[SERVER]:8703/WebClientBrother/login/start, leave arguments empty

login-application-entry.png

For Logout URL should be https://[SERVER]:8703/WebClientBrother/main/logout

For MenuX URL should be https://[SERVER]:8703/WebClientBrother/login/start

Error codes

Refer to the following chart to check and solve the error code displayed on the LCD of the Brother device

Error codes

Error configuring terminal (HBT-5347)

webclientBrother.log shows:

09:22:09.475 [1-862] {DEBUG } headers                - http-outgoing-1 >> GET /home/status.html HTTP/1.1
09:22:09.506 [1-862] {DEBUG } wire                   - http-outgoing-1 << "HTTP/1.1 404 Not Found[\r][\n]"
09:22:09.544 [1-862] {ERROR } Configurator           - Configure failed org.apache.hc.client5.http.HttpResponseException: status code: 404, reason phrase: Not Found

To resolve issue go to MFD administrative interface → Network → Protocol → Web Based Management (Web Server) → HTTP Server Settings and:

  • Enable “HTTP (Port 80)”

  • Disable “Always redirect to HTTPS”

Error configuring terminal (SNMP)

webclientBrother.log shows:

10:04:08.217 [1-860] {WARN  } SnmpUtility            - SNMP request timeout: 10.0.10.109 
10:04:08.217 [1-860] {ERROR } Configurator           - SNMP failed to setup Could not enable BSI 
10:04:08.217 [1-860] {ERROR } Configurator           - Configure failed com.ubiquitech.brother.exceptions.Http4xxException

To resolve issue go to MFD administrative interface → Network → Protocol → SNMP → Advanced Settings and:

  • Enable “SNMP v1/v2c read-write access”

  • Configure “Community name” “Set” to “internal”