Contents
| Table of Contents | ||||||
|---|---|---|---|---|---|---|
|
...
The Adonis Personnel Portal consists of the following server components:
The Adonis Personnel Portal Web Service
The Crew Portal Web Service (AdonisWebServices) contains the API used by the Personnel Portal.
This component is Mandatory!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 ServiceThe 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:
...
AdonisWebServices
APP (Adonis Personnel Portal)
AdonisTimeRegSrv
| Info |
|---|
The remote update will not work Remote installation / update is not applicable if IIS is running on Windows 10. For more information on the remote update, see Remote Installation / Update. |
Installation / Upgrade
The sections below contain step-by-step instructions on how to install and update Adonis Personal Portal.
Getting Started
Before installing Adonis Personnel Portal, make sure you have Adonis Personnel Manager (version 4.20 or higher) installed on your workstation.
...
| Info |
|---|
For step-by-step instructions on how to install the web application on the Azure platform, seeAzure Installation. |
Step 4
In the dialog, select Install/Update Personnel Manager and click Next to proceed:
...
| Info |
|---|
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. |
Application Update
...
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.
...
| Info |
|---|
For step-by-step instructions on how to install the application on the Azure platform, seeAzure Installation. |
Step 4
In the Install/Update DB dialog, select Install/Update Personnel Manager:
...
Click Finish to close the setup wizard.
| Anchor | ||||
|---|---|---|---|---|
|
The remote installation or update of Adonis Personnel Portal assumes installing or updating it from the office workstation to the vessel one or vice versa. It is only possible to perform the remote installation / update in the Silent mode using the parameters described in Command-line Parameters.
| Info |
|---|
Remote installation / update is not applicable if IIS is running on Windows 10. |
| Anchor | ||||
|---|---|---|---|---|
|
The table below lists the parameters to be used to perform a remote installation/update of Adonis Personnel Portal.
/S | Executes installation set in the Silent mode. |
|---|---|
/DBO | Updates only a database in the Silent mode. |
/I | Stands for an instance to be updated. |
/CAB | Creats the CAB file to perform an update by Replicator. |
Parameters Description
The /S command-line parameter enables executing installation in the Silent mode. To initiate the installation, type:
| Code Block |
|---|
AdonisPortalInstall_vXXXX.XX.X.XX.exe /S |
The /DBO command-line parameter allows updating only a database. To update a database, type:
| Code Block |
|---|
AdonisPortalInstall_vXXXX.XX.X.XX.exe /S /DBO |
The /I command-line parameter allows specifying the application instance to be updated. If /I parameter is not defined, the installation set updates the [DEFAULT] instance of Adonis Personnel Portal. To update a specific instance, type:
| Code Block | ||
|---|---|---|
| ||
AdonisPortalInstall_vXXXX.XX.X.XX.exe /S /I=Instance_Name |
The /CAB parameter is used to create a CAB file to perform an update in Adonis Replicator. An output CAB file will contain an encoded application instance as well as the the CAB file name will include the instance name. For example: AdonisPortalInstall_appInstanceName_v{PRODUCT_VERSION}.cab. In case an instance name is not defined, a CAB file will be created for the [DEFAULT] instance.
To create a CAB file with a specific instance name, type:
| Code Block |
|---|
AdonisPortalInstall_vXXXX.XX.X.XX.exe /CAB /I=Instance_Name |
| Info |
|---|
For each instance name, you must create a separate CAB file. |
| Info |
|---|
XXXX.XX.X.XX stands for the application version to be updated/installed. |
Replicator Setup
This section describes the parameters to be passed in Adonis Replicator to perform a remote update/installation of Adonis Personnel Portal. To get started, run Adonis Replicator:
...
To specify the parameters, follow the steps below:
On the left-hand side pane, select the service to which you got connected and navigate to Updatable programs.
In the Updatable programs node, select Adonis Personnel Portal. Right under the selected application, select Update parameters.
In the Update parameters workspace, select the Site for which you want to add parameters and click the Add button. Clicking the command displays the Add new command dialog where you can enter the parameters one by one:
REMOTE_SERVER – name or IP address of server where to update APP
REMOTE_SERVER_LOGIN – windows login with admin access rights for \\server\Admin$ resource
REMOTE_SERVER_PASSWORD – password of REMOTE_SERVER_LOGIN user
On entering, click OK to proceed.
The installation of Adonis Personnel Portal on a remote workstation is performed with the help of the PsExec utility that requires the following prerequisites:
File and Printer sharing are enabled on the remote computer
The REMOTE_SERVER_LOGIN / REMOTE_SERVER_PASSWORD credential has an access right to the \\REMOTE_SERVER\Admin$ resource. To make sure the remote server is accessible, execute the follwoing
| Code Block |
|---|
command: \\REMOTE_SERVER\Admin$ /user:<UserName> [Passowrd] |
where REMOTE_SERVER is localhost in case the Replicator Service and APP are on the same server.
| Info |
|---|
Before running the installation set with the /CAB parameter, the PsExec.exe utility must be copied to the folder where the installation set file is. |
| Anchor | ||||
|---|---|---|---|---|
|
You have the possibility to install the APP web application on the Azure platform. For this, proceed with the steps that follow.
Step 1
In the Setup manager, select Azure Installation:
...
Click Next to proceed.
Step 2
Selecting the Azure Installation option opens the Microsoft Azure sign-in page. Enter your credentials to sign in to the Azure account:
...
On successful authentication, opens the Azure Subscription dialog.
Step 3
On the Azure Subscription dialog, select whether you want to update the existing installation or proceed to a new installation:
New Installation
Update
...
When done, from the Subscription drop-down list, select the Azure subscription to be used.
Click Next to proceed.
Step 4
The appearing dialog allows setting the APP web application name by filling in the fields below:
Region. From the drop-down list, set the region where the web application to be installed.
Customer Short Name. Enter the company name to be used as an installation name.
Web App Name Prefix. Enter the prefix to appear before the installation name.
...
On filling in the fields, click Check Web App Name to make sure the web installation name is unique. In case the verification is successful, the following message appears:
...
Click OK. This enables the Next button in the Setup manager. Click it to proceed with the installation.
Step 5
On the dialog, set the following:
Database server. From the drop-down list, select the SQL server where the wen installation is to be performed.
Database name. From the drop-down list, select the database name to be used for the web application
| Info |
|---|
Both the SQL server and database name must be predefined in your subscription. |
...
Click Install to launch the installation.
Step 6
The installation is in progress:
...
Once completed, click Next to complete the installation.
Step 7
The web application is successfully installed:
...
Click Finish to close the Setup manager.
The complete web application URL is : https://appbestcustomerappne.azurewebsites.net/APP_BestCustomer/administrator
As a result of installation, the following components are created in Azure:
Resource Group
App Service Plan
Web App
Accessing Applications
Adonis Personnel Portal consists of the following main applications:
...