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 22 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 3

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

Select Local Installation and click Next to proceed.

For step-by-step instructions on how to install the application on the Azure platform, see Azure Installation.

Step 4

In the dialog, select Install Personnel Manager and click Next to proceed:

Step 5

In the Choose Components dialog, select the components to be installed:

By default, the set offers all of the components:

  • Personnel Portal WebService is responsible for numerous calculations and operations being performed by the system.

  • Personnel Portal creates a web interface that provides onboard crew and office employees with an access to various operations within application modules.

  • Gateway API Web Service

  • Integration Web Service ensures communication to third-party applications.

Click Next to proceed.


Step 6

Define the connection details such as server and database names as well as provide the database credentials.

On entering the details, click Test DB connection to make sure the connection is successful. When done, click Next to continue.

Make sure the provided Database server name and Database name values are those used in Adonis Personnel Manager. For this, navigate to Service Desk > About > System > Database > Connection.

Step 7

In the General settings dialog, select whether you want to perform the vessel or office installation:

On selecting, in the Office ID/Vessel ID drop-down list, select the ID to be affected.


Step 8

Define details for the SMTP server as well as its connection credentials (if necessary). It is required for mail generation when sending reports by email or sending out notifications.

Click Next.


Step 9

In the Personnel Portal IIS settings dialog, ensure that the Web Site is set to Default Web Site.

Click Next.


Step 10

With the dialog displayed, choose the folder where you want to install the Adonis Personnel Portal application.
To do this, click Browse… and indicate the path to the destination folder.

Click Next to continue.

You can see the APP installation in progress:


Step 11

Enter the database AD_UPGRADE password:

Click OK to confirm.


Step 12

The Adonis Personnel Portal application has been successfully installed on your PC.

Click Next to finish the installation.

On the dialog that opens, select the applications to be lauched after closing the wizard:

Click Finish to close the setup wizard.

Depending on the selection made at Step 5, the installed applications may differ. For the vessel installation, the installed application will be Crew Portal. For the office installation, the installed application is Employee Portal.

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