Before installation

1	Make sure that all steps from Install Embedded Terminals are carried out before the installation.
2	Configure the device. For more information, see Installing YSoft SafeQ Embedded Terminal for Konica Minolta OpenAPI (applicable also for Olivetti devices).

Add a device with terminal to YSoft SafeQ

1	Log in to the Web administration, use account authorized to manage the system.
2	Open Devices > Printers from the menu.
3	Click the Items button in the top-right corner of the window (as illustrated on the picture below). Choose to add device manually or using a template. This guide continues with manual steps, however you can find more details about using device templates in the Device Templates chapter.
4	On the Basic tab, enter necessary details to identify a device. Please note that Name and IP address are mandatory and must be unique in case of one ORS server. Here is a list of all available options for each device. Name - name your device. The name will be used to identify the device in YSoft SafeQ. Tip: Make sure to call all devices in a similar manner (e.g. model number) for easier troubleshooting. Description - you can specify further details to recognize the device in the system. Location - use this option if you want to describe exact placement of the device. Group - this option defines in which group or ORS server will the device be placed. Choose from existing groups or ORS servers. Cost center - device may belong to a particular cost center. Choose from existing cost centers. IP address - mandatory configuration. IP address must be unique within a group or the ORS server. You can also use domain name instead of IP adress. Page tracking mechanism - configuration defines the type of accounting to be used. Accounting driver - this option can be used with external terminals and online accounting. With embedded terminals, you can use accounting driver to collect device counters (see Tools - Counter reports for more details).

5

Continue to the Terminal tab, select the Embedded terminal option at the top. More configuration options will be displayed. Once you click Save device installation will begin.

- Vendor
  - Select Olivetti from the list.
  - (Advanced only) Administrator login – this feature is described in Administrator login and password
  - (Advanced only) Administrator password – this feature is described in Administrator login and password
  - (Advanced only) Delete jobs after printing – enables / disables delete after print feature. For more details please see: Delete jobs after printing
- Authentication
  Enable this option if you want the users to authenticate before accessing the device. Note that this may affect also other features.
  - Method – Select the authentication method.
- - (Advanced only) Mode – keep the To device option. Users must authenticate to unlock the device and access any of the features.
  - (Advanced only) Allow public user – Enable if you want to allow access for the public user.
- Application
  Enable this option if you want to use the YSoft SafeQ interface application. Note that this application may be required by some other features.
  - (Advanced only) Type – Select the type of terminal to install:
    - Native – Application will use native Konica Minolta look and feel.
    - Browser – Application will use browser-based terminal with YSoft SafeQ interface.
- - (Advanced only) Job list folders – Select which folders should be displayed to the users.
- Scan
  Enable this option if you want to enable YSoft SafeQ scanning features.
- Accounting
  Enable this option if you want to enable native accounting.
- Payments
  Enable this option if you want to use Payment System with this device. When enabled, users with money accounts will be charged for print, copy and scan activity according to the appropriate price list.
  NOTE: It is recommended to set Print job parser at least to the option "Render jobs as low resolution (36 DPI) images" to enhance user experience and to minimize credit overdrafts.

NOTE:

Some options are available for editting only in the Advanced view. You can choose between Basic and Advanced in the lower left corner. If any Advanced option is changed from its default value it will become editable also in the Basic view until its value is changed again to default.

Installation of ET on older platforms (Thames, Mosel, Donau, GangesM, Amur, Taiga, Citrine series) requires manually entering login details on the Terminal tab.

images/download/attachments/36378971/1.png

6	Direct printing tab allows you to specify direct queue(s) which enable the device to receive jobs without the need for user to authenticate at the terminal (note: print job is still authorized in YSoft SafeQ). In order to add a direct queue, click the Add queue button in the top right corner and specify its name. The direct queue name must be unique in the entire system. For each direct queue, you can enable or disable deleting the print jobs after being printed out (released at the printer) by choosing the option Delete after printing. More information about deleting jobs after print is available at Delete jobs after printing.
7	Navigate to the Advanced tab, which allows you to specify additional optional configuration. Equipment number - specify unique identifier for each device. Equipment number remains the same even if the device name or IP address is changed. Maintenance contract number - typically used to identify specific contract linked to the device. Contact person - use this value to specify person responsible for the device (in case of failure, errors, maintenance, etc.) Scan jobs default addressee - this option is used with Terminal Professional and therefore does not apply to installation of Terminal Embedded. Printer type - this is a custom field which can be used with printer type definition (located in Devices > Tools > Printer types menu). Backend - option refers to network protocol used for communication with the device and used for printing at the device. After selecting another printing backend, use the wrench icon to automatically adjust the Port number. Otherwise, you will need to change it manually. The following network protocols are available: IPP - provides a standard network protocol for remote printing as well as for managing print jobs, media size, resolution, etc. IPPSSL - basic IPP with job encryption over SSL. LPR - general TCP/IP utility that is used to send print jobs from clients to print servers. LPR (PJL Copies) - basic LPR extended with PJL method for switching printer languages at the job level. TCP/IP Raw - TCP/IP with raw socket that allows access to the underlying transport provider. TCP/IP Raw NoMap - same as TCP/IP Raw, but with NoMap function. Port - port number that device uses for communication. This option depends on the selected print backend. Print job encoding - encoding type used by the device. Encoding is defined by print driver used by the users at the time of creating print job. It can affect job accounting for users with diacritics in the login name. Default value is UTF-8. Online accounting / Offline print accounting / Offline copy accounting - select to enable particular accounting method (this is an optional configuration). Alert messages encoding - configures encoding of messages created by the device.
8	The SNMP tab allows configuration of SNMP v2 and SNMP v3 used with the device. SNMP v2 SNMP read-only community for remotely accessing the device states. SNMP read-write community for remotely reading and writing to device properties. SNMP v3 Username Context name Authentication algorithm Authentication password Privacy algorithm Privacy password
9	Prices tab configures the costs of using device features. Configured prices are used for accounting print, copy and scan jobs performed at the device. Prices are defined in the assigned price list. For more information about job accounting see Price list and Advanced Detail Accounting.
10	Tags tab enables different print languages or user tags for the device. All print languages are enabled by default. This configuration must match tags for each job (see detailed job information). Check how to use System and User tags.
11	Click Save device button. After confirmation, the device will be automatically reinstalled with updated configuration and embedded terminal.
12	The embedded terminal is being installed. New popup with installation progress will appear. You can close the window with device settings. For more details about the installation, click the small double arrow icon .
13	After installation is completed, message "Installation finished successfully" is displayed. Should the installation process encounter any issues, please open the installation details with more information about the error.
14	If you need to change the settings of an already installed device or terminal, click the edit icon or double-click the device from the list. Please note, that some settings may require terminal reinstallation, which will occur automatically after saving the changes.

Olivetti specific settings

System settings

Additional features are available via System settings. Some of these settings may require reinstallation of the terminal or reboot of YSoft SafeQ server.

1	Devices have option to configure myPanel screen with desired application icons only. The idea is to display only the most common options used in user's daily routine. To configure this screen Go to System > System settings and set shortcuts-references to following values: sq, copy, scan, storage This configuration de fines ordered list of applications displayed on the embedded terminal shortcut panel. Possible options are: sq, sqprint, sqscan, copy, scan, storage, imgpanel, browser.
2	To enable legacy USB readers conversion set usb-card-reader-conversion property to enabled. If enabled, card numbers from legacy card readers on Olivetti are converted to follow standard string format of card numbers.
3	To enable shortcut displaying in main menu set initial-screen property to shortcuts. Defines what MFP application is displayed to the user when they logs into the terminal. Possible options are: shortcuts, sq, sqprint, sqscan, copy, scan, storage, imgpanel, browser, ecopyscan, scanflow, datapoint.
4	In case only Reporting or Credit and Billing modules are included in the license without Authentication, the embedded terminal can be installed only with Accounting or Payment features. In such case a generic user needs to exist in SafeQ to whom all the data from MFP will be reported. The login button on the MFP authentication screen then authenticates every user as this generic user (see the picture bellow). By default, you need to create user "General" in SafeQ. In case it is not possible to use such user, you can change generic user name in TerminalServer.exe.config file where the configuration configuration property 'KMPublicUserLogin' needs to be added. Example: <add key="KMPublicUserLogin" value="generic" /> the corresponding username has to be also defined in the SafeQ web administration please note that it is not allowed to use strings 'public', 'admin' and 'boxadmin'