Skip to main content
Skip table of contents

Integrate Mobile Print for SAFEQ Cloud

In SAFEQ Cloud 3.0, some features are served by the standard EveryonePrint Mobile Print product. Ultimately all major features from the EveryonePrint Mobile Print will be integrated into SAFEQ Cloud directly, but until then, this section outlines the configuration necessary to integrate the “legacy” Y Soft into SAFEQ Cloud.

Added Features

Combining SAFEQ Cloud with EveryonePrint Mobile Print for SAFEQ Cloud include the following additional features:

  1. Printing from mobile devices via Web upload and Email print
  2. Create guest users in SAFEQ Cloud from within the Y Soft Web interface
    1. Y Soft creates a unique numeric username and password for the guest
    2. User accounts are created as internal YSoft SAFEQ Cloud users
    3. Users email address set in YSoft SAFEQ Cloud
    4. Login credentials optionally emailed to user
  3. Automatically create guest user in SAFEQ Cloud when user sends email print job
    1. Y Soft creates a unique numeric username and password for the guest
    2. User accounts are created as internal YSoft SAFEQ Cloud users
    3. Users email address set in YSoft SAFEQ Cloud
    4. Login credentials emailed to user
  4. Ability to automatically delete created guest user accounts in SAFEQ Cloud after a pre-defined time period

Prerequisites and Requirements

  • YSoft SAFEQ Cloud must be minimum version 2.1 and EveryonePrint Mobile Print for SAFEQ Cloud must be minimum version 4.2.6.
  • EveryonePrint Mobile Print can run either on Windows or on Linux.
  • An EveryonePrint Mobile Print installation is required for each account in SAFEQ Cloud (EveryonePrint Mobile Print is not multi-tenant)
  • Root access for installation
  • The following libraries/tools are required:
    • CUPS
    • CURL
    • Fontconfig
    • FreeType
    • rsync

**bzip2

  • Relevant firewall ports should be opened. See Ports and Protocols, section Web Administration UI.
  • An API key with full API access needs to be generated in SAFEQ Cloud to use in Y Soft Mobile for SAFEQ Cloud > User Authentication

Install EveryonePrint Mobile Print for SAFEQ Cloud

Install dependencies

Prior to installing Y Soft, install the required dependencies using either yum or zypper, ie

CODE
yum install cups curl fontconfig freetype rsync bzip2

Install Y Soft

Download EveryonePrint Mobile Print for SAFEQ Cloud from the YSoft Partner Portal, and upload to the secondary server where it should be installed, or download directly on the secondary server:

xxxxx is the version number for the latest Y Soft Mobile for SAFEQ Cloud

CODE
wget https://cdn.everyoneprint.com/everyoneprint-for-SAFEQ Cloud-xxxxxxx.tar.bz2

Next extract the compressed file.

CODE
tar -xjf everyoneprint-for-SAFEQ Cloud-xxxxxx.tar.bz2

Next, change to the Y Soft directory and run the install script.

CODE
cd everyoneprint/
./install.sh

The installer script will check for dependencies, create a user and copy files to /opt/everyoneprint. During the installer script, the license agreement is shown. Enter “yes” to accept and continue.

Configuring YSoft SAFEQ Cloud features in Y Soft

The following section covers the configuration screens in Y Soft Admin.

CODE
http://server-address:7290/admin

Configure Authentication

First, configure User Authentication against YSoft SAFEQ Cloud:

  1. Replace account-server-domain with the account domain name of the SAFEQ Cloud account to which this Y Soft should be connected.
  2. Generate an API key with full API access in SAFEQ Cloud for use with EveryonePrint Mobile Print for SAFEQ Cloud
  3. Report the API key in “User Authentication” > “Authentication via YSoft SAFEQ Cloud” >“API key”
  4. Verify the authentication to YSoft SAFEQ Cloud using a username or password of a test user created in YSoft SAFEQ Cloud.

If test authentication fails, an error message will be shown, and error details written to the Y Soft log files.

Add Devices

Go to Admin -> Devices and add the print queues.

Queues in the list starting with eophcp:// are the input and output ports of the SAFEQ Cloud account. Add the input ports for sending jobs from Y Soft legacy to SAFEQ Cloud, and add output ports for releasing jobs using the Y Soft Apps with or without QR codes.

Automatically create accounts for email print

Under Email Authentication, choose how email from unknown senders should be handled, whether unknown senders are guests, and accounts should be created in YSoft SAFEQ Cloud automatically for guests.

In this configuration an account is created in YSoft SAFEQ Cloud for unknown users.

YSoft SAFEQ Cloud Guest User self-sign up via the Web

If Y Soft is installed in an environment where guests should be able to create guest accounts using a Web interface, enable the YSoft SAFEQ Cloud Guest Users Self-Signup feature.

Users created via the Web portal are created in the internal YSoft SAFEQ Cloud users database. If an Active Directory exists, both LDAP and YSoft SAFEQ Cloud users can authenticate.

Automatically delete created guest user accounts

To automatically delete created guest user accounts, specify under User Authentication the time period in minutes after which accounts are deleted. Set to 0 to never automatically delete guest user accounts.

Troubleshooting tips

Create a test accounts using Web form

Even if the feature is not needed, it’s recommended to test the account creation in YSoft SAFEQ Cloud, using the Web based self-sign-up feature, outlined in section 4.2.2, as errors will appear and be written to log immediately.

Once accounts can be created successfully using the Web form, they can also be created from email.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.