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 SAFEQ Cloud users
   3. Users email address set in 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 SAFEQ Cloud users
   3. Users email address set in 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

• 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

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

wget https://cdn.everyoneprint.com/everyoneprint-for-hcp-xxxxxxx.tar.bz2

Next extract the compressed file.

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

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

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 SAFEQ Cloud features in Y Soft

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

http://server-address:7290/admin

Configure Authentication

First, configure User Authentication against 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 SAFEQ Cloud” >“API key”
4. Verify the authentication to SAFEQ Cloud using a username or password of a test user created in 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 SAFEQ Cloud automatically for guests.

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

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 SAFEQ Cloud Guest Users Self-Signup feature.

Users created via the Web portal are created in the internal SAFEQ Cloud users database. If an Active Directory exists, both LDAP and 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 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.