Guide for Hardware Administrators
This guide is for administrators who need to control one piece of YSoft hardware device. By YSoft hardware device we mean:
-
YSoft be3D eDee,
-
Dispatcher Paragon Terminal Pro 4 or
-
YSoft SafeQube 2.
The term device is used in the rest of this guide for any of the products
How to rescue flash the device
Rescue flashing is only needed for manufacturing or when the device is broken and the admin wants to clear the device and remove all configuration. For normal OS update see Operation system update section below.
This guide is for operating systems 4.x.x. For flashing older systems contact the Konica Minolta.
Prerequsities
-
USB flash disc
-
micro USB (male) - USB (female) cable (OTG)
Flash preparation steps
-
Download OS files according to the version you want to flash
-
For versions newer than 4.2.0 you need signed_fitimage.rescue, uaos-4.x.x.tar.gz
-
For versions older than 4.2.0 you need files signed_fitimage-rescue, signed_fitimage-rescue.sig, signed_os-ua-devel-4.1.25.tar.gz, signed_os-ua-devel-4.1.25.tar.gz.sig
-
-
Format USB disc to FAT32
-
Copy all files from the step 1 to the flash disc
Now the flash disc is ready for flashing. If you want to customize the flash you can add additional apps or configuration.
Adding apps to the flash
-
Download .tar.gz install file of the app
-
Copy this file to the app/ directory on the flash disc
Flashing
-
Insert the flash drive into the USB port (using OTG cable).
-
Turn on device.
-
The device will automatically erase old OS and install a new one. The process takes few minutes.
-
When message "Unplug flashdisk" is displayed, unplug the flash drive. The device will reboot itself.
-
After the new system boots, device will:
-
Apply DB patch and init the database to initial state
-
Communicate certificate with the CA (if mTLS is enabled and there was pairing-key in the customization file)
-
Install apps that were copied to the device from the flash drive.
-
After that the device is ready to to use. It will display IP address on the screen and admin could login to the device using one of the methods listed below.
How to login
There are two ways how to control the device:
-
A management console accessible over SSH. The management console is a command line utility, which allows administrators to configure the devices.
-
All available commands can be listed in the console by command 'help '. More more specific help for particular command will be displayed after typing ' <command> --help '.
-
The console has autocomplete function - press the [Tab ↹] key for the console to show you available commands in the current context or automatically complete the current command.
-
The command history can be browsed by up and down keys.
-
The management console session can be terminated by the ' exit ' command.
-
To clear the screen use ' clear '.
-
-
A management web interface which allows:
-
Browsing and exporting log files.
-
Update and reboot of OS.
-
Installation and uninstallation of applications.
-
Starting, stopping, restarting and configuring of applications.
-
Most common device configuration (network, timezones, NTP, Infrastructure servers (IMS)).
-
Credentials
-
Username: manager
-
Default password: oCfpB112g5bZpOcywAp7
The credentials are the same for both the management console and the management web. If you change your password in one of them then the other will accept only the new password.
The password is the same for all devices. so it is highly recommended to change it. See How to change manager password .
How to change manager password
The new password has to have at least 6 characters.
How to reboot the device
Rebooting the device is possible only from management console.
Connection to Dispatcher Paragon Infrastructure Service (IMS)
The Dispatcher Paragon Infrastructure Service is part of Dispatcher Paragon Management Service and allows to control groups of YSoft Hardware devices. Device is usually connected to the IMS during installation or deployment steps. Once the device is connected to IMS, it can download OS images, applications, or configuration from there.
The server connection timeout cannot be set from the web interface.
Operating system update
Applications
The YSoft hardware device is delivered with pre-installed applications according its type.
Configuring application
Controlling applications
Application update
It is not possible to update the application in one step. The update procedure consists of application package upload, uninstalling or stopping the old application, and then installing the new application. The data and configuration are shared by different versions of the same application.
Installing application with IMS connection
Installing application without IMS connection
Management console - Without IMS connection
Management web - Without IMS connection
The application installation package is deleted after successful installation.
Uninstalling applications
Other configuration
Networking
Management console - Networking
Time
To simplify international shipping, the device doesn't have a battery to backup time information while it is powered down. The time right after start may not be accurate and will be synchronized with NTP server at the earliest possible time according to timezone and NTP server settings.
Services control
Management console - Service control
Management web - Service control - only for OS version 4.4 and higher.