Skip to end of banner
Go to start of banner

APP Housekeeping

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Version History

« Previous Version 20 Next »

Contents

Housekeeping

System Architecture

Adonis Personnel Portal consists of three applications:

  • Administrator Portal

  • Employee Portal

  • Crew Portal

See the article explaining the difference between them:
Difference between the Administrator, Employee and Crew Portals

Error rendering macro 'excerpt-include' : No link could be created for 'System Architecture'.

Server Components

The Adonis Personnel Portal consists of the following server components:

  1. The Adonis Personnel Portal Web Service
    The Crew Portal Web Service (AdonisWebServices) contains the API used by the Personnel Portal.
    This component is Mandatory!

  2. The Adonis Personnel Portal (Client Web Application)
    The Crew Portal is the actual web application or user interface used by the onboard crew members.
    It requires the Crew Portal Web Service

  3. The Time Registration Service
    This service is mandatory when it is used by Time Clock. Time Clock uses the Time Registration Service to communicate with the database.
    It requires the Crew Portal Web Service

System Requirements

The following description shows the minimum and recommended hardware and software requirements:

  • Adonis Crew Portal requires: .Net Framework 4.7 or higher

  • The server must support .net 4.7.

  • Minimum CPU is 8 GB

  • Minimum server hardware requirements given by Microsoft

Internet Information Services Manager (IIS)

The APP installation set will install or activate the following IIS and Windows features:

-IIS-HttpCompressionDynamic
-IIS-ApplicationDevelopment
-IIS-ASPNET
-IIS-ISAPIExtensions
-IIS-ISAPIFilter
-NetFx4Extended-ASPNET45
-IIS-NetFxExtensibility45
-IIS-ASPNET45
-WCF-HTTP-Activation45
-IIS-WebServerRole
-IIS-WebServerManagementTools
-IIS-IIS6ManagementCompatibility
-IIS-Metabase
-IIS-WebServer
-IIS-ApplicationInit
-IIS-StaticContent
-IIS-NetFxExtensibility
-WAS-ProcessModel
-WAS-WindowsActivationService
-WAS-ConfigurationAPI

The Installation sets register the following IIS VirtualDirs:

  • AdonisWebServices

  • APP (Adonis Personnel Portal)

  • AdonisTimeRegSrv

The remote update will not work if IIS is running on Windows 10. For more information on the remote update, see Remote Installation / Update.

Installation/ Upgrade

Before you start

Before installing Adonis Personnel Portal, make sure you have Adonis Personnel Manager (version 4.20 or higher) installed on your workstation.

Database Modifications

When installing or upgrading the system, you need to upgrade the database.

To perform this upgrade, you are required to provide AD_UPGRADE credentials. If they are unknown, please contact your database administrator.

Installation Modes

The installation set offers you the following options:

  • Install Personnel Portal creates the application from scratch, installs and activates all the necessary components. The option is set by default as your target server or workstation does not have any APP instance installed

  • Repair is used to re-install, clean up, and activate already installed components

  • Update checks for the installed application and verifies its version against the offered one. If the installed version is lower, the system will be upgraded to the latest one

In the Install, Repair or Update modes, the installation set enables the Windows features. For more information, see the Internet Information Services Manager (IIS) section.

New Installation

Step 1

To start the installation, go to the download area of our website or your FTP area and download the latest version of Adonis Personnel Portal.
Once the download is complete, go to the downloaded path and double-click the installation file to launch the setup wizard.

It is recommended to close all other applications before starting the installation.

Step 2
When the Welcome dialog appears, click Next to continue.

Step 2

Specify whether the installation is to be performed locally or on the Azure platform:

Step 2: Installation Mode

In the opening window, you see the options that can be performed by the set:

To install the new application use Select Install Personnel Portal mode (creates the application from scratch, installs & activates all necessary components).

Click Next to proceed.

Step 3: Choosing Components to be Installed:

By default, the set offers all of the components:

Personnel Portal WebService - the service is responsible for numerous calculations & operations that are performed by the system.

We recommend you to have it installed as you may lack the necessary functionality for certain modules without it.

Personnel Portal - creates a web interface that allows access & to various operations with application modules for onboard crew and office employees.
Time Registration Service - can be disabled if you do not plan to use Panel PC applications for daily registration of work & rest hours for your crew.
If you plan, please leave the list as it is (all checkboxes are set).

Click Next.


Step 4: Database Connection Setup

Please enter the Database server name & Database name that are used by Adonis Personnel Manager (APM).

You can find this information in APM, under Service Desk > About > System Information > Connection:

Click the Test DB Connection button and wait until the system confirms that input data are ok (message Test OK will appear).

Click Next to continue.


Step 5: General Settings

Customer Name - will be used to define the application URL. This can be site-specific or a generic name used on all sites.

Please avoid using spaces (instead use underscore) or special symbols here.

Vessel/Office installation & ID - depending on the selected radio button offers you the drop-down list of Companies/Vessels from your organization structure defined in Adonis Personnel Manager. This is to define your current office to work with.
Installation Name - suffix to be used by installation set when creating virtual IIS directories.
If you have only one installed copy of the APP on the server, it is recommended to leave the Installation name field empty.
But if you would like to install a few copies of the APP on the same server, you need to specify the unique Installation name. It will be added to IIS virtual directories.

