These quick guides are aimed at EBA Next Administrators who already have some experience with similar systems or are EBA Next Enterprise users.
More detailed instructions can be found further down in the software by clicking on the Help button.
Implementation Guides
Overview
This quick guide shows you how to implement EBA Next system into an organization.
Prerequisites
- Contract agreement for EBA Next
- Users and workplaces
- Workflow for processes to be implemented
- Server
- SQL database
- SSL and Qualified Certificates
Implementation of EBA Next in steps
- Contract agreement for EBA Next
- Prepare server and database
- Create test environment for EBA Next
- Install EBA Next in test environment
- Define Document models and metadata
- Setup organization schema and users in EBA Next
- Enter workflow rules
- Extensive testing
- Transfer settings to production environment
- Start using EBA Next in production.
Install Guides
Overview
This quick guide shows how to install EBA Next Server on Windows server.
Same procedure is for updating the EBA Next Server.
Prerequisites
- Windows server 2016 or newer.
- EBA Next NEXT msi installer.
- Database
Notice
Always install into the testing environment! Do not install or update straight into production before extensive checkup and testing on your local test environment.
EBA Next Server Installation
Obtain installer from your licensed EBA partner.
- Open the .msi installer for EBA Next Server.
- Follow the installation instructions to install the EBA Next Server.
- When installed, click Finish.
Video
See animation below for demonstration of installing the EBA Next server:
Overview
This quick guide shows how to install EBA Next System on Linux server.
Prerequisites
- Linux CentOS 9 server
- EBA Next NEXT rpm installer
- User with sudo permissions
- Internet connectivity
- Updated packages
1. Install required packages
Perform all actions with sudo or as root.
Run following commands to prepare environment to install EBA Next:
-
Enable CRB
dnf config-manager --set-enabled crb
-
Install EPEL
dnf -y install epel-release epel-next-release
-
Enable OpenSSL Legacy policy
update-crypto-policies --set LEGACY
-
Install text editor and wget
dnf -y install vim wget
2. Install Application Services
-
Download installer:
wget path-to-installer
-
Run installer:
dnf -y install ebadmsnextserver-X.X.X-XXXXX.x86_64.rpm
-
Update dynamic linker cache
Run command:
ldconfig
-
Install services, run for each service needed:
/usr/local/bin/ebaservice -i
Use -u operator for uninstall.
Example:
/usr/local/bin/ebamobileservice -i
- ebamobileservice - serves as user GUI, exchanges all data to and from DB, connection to DB via Next Admin.
- ebasqlservice - counts documents and marks them read/unread.
- ebamessengerservice - sends notifications, used for sending documents from system
- ebaschedulersettings - triggers send/receive on interval, sends licenses data, runs scripts in background
- ebawsservice - runs Web Service server for integrations
-
Reload Daemon
Execute command:
systemctl daemon-reload
-
Enable services
systemctl enable ebamobileservice
Do the same for all services needed.
3. Connect Services to Database
Database parameters are stored in ebaservices.ini file.
Open file with text editor and set parameters:
vi /etc/ebadmsnext/ebaservices.ini
Opening firewall ports
-
Open port on firewall for EBA services:
Example for firewalld:
firewall-cmd --permanent --add-port=433/tcp
Restart firewall
sudo firewall-cmd --reload
See all open ports:
sudo firewall-cmd --list-all
Check if port is opened or content is served:
telnet 127.0.0.1 433
curl -i http://127.0.0.1:433
Set SSL certificate for Mobile Service
Run command:
export QT_QPA_PLATFORM=offscreen
You can add this command to your bash profile for later use.
To import SSL certificate run command:
/usr/local/bin/ebamobileservice -installhttpscert /path/to/ssl_cert
Enter certificate’s password.
Config files & log files
Config files are stored in folder /etc/ebadmsnext
Log files are stored in folder /ebatrafic/
Troubleshooting
-
Use eps script to reveal running EBA services:
eps
OR locate installed services:
locate ebasettingsservice
-
Check status of service:
systemctl status ebaservice-name
Example:
systemctl status ebamobileservice
-
Check journalctl for detailed systemd log:
sudo journalctl -xe
-
Restart service
systemctl stop ebaservice-name
Examples:
systemctl stop ebasqlqueueservice ; systemctl start ebasqlqueueservice systemctl stop ebamessengerservice; systemctl start ebamessengerservice systemctl stop ebaschedulerservice; systemctl start ebaschedulerservice systemctl stop ebafirewallservice ; systemctl start ebafirewallservice systemctl stop ebasettingsservice ; systemctl start ebasettingsservice systemctl stop ebamobileservice ; systemctl start ebamobileservice systemctl stop ebawsservice ; systemctl start ebawsservice systemctl stop ebaexchangeservice ; systemctl start ebaexchangeservice
-
Enable Debug log for QT
sudo sed -E -i "s/(\*\.debug\=)false/\1true/" /usr/share/qt5/qtlogging.ini
-
Oracle drivers
Don’t forget to install Oracle drivers if you need to connect to Oracle DB.
wget https://download.eba.si/nightly/linux/centos9/oracle-instantclient-basic-21.8.0.0.0-1.el8.x86_64.rpm
-
Download log file from CMD to your device
Zip log file:
tar cvzf ~/logname.tar.gz log_file
Download zipped log file to your device:
scp eba@hostname:logname.tar.gz logname.tar.gz
-
Error while executing DNF update:
System requires libQt5Sql.so.5(Qt_5.15.3_PRIVATE_API)(64bit), but none of the providers can be installed
Run update with –allowersing option:
sudo dnf update --allowerasing
Overview
This quick guide shows how to install EBA Next Server on Windows Subsystem for Linux.
Prerequisites
- Windows server 2016 or newer.
- EBA Next NEXT msi installer.
Notice
Always install into the testing environment! Do not install or update straight into production before extensive checkup and testing on your local test environment.
Install Ubuntu into WSL
-
Open the start menu search and look for Windows features on or off.
-
Check Virtual Machine Platform and Windows Subsystem for Linux.
-
The computer will restart after clicking OK.
-
In File Explorer a new folder Linux has been created.
-
Open Command Prompt with administrative privileges and type
wsl
. We can see there aren’t any distributions installed for WSL yet. -
Type
wsl --update
do install wsl on your computer. -
Type
wsl --list --online
to see valid distributions that can be installed. The latest one is recommended. -
Type
wsl --install -d
and name of distribution. For example we use Ubuntu 24.04 distro:wsl --install -d Ubuntu-24.04
. -
The WSL is ready to use.
EBA Next Server Installation
Obtain installer from your licensed EBA partner.
- Navigate to the directory where you want to download EBA Next.
- Follow the Next Server - Linux Install Guide to proceed.
Overview
This quick guide shows how to install EBA Next Edge Apps on Windows device.
The EBA Next Edge Apps are a suite of applications designed to extend the capabilities of the EBA Document Management System. These applications enhance functionality, improve user experience, and provide specialized tools tailored to specific needs.
Prerequisites
- Windows 10 or newer.
- EBA Next NEXT Edge Apps msi installer.
Install guide
-
Open the .msi installer for EBA Next Edge App.
-
Click Next.
-
Select the following features to install:
- Core files: essential files for the functionality, integration and performance of the App within EBA Next.
- EBA Next Connector: Connection to scanner, OCR on documents, modifying original documents, Windows store certificates
- EBA Next Admin: Administrator tool for setting the system for use.
- EBA Next Developer: tool for developers for building scripts and reports. Includes tools for administrators: SQL browser and comspy.
- EBA Next Printer: a virtual printer - user can directly “print” into the EBA Next. No need to physically print and then scan the document to the system.
- EBA Next Legacy: COM interface.
-
Follow the instructions of the installation wizard.
-
When everything is installed, click Finish.
video:
Overview
This quick guide shows how to prepare a SQL database for EBA Next system.
Supported database types:
- Postgres SQL 12 or newer.
- MS SQL 2016 or newer.
- Oracle 12 or newer.
Common procedures for all database types
- SQL user to connect to database with r/w rights. Preferably role database owner.
- Enough resources regarding users number. See system requirements.
- Enough disk space to write content. See system requirements.
- Allow ebamobliservice to connect to sql server
Create tables for EBA Next
- Make sure you have prepared database for use
- Make sure you have entered database connection details into ebaservices.ini
- Create tables:
- On Windows:
- Navigate to C:\Program Files\EBA Next Server\bin
- Run command in CMD:
ebamobile.exe -updatedb
- On Linux:
- Run command:
/usr/local/bin/ebamobile -updatedb
- Run command:
- On Windows:
Configure MS SQL database
-
Create MS SQL user using SQL authentication and not Windows. Set default language for this user to English.
-
Set Collation on: “Language_CI_AS”. Collation must have CI – character insensitive.
-
Preventing deadlocks: When new database is created, before using it execute SQL queries as database administrator (sa):
ALTER DATABASE MyDatabase SET ALLOW_SNAPSHOT_ISOLATION ON ALTER DATABASE MyDatabase SET READ_COMMITTED_SNAPSHOT ON
Replace “MyDatabase” with actual EBA Next database name.
SQL queries must not be executed simultaneously(execute one and when its done start the other one), and must be executed on each database in case you are using more databases for EBA Next.
-
Enable document locking: To enable the document locking two SQL queries must be executed, and must not be executed simultaneously:
USE master GRANT VIEW SERVER STATE TO SqlUser
Replace “SqlUser” with actual sql user which uses EBA Next database. Execute SQL queries as a user with access to master database (sa).
-
Prevent large log files
MS SQL server by default records very detailed data in the log files. That means that log files become large and occupy a lot of disc space. To avoid this situation set database log option to “simple”. This can also be done by executing SQL query:
ALTER DATABASE YourDatabaseName SET RECOVERY SIMPLE
Replace “YourDatabaseName” with actual database name for EBA Next.
-
Install FTS module.
Configure Oracle SQL database
-
Request Oracle drivers from Licensed partner.
-
Extract drivers into bin subfolder of EBA Next Edge Apps installation. Do the same for EBA application services, extract drivers into bin subfolder.
-
In ebaservices.ini set connection to database copying whole connection string from tnsnames.ora file.
-
Execute following queries on instance:
GRANT SELECT ON VIEW $V_SESSION; GRANT EXECUTE ON SYS.DBMS_CRYPTO TO <EBA_DB_USER>; GRANT CREATE SEQUENCE TO <EBA_DB_USER>;
You need to extract drivers for every client, who wants to connect to Oracle database.
Overview
This quick guide shows how to setup EBA Next services for use.
Each service has it own settings set by configuration (.ini) file.
An ‘.ini’ files are configuration files that define various settings for different services. Each of these ‘.ini’ files contains parameters and options that control the behavior of the associated service. Here’s a breakdown of what each of these services represents.
Configuration files location:
- Windows: C:\Programdata\EBADMSNext
- Linux: /etc/ebadmsnext/
Note: Always open ini files in text editor with elevated (admin) rights.
Prerequisites
- Installed EBA Next Server
- SQL database prepared - PostgreSQL, MS SQL or Oracle.
- SSL certificate
Services descriptions
- ebamobileservice - serves as user GUI, exchanges all data to and from DB, connection to DB via Next Edge Apps.
- ebasqlservice - counts documents and marks them read/unread.
- ebamessengerservice - notifications and sending documents via internal mail server
- ebaschedulersettings - triggers send/receive on interval, sends licenses data, runs scheduled scripts or tasks in background
- ebawsservice - runs Web Service server for API integrations
1. Setup Database Connection
Connection between services and SQL database is set in ebaservices.ini file.
NOTE: Open text editor with admin privileges to edit and save settings.
- dbType: database type (postgresql, mysql, oracle, virga).
- dbName: name of your database.
- host: IP of your database.
- port: port where connection with database is.
- username: SQL user username
- password: SQL user’s password
Note: after the first successful connection, the password is encrypted and is no longer visible.
1.2 Example of .ini file
Here is the demonstration of an ebaservices.ini file:
1.3 Demonstrating video
Here is the video showing how to access ebaservices.ini on Windows system.
2. Setup EBA Mobile Service
EBA Mobile Service is essential service to setup the system and launch user GUI. It is possible to launch the service in HTTP or HTTPS mode but we recommend using HTTPS. You can however use webserver or proxy server to put ebamobileservice under SSL connection.
- Open and edit settings. Uncomment the lines to apply the settings.
- Required settings are:
- serverName - enter server’s hotname or IP
- servicePort - define local port for service to run
- mobileHttpPort or mobileHttpsPort - define external port for connections to service
- sslCertificate - enter id of SSL certificate
- proxyPassword - generate with ebaautomation4
- Import SSL certificate. SSL certificate is necessary for ebamobileservice to communicate with DB and Edge Apps via encrypted connection.
- On Windows:
- Run CMD or Powershell as admin.
- Go to directory C:\Program Files\EBA Next Server\bin.
- Run
ebamobileservice.exe -installhttpscert "path-to-cert"
. - Enter certificate’s password.
- Copy displayed cert ID and enter it under sslCertificate parameter in ebamobileservice.ini.
- Start ebamobileservice with Services.msc app.
- On Linux:
- Run command:
export QT_QPA_PLATFORM=offscreen
- To import SSL certificate run command:
/usr/local/bin/ebamobileservice -installhttpscert /path/to/ssl_cert
- Copy displayed cert ID and enter it under sslCertificate parameter in ebamobileservice.ini.
- Start ebamobileservice with systemctl start command.
- Run command:
- On Windows:
- Generate proxy password with ebaautomation4:
- On Windows:
- Run CMD or Powershell as admin.
- Go to directory C:\Program Files\EBA Next Server\bin.
- Run command
ebaautomation4.exe -proxypassword reset
- Copy displayed password for later use.
- Password is written into ebamobileservice.ini automatically.
- On Linux:
- Run command
/usr/local/bin/ebaautomation4 -proxypassword reset
- Copy displayed password for later use.
- Password is written into ebamobileservice.ini automatically.
- Run command
- On Windows:
3. Setup other EBA services
All other services are setup in similar fashion.
ServerName and serverPort settings are always required.
4. Setup Automation
Automation is an application triggered by Scheduler service or its tasks. There are several settings that can be set in automation.ini file:
This .ini settings file configures various aspects of an automation system related to EBA services. Here’s a brief breakdown:
- Path Formatting: Paths use forward slashes (/), and backslashes () indicate line continuation.
- Database Configuration: It includes another configuration file, ebaservices.ini, to read database connection parameters.
- Logging: Specifies the log file path and log level. (Debug or Release)
- Server Connection: Sets the endpoint URL for connecting to the EBA server, with optional timeout settings for connection, sending, and receiving data. Endpoint can be either production or test.
- Report Settings: Defines a directory for reports and limits the number of saved reports to 10, with older reports being deleted.
- File Integration: Lists directories for input, output, temporary, and error files.
- Process Commands: Allows defining commands for pre- and post-processing data
- Library Path: Optionally points to a directory for required SQL drivers.
- Backup Settings: Defines a backup directory, file naming convention, and retention settings.
- Encoding: Specifies the encoding used for input and output, with options for various character encodings like Latin1, UTF-8, and CP1250.
Overview
EBA Next administrator is part of EBA Next Edge Apps installation package and is used for setting up EBA Next system.
Prerequisites
- EBA Next server installed
- ebamobileservice up and running
- EBA Next NEXT Edge Apps installer.
- Proxy connection details.
Setup connection to EBA Admin
-
Open EBA Next Admin.
-
Click on hamburger menu in upper right corner and select “Settings”
-
Add new connection and name it.
-
Click on connection and enter details:
- URL server address: Enter URL and port of server where ebamobileservice runs - format hostname:port.
- Password: Enter Proxy password that was generated with ebaautomation4.
- Test connection to see if you have connectivity to ebamobileservice.
- Accept SSL certificate that was used during setup.
-
After successfully entering connection details restart EBA Next Admin.
-
Now you can login to EBA Next system.
Video instructions
Overview
Each EBA Next system must be registered as company, regardless if is it test or production environment.
Prerequisites
- EBA Next server installed
- ebamobileservice up and running
- EBA Next NEXT Edge Apps msi installer.
- Connection to ebamobileservice in EBA Next Admin
- Qualified certificate in pfx or p12 format - Supreme Administrator
- Endpoint setup in EBA Admin (%programdata%/EBADMSNext/init.ini) - production or test
How to register a company in EBA Next Admin
- Setup connection in EBA Next Admin.
- Select connection to register.
- Click on “Company registration” link below text.
- Import qualified certificate for Supreme Administrator under File>Import Certificate.
- Enter registration details for company.
- Sign and send registration form.
- Send notification about registration to support@ebadms.com
- When confirmed you can perform first login.
Organization and Users Setup
Overview
This quick guide shows how to install EBA Next Edge Apps on Windows device.
Prerequisites
- Windows 10 newer.
- EBA Next NEXT Edge Apps msi installer.
- Proxy connection details.
- First step
- Second step
Overview
This quick guide shows how to install EBA Next Edge Apps on Windows device.
Prerequisites
- Windows 10 newer.
- EBA Next NEXT Edge Apps msi installer.
- Proxy connection details.
- First step
- Second step
Overview
This quick guide shows how to install EBA Next Edge Apps on Windows device.
Prerequisites
- Windows 10 newer.
- EBA Next NEXT Edge Apps msi installer.
- Proxy connection details.
- First step
- Second step
Document Models Setup
Overview
This quick guide shows how to install EBA Next Edge Apps on Windows device.
Prerequisites
- Windows 10 newer.
- EBA Next NEXT Edge Apps msi installer.
- Proxy connection details.
- First step
- Second step
Overview
This quick guide shows how to install EBA Next Edge Apps on Windows device.
Prerequisites
- Windows 10 newer.
- EBA Next NEXT Edge Apps msi installer.
- Proxy connection details.
- First step
- Second step
Documents Capture Setup
Overview
This quick guide shows how to install EBA Next Edge Apps on Windows device.
Prerequisites
- Windows 10 newer.
- EBA Next NEXT Edge Apps msi installer.
- Proxy connection details.
- First step
- Second step
Overview
This quick guide shows how to install EBA Next Edge Apps on Windows device.
Prerequisites
- Windows 10 newer.
- EBA Next NEXT Edge Apps msi installer.
- Proxy connection details.
- First step
- Second step
Overview
This quick guide shows how to install EBA Next Edge Apps on Windows device.
Prerequisites
- Windows 10 newer.
- EBA Next NEXT Edge Apps msi installer.
- Proxy connection details.
- First step
- Second step
Documents Share And Signing
Overview
This quick guide shows how to install EBA Next Edge Apps on Windows device.
Prerequisites
- Windows 10 newer.
- EBA Next NEXT Edge Apps msi installer.
- Proxy connection details.
- First step
- Second step
Overview
This quick guide shows how to install EBA Next Edge Apps on Windows device.
Prerequisites
- Windows 10 newer.
- EBA Next NEXT Edge Apps msi installer.
- Proxy connection details.
- First step
- Second step
Documents Exchange Setup
Overview
This quick guide shows how to install EBA Next Edge Apps on Windows device.
Prerequisites
- Windows 10 newer.
- EBA Next NEXT Edge Apps msi installer.
- Proxy connection details.
- First step
- Second step
Overview
This quick guide shows how to install EBA Next Edge Apps on Windows device.
Prerequisites
- Windows 10 newer.
- EBA Next NEXT Edge Apps msi installer.
- Proxy connection details.
- First step
- Second step