Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This article provides a detailed description of the System Architecture and Technical Requirements for Adonis software.

Table of Contents
minLevel1
maxLevel1
include
outlinefalse
indent
excludeChange Log
typelist
class
printablefalse

Page Properties

Valid From

 

Next Revision Date

 

Change Log

Expand
titleClick to see the change log

Date

 

Overview

Image Removed

Change

From the following product version MSql 2012 Is no longer a supported database.
APM 2023.20 / APP 2023.20

Added online vessel installation architecture
Review and modified system requirements

Updated system requirements

Uploaded document

Overview

Architecture Solution Extended V5.pngImage Added

Main Office / Adonis Cloud

The Adonis HR solution exists out of four systems or applications developed by Adonis.
These are;

  1. The Adonis Personnel Manager (APM),

  2. The Adonis Personnel Portal (APP),

  3. The Adonis Web Recruitment (AWR),

  4. The Adonis Replicator (AR).

The following five network components are required;

  1. Microsoft SQL Database Server

  2. Microsoft IIS

  3. Microsoft File Server

  4. Microsoft Terminal Server

  5. FTP Server / Azure Storage Account with SFTP enabled

Employees, Applicants, Manning-, and Home -offices are accessing the system via the Public Cloud. The employee and applicants use the APP and AWR running on the ISS, the Manning - and the Home-home office using the Microsoft Remote App.

Local Vessel Installation

The

Onshore Crew Portal

sel InstallationThe onboard installation is similar to the Main Office. The difference is that ;
The the Terminal Service Server is redundant. If the Adonis Personnel Manager is needed onboard, it can be started directly from a shared drive.
When installed onboard, the Adonis Personnel Portal functions as the Adonis Crew Portal and supports the Adonis Time Clock and Adonis Gangway Access Control.

Online Vessel Installation

Suppose the vessel operates in an area covered by a stable broadband connection with a low response time. In that case, a vessel installation is redundant, and the vessel connects to the application using the Online Vessel Installation Configuration. Accessing the application via the Public Cloud.
The system supports vessels using a Local Vessel Installation and other vessels using the Online Vessel Installation. However, a vessel can't use both configurations.

Database Server MSSQL

:

Adonis supports the following versions of MSSQL: 2022, 2019, 2017, 2016,2014, and 2012
For the host installation, we recommend going for a full version of MSSQL, but for the lesser installations on board, it will be enough to install the express versions. Express versions are free to use but have a restriction in database size and the amount of memory they can access. (Important It is important to remember when you replicate scanned documents to the vessels).
If a site is close to limiting what is supported by the express version, it is very easy effortless to upgrade to a full version of MSSSLMSSQL.
Limitations for MSSQL 2017 Express (Limitations for previous versions see Microsoft.com)

  • Maximum database size 10 GB

  • No SQL Server Agent Service

  • Uses no more the than 1Gb of Ram

Host Installation:

Database Server: MSSQL Server 2022, 2019, 2017, 2016, 2014, 2012
Hardware Requirements: http://msdn.microsoft.com/en-us/library/ms143506.aspx
Recommendation:
Memory: 6GB RAM (or more)
Hard disk: 120GB or more for the Adonis database (Estimated a 20-40 GB database on the office side. multiplied by 3 to have enough space for a backup to disk and restore as a secondary database)

Vessel installation

Database: MSSQL Server 2017 Express
Hardware Requirements: http://msdn.microsoft.com/en-us/library/ms143506.aspx
Recommendation:
Hard disk: Database The database will probably not grow over 10GB
Memory: 1 GB RAM reserved for SQL Server for maximum performance (so 2-3 GB RAM for the entire server may be enough)
For numbers of crew greater than 100/ 150 with an average of 15 to 20 scanned documents each, you should consider a full version of MSSql (see host installation)

Applications

Adonis Personnel Manager

Location: Vessel, Host
This is the main application and is a windows Windows client executable running on any standard Windows PC. The application is normally generally installed on the file server and accessed by the client via a short cutshortcut.
The application is developed in

  • Embarcadero Delphi 10.2 using 3rd party components for the user interface

  • The application is compatible with Windows 7, 8, 10 Areo giving it a modern look and feel and the possibility to change the layout of the application., and 11

Adonis Personnel Portal (Public/Local Cloud)

Location: Vessel, Host
Developed in Microsoft .Net 4.7
Microsoft Internet Information Server 7.5
Hardware / Software requirementsRequirements: Standard windows Windows server requirement.
Recommendation:
Memory: 6GB RAM (or more)

Adonis Replicator

This runs as a service this , which can be the database server or the file server, . In addition, a program called Replicator monitor is installed to monitor the service running on different sites. Hardware requirements: Standard windows Windows server requirements
Bandwidth:
The replicator checks the bandwidth of the available connection, and if it is below an a user-definable offset, the replicator only replicates the most relevant metadata. For example, Scanned documents are put on hold and replicated on request or when the bandwidth is above the given offset.
Only data relevant for to the vessel is replicated.
The replication schedule is user-definable, and Adonis advice to replicate advises replicating as often as every 5 or 10 minutes. This keeps the data packages small.

Azure

It is said that for every task to perform, there are at least 3 three different ways of doing it in Azure. So, the details provided here are not requirements , but more as suggestions, considerations or guidelines when using Azure as the platform for providing the service.
You may utilize IaaS (Infrastructure as a service – read virtual machines) or PaaS(Platform as a service) services, or you may combine them , to provide the services.

IaaS

When using IaaS, consider it the same as you would host it from virtual servers in your own network but accessing it from a remote location.
To avoid latency and/or bandwith bandwidth issues(read performance issues), you should run APM in a terminal services solution (like Windows Virtual Desktop or Citrix) in the same datacentre data centre as your database server. Running the Adonis Personnel Manager (APM) on a client computer with the servers in Azure, although technically possible, will most likely result in performance problems.

PaaS

SQL Database

Instead of running a SQL server in a virtual server, you may utilize the SQL Database offer in Azure. Our current minimum recommendation is an S2-level database. For production databases, we would recommend geo-replication to one or more additional datacentres, data centres to establishing establish a disaster recovery solution.

App Service

For the Adonis Personnel Portal, instead of running a virtual machine with the portal, the App Service offer in Azure can be used.
However, be aware that the Personnel Portal installation/upgrade is an installation executable that is executed on an IIS server, so you would either have to run the installation/upgrade on a local computer or a virtual machine in Azure and then upload the installed directory structure to the App Service.
Recommended The recommended service level has not been determined yet, but a standard 1 small App Service Plan can be a starting point.
An App Service Environment can provide better security , but also come at a much higher cost. So you may have to consider your requirements for security v.s. the additional cost.
The App service should be running run in the same datacentre data centre as the database(both for performance and for cost).

Virtual machine

For Adonis Replicator and Adonis Notification service for APM, we are not aware of any suitable PaaS services, so you need to use a virtual machine (IaaS) to run these services. A B2s B2-level virtual machine may be suggested as a starting point.

Windows Virtual Desktop

Windows Virtual Desktop is a comprehensive desktop and app virtualization service delivered on Azure. It can be utilized to run APM in the same datacenter data centre as your database server in Azure , to avoid latency and/or bandwidth issues in the communication between the application and the database server. Ensure the session hosts are in the same datacenter as your database server.