For example, if you specify the Installation name FIRST, then it creates the following IIS VirtualDirs: AdonisWebServices_FIRST, APP_FIRST, AdonisTimeRegSrv_FIRST


Step 6: SMTP/E-Mail Settings:

Please define details for SMTP-server & its connection credentials (if necessary) to be used by the system for mail generation when Sending Reports by Email or Sending out Notifications.

This information can be provided by the customer's system administrator.

Click Next.


Step 7: IIS Settings

Please ensure that the Web Site is set to the Default Web Site value.

Click Next.


Step 8: Installation Settings

Browse the path on which you would like to install the APP too.

Click Install to begin the procedure.

You will be able to follow up on the installation process on your Progress screen:


Step 10: Run Database Scripts & Create ini-file

Once a certain set of components is unpacked & installed, necessary Windows features turned on, the Adonis Script Executor box appears to run the scripts pack for modification of your database structure:

Click Execute to run database scripts.

The progress log on the right will inform you of the progress:

Enter AD_Upgrade password.

Once the log informs you that the database upgrade is finished, click Exit.


Step 11: Completing the APP Setup Wizard

After executing the scripts, you are switched back to the Installation Wizard:

Click Next to continue.

Open Crew Portal/Administrator Portal options are optional.

Instead of 'Crew' may be 'Employee' Portal if you install the program on the Office, not Vessel (at Step 5 – General Settings).

Click Finish.

Once the application is installed, you will have 3 access shortcuts created on the desktop:

Upgrade Existing Installation

The same Installation set is used to perform the system upgrade.
It will recognize existing applications and use the settings stored in the Windows registry to perform the upgrade.

Step 1: Start

Run the file & wait until the necessary system components are turned on.
The Welcome screen below appears:

Click Next to continue.


Step 2: Select Update mode

Select Update option - checks for the installed application & verifies its version against the offered one.
If the installed version is lower, the system can be upgraded to contain the latest functionality & logic changes.

Click the Update button.


Step 3: Run Database Scripts

You will be able to follow up on the installation process on your Progress screen.
Once a certain set of components is unpacked & installed, necessary Windows features turned on, the Adonis Script Executor box appears to run the scripts pack for modification of your database structure:

Click Execute to run database scripts.

The progress log on the right will inform you of the progress:

Enter AD_Upgrade password.
Once the log informs you that the database upgrade is finished, click Exit.

Step 4: Completing the APP Setup Wizard

After executing the scripts, you are switched back to the Installation Wizard:

Click Next to finish.

Open Crew Portal/Administrator Portal options are optional.

Instead of 'Crew' may be 'Employee' Portal if you upgrade the program on the Office, not Vessel.

Click Finish.

Accessing the Application

The Adonis Personnel Portal consists of the following main applications.

See below each of the accessible via dedicated URLs:

NOTE:

The CustomerName is the name you are giving to the Crew Portal during the installation process (Step 4).

The system will prompt you with this name.

The URLs are created at the end of the installation.

You could find all links on portals via the URL below:
URL: http://localhost/APP/

How Portal link is built:

Example: http://localhost/APP/CustomerName/employee

  • localhost – host address

  • APP – the name of the web application; you could find it in IIS

  • CustomerName – the name of the company that was declared during APP installation; if you don't remember it you should use the link http://localhost/APP/

  • employee (or crew/administrator) – link to one of the portals0

The Crew Portal

It is executed in the local network onboard and accessible by all onboard crew members who have current activity.
It is used to give crew members access to the various onboard modules.
To log in you need authentication by Pin and Passcode.
URL: http://localhost/APP/CustomerName/Crew

The Employee Portal

It is used to give employees access to using the internet for various modules when they are at home or traveling.
To log in you need an authentication Email address and Password.
URL: http://localhost/APP/CustomerName/employee

The Administrator Portal

This is the Portal to administrate both Applications. It includes the setup of the various modules, user access rights, etc.
URL: http://localhost/APP/CustomerName/Administrator
Default Credentials:
UID: admin@crewportal.cp
PWD: 1

The Time Clock

The Time Clock installation needs the following URL to access the APM database:
URL: http://localhost/AdonisTimeRegSrv/TimeRegWebService.asmx

Maintaining Reports

Reports are not included in the installation set but are maintained via the Administrator Portal > Reports > Maintain Reports.
In this module, the reports, required by the customer, are uploaded to the server and accessible for the various modules/user groups.

Here you can edit, add, delete and preview reports.
Reports Grid displays Modified Date, Report Name, Report Version, and Comments (if exist):

To add a new report, click New.

  1. Use the Browse button to find the .frx or .axr file containing the report you want to upload and use the Upload button to copy the report to the database

  2. Report Name, you can overwrite the report name and give it use an understandable name.
    This is the name that will be displayed in the report menu.

  3. Select the user groups that will have access to the report.

  4. Select the modules that will display the report in their report menu.

  5. If the report can be sent by mail, you can select which modules will have the possibility to send this report by e-mail.

  6. Comments for internal usage by the administrator.

  7. Don't forget to click Save.

Click to back to the Administrative Tools.


  • No labels