Quick Administration Guide

This document enables you to install YSoft SafeQ quickly and easily and helps you configure the basic settings.

If you require further details, check the full official documentation. The official documentation has clearly defined installation sections and configuration options are discussed in a greater level of detail.

What You Get When You Download YSoft SafeQ

When you download the YSoft SafeQ package, you get everything you need to install the system. The package also includes important tools and standalone applications that can help you configure and troubleshoot YSoft SafeQ, as well as documentation that provides both basic and detailed information about various aspects of the system.

Installing YSoft SafeQ - Prerequisites

Once you have the YSoft SafeQ installation package, you can begin the installation. However, to make sure your installation is successful, before you begin, consider the following important preliminary requirements:

  • A physical or virtual server must be available, dedicated for the YSoft SafeQ system, that meets the requirements to support YSoft SafeQ functions.

  • All Windows security and optional updates must be installed.

  • MFDs and other printers that will be used with YSoft SafeQ must be configured and connected to the network, and the associated required print drivers and hardware components (for example, terminals or network readers) must be available.

  • If you plan to integrate YSoft SafeQ with a User Domain such as Active Directory, Novell, or OpenLDAP, make sure you have all required information, especially domain controller access/connection information and an FDQN user directory.

  • Make sure you have a valid, new activation key.

    The activation key is hardware-bound and once used, cannot be reused by a different computer.

When you are sure your system meets all the prerequisites, you can begin YSoft SafeQ installation. With the interactive installer, all you need to do is to run the installation file and follow the steps in the installation wizard.

Installing YSoft SafeQ

YSoft SafeQ 6 generally comes bundled in a self-installing package that sets up a YSoft SafeQ server in your environment. The installer provides several installation scenarios that differ from each other depending on what type of server you are installing, and how it fits your solution design or server landscape. Many installer settings are pre-configured to default values that are enough for a typical YSoft SafeQ installation.

  • First Server - includes everything you need to use all YSoft SafeQ core features

  • Site Server - the server dedicated to the printing and scanning features on a site connected to management server

  • Management Server cluster node - multiple management servers can together form a cluster

Each scenario has some optional features that can be chosen to enlarge your YSoft SafeQ feature set but are not vital for YSoft SafeQ core features like printing and scanning to work.

  • YSoft SafeQ Payment System

  • YSoft SafeQ Mobile Print Server

  • Enable the spooling of jobs on this server

YSoft SafeQ comes with a bundled PostgreSQL database that is pre-configured for optimal performance and security. External PostgreSQL and MSSQL database backends can also be used.

Installation Procedure

The installer provides a straightforward wizard-like user interface that guides you through the installation process. During the sequence of installation pages, you will be asked about the various setup aspects of your YSoft SafeQ solution.

Choose Language

The installer is localized to a wide range of languages. Select the language you wish the installer to communicate with you in.

Welcome Page

Click NEXT to continue

License Agreement

Click I Agree to continue.

Server Environment

  • The option First server will guide you through the installation process of Management Server. This is the foundation on which every YSoft SafeQ 6 solution is based. For small or mid-size installations, you probably will not need any additional servers. This guide will show you, step by step, how to install this scenario.

  • The option Other servers offers the deployment of additional servers that can connect to Management Server and provide features that large or enterprise environments can benefit from.

Optional Features

Install payment system features - If ticked, YSoft SafeQ Payment System will be installed.

Install mobile print server features - If ticked, Mobile Print Server will be installed.

Install spooling features - If ticked, YSoft SafeQ will start spooling jobs on this server.

Additional setup needed

Both YSoft SafeQ Mobile Print Server and YSoft SafeQ Payment System will need to finish their integration by visiting the YSoft SafeQ management interface and creating a setup suitable for your solution.

Install spooling features

Due to a temporary limitation in YSoft SafeQ 6, only the spooling of jobs on the server is supported. Due to this fact, the value of the spooling features checkbox is regarded as always being ticked.

Pre-installation Check

The pre-installation check performs a series of tests to verify if the server environment is suitable for the installation. The installer will display a warning or error depending on your environment's status.

  • Administrator access for the installer process

  • Windows OS version (server edition)

  • The availability of a .NET framework 4.8 or higher

  • Essential network ports are checked if they are available

Every test made can have three outcomes and is displayed in the corresponding column.

OK - column showing all passed tests

Warnings - column displays events that are important but not essential for installation success. Typically, problems were detected, but the installer was able to resolve them.

Errors - something that is essential for YSoft SafeQ to work is missing, and the installer was not able to compensate for it.

The user can continue the installation even if an error occurs, but the installation will probably fail later on, or YSoft SafeQ will not work properly.

Installation Folder Path

Provide the location where you want your YSoft SafeQ installed.

  • There has to be at least 10 GB of free space on your disk drive.

  • The folder path must not contain spaces and characters from this set: ~`!@#$%^&*()[]{}?§!=

Database Configuration

Choose the database backend you want to use with your YSoft SafeQ installation. The recommended option is to use an embedded PostgreSQL that is pre-configured for optimal use with YSoft SafeQ,

Embedded Database Configuration

Provide a password that will be used to access the embedded PostgreSQL database. You can provide your own or generate a password using the corresponding button.

Other Properties

Management Servers use unique GUIDs. Provide your own GUID or use the auto-generated value.

If your server has multiple network interfaces, you can select the network interface from the drop-down menu that will be used by YSoft SafeQ.

Summary

An installation summary where the user can double check all the installation properties. After clicking Install, the installation process begins.

Installation Progress Page

The installation logs its progress in the form of status messages and the movement of the progress bar.

Installation Finished

The installer informs you about the successful completion of the installation process. Click Finish to exit safely.

Logging Into YSoft SafeQ

To use YSoft SafeQ, log into the YSoft SafeQ interface interface. The default login credentials are:

  • user: admin

  • password: admin

If CAPTCHA protection is enabled in YSoft SafeQ 6, after some (configurable) number of unsuccessful login attempts, users have to fill an additional input which is a text from an image.

images/download/attachments/160483327/image2022-1-28_15-11-13.png

Image refresh

If the user cannot recognize the image, it can be changed by clicking the refresh icon in the corner of the image.

Configuration

To enable CAPTCHA protection, navigate to System > Configuration and set the level of setting to ADVANCED. Search for the Require CAPTCHA on login form setting and set it to Enabled.
The number of attempts to trigger the CAPTCHA can be configured in the Maximum number of failed login attempts setting. Failed login attempts are counted for a tenant and username pair. The expiration timeout of the counter is one hour.


Activating YSoft SafeQ

After installation is complete, YSoft SafeQ must be activated. YSoft SafeQ supports two types of activation: online and offline. The system requires an activation key, which is part of the license agreement you received after the product was purchased.

To activate YSoft SafeQ using the online activation method, log into the YSoft SafeQ management interface as administrator and on the Dashboard, enter the activation key. YSoft SafeQ automatically contacts the Partner Portal and downloads the license.

If the YSoft SafeQ server is not connected to the Internet, please perform offline activation.

You Are Now Ready

After you log in, the YSoft SafeQ Dashboard page opens. A list of widgets is available that you can use to get information about various YSoft SafeQ functions.

The most important first step is to use the Welcome to YSoft SafeQ widget. This widget shows you the steps you need to perform before the YSoft SafeQ system is ready to use.

images/download/thumbnails/160480249/welcome_to_SafeQ.png

Adding Users

If you use Active Directory and want to integrate YSoft SafeQ with your AD domain, follow these steps. Otherwise, add users manually.

The following steps will guide you through the default Active Directory integration setup.

  1. Open the LDAP integration wizard through the Welcome to YSoft SafeQ widget on the main screen. You can access different levels of detail (Basic, Advanced, and Expert). Particular sections are covered under the tabs:

    • Status

    • Settings

    • Test

    • Logs

    The settings for LDAP replication can also be found on the interface interface: System > LDAP Integration

    images/download/attachments/160483763/image2016-7-15_12_59_19.png

  2. Open the Connection section in Settings. On the Connection tab, you can configure the integration setting with LDAP. Available settings are:

    • LDAP server type (AD, NDS, OpenLDAP)

    • Load users on demand - This type of replication mode is sometimes referred to as semi-online. When enabled, users are created only during job reception or when logging into the terminal.

      • Full and differential replication updates only users already registered within YSoft SafeQ.

      • Replication of roles and cost centers is unaffected.

      When the <removeCardsInDiffLdapReplication> configuration option is enabled, users' cards removed from LDAP are not removed from the YSoft SafeQ database when synchronization is run.

    • URL of LDAP server

    • Searched LDAP subtree

    • Service account

      There is the possibility to use either an anonymous account or an authorized account to log into the LDAP server to search for users. The selected account must have at least read access to view the users and their attributes.

      Please ask your domain administrator for this information.

  3. Open the Scheduling section. The Scheduling tab gives you the possibility to schedule the run of replication. All settings are revealed after you check the Enable regular synchronizations checkbox. The options are:

    • Start full replication - Here you can select the days and times for full replication by clicking checkboxes.

    • Start differential replication - Here you can specify the hours or time interval from the last replication to start differential replication. This type of replication will start every day.

    You have to restart YSoft SafeQ Management Server to apply these changes.

  4. Run the synchronization using the Sync now button.

  5. Check the result. The Status tab only contains information about the last synchronization with the LDAP server (date, duration, and result) and the count of added/updated/deleted users, cost centers, and roles. If an error occurs, the error is displayed here.

Adding a Printer

Many YSoft SafeQ features require a terminal that controls the associated printer/MFD. For information about installing and configuring terminals, see the section Embedded Terminals installation and configuration in the documentation.

Adding a Printer to YSoft SafeQ

After installing YSoft SafeQ, add a printer to the YSoft SafeQ system as follows:

  1. In the YSoft SafeQ management interface, select Devices from the menu.

  2. Select Add device.

  3. Proceed through all the device setup options, and configure the settings according to your needs. (Skip Terminal type unless you want to connect a terminal to the system—a terminal is not required for direct printing.)

  4. In the Direct printing section, enter a unique name for the direct printing queue. We recommend a name like direct-<name of the machine>, for example, direct-printer1.

  5. Click Save changes to save the printer.

Configuring Roles and Access Definitions

Configuring Roles

The last thing you need to do is to set up access rights and/or restrictions. These rights and restrictions are determined by the Roles you define in the YSoft SafeQ system. YSoft SafeQ includes some predefined roles. If you want to create your own role:

  1. In the management interface, select Users > Roles > Add new item.

  2. Each user can be assigned one or more roles. To assign a role to a user, edit the user and assign a role to him or her in the Roles section.

Create an access definition for the new role.

  1. After you create a role, to assign it to users, select Rules > Access definition.
    Click Add new item, then select the desired User role and the Spooler Controller group. It is possible to define these restrictions for All devices in the group or just for one selected device.

  2. To allow or restrict the use of the printers in this group, click the icons below the print, copy, color, fax, and 3D options. A check means that the users the role is assigned to are permitted to perform the operation. A cross means they are not permitted to perform the operation.

    By default, users are permitted to perform all operations. To force black-and-white printing for all users the role is assigned to, change the icon to a cross.

  3. After the settings are complete, click Add.

Basic Troubleshooting

  • YSoft SafeQ installation cannot proceed - Check to make sure the server meets all the prerequisites for YSoft SafeQ installation. If you use the graphical YSoft SafeQ installer, after the pre-installation check is performed, the Warnings and Problems sections provide information about conditions that have not been met.

  • YSoft SafeQ installation fail - If the installation proceeds but fails, look in the <SAFEQ_HOME>\SafeQ6-installation.log to see if you can find the possible cause of the failure. This log file may redirect you to other log files, depending on the root cause of the failure.

  • Activation issues - If you encounter any issues during the activation process (online/offline), first make sure you are using the correct activation code. Both online and offline activation processes tell you exactly where the fault is, so troubleshooting should be easy.

  • A print job sent to the printer was not printed - If you sent a job to YSoft SafeQ, but it did not print, there can be several causes:

1. In the YSoft SafeQ interface interface, go to Reports > Job list and check to see if the job is listed there.

  • If the job is not listed in the Job list, the printer's settings on the Windows workstation may not be correct. Verify that the printer and its port are configured exactly as described in this guide and that the queue to which you sent the print job has been created in YSoft SafeQ.

  • If the job is in the Job list, check the job's details to see why the job did not print.

2. Other causes of this problem could be incorrect printer settings in YSoft SafeQ (IP address, queue name, etc.) or incorrect access settings for the printer. You can usually find these causes in the details about the job in the Job list.


3. If you cannot find the cause of the issue, contact Y Soft Customer Support Services, who will be glad to help you.