Infrastructure
| Table of Contents |
|---|
We have reduced the number of files and directories needed to execute the Adonis Personnel Manager and the Adonis Control Centre.
The various files including the aduser.ini that are needed to execute the executables are now stored in the database.
This means that the executables, ApmMgr.exe and AcCentre can be executed directly from the APM directory and no 'Start in Directory' is needed in the program start-up to point to the users aduser.ini.
Connecting to the database, the application picks up user-related data and settings directly from the database instead of external ini-files.
The installation and upgrade sets are combined in one distribution package.
The installation set will prompt you if you want to perform an upgrade, new installation, or just want to execute the upgrade files or create database logins. 
After the installation is completed, the following files are stored in the ..\ APM directory:
The BACKUP folder contains the file backups to be able to restore the previous version of the application.
The PLUGINS folder contains software components that add specific features to the
| Anchor | ||||
|---|---|---|---|---|
|
The adFastReport2.dll library is required for providing compatibility with reports created in FastReport version 42.
The adpw.ini file contains the database connection strings.
The apmg.exe file is an executable used to run the Adonis Control Centre and Adonis Personnel Manager applications
The .lng files are localization files required to maintain different languages in the Adonis Control Centre and Adonis Personnel Manager applications.
The pw.dat file is a license file containing your company's license information for APM modules and datagroups.
The uninst.exe file is an executable used when uninstalling the application.
The sqlncli.exe installation file of Microsoft SQL Native Client is used to provide application compatibility with lower versions of SQL Server.
The libeay32.dll and ssleay32.dll libraries contain a set of procedures and driver functions that may be applied by Windows.
Cleaning up the directory structure
The upgrade is not removing the old directory structure of APM as there can be stored information that is critical for your operation.
We advise cleaning up this structure and removing the directory structure as it is not relevant for executing APM.
Requirements
To run the application effectively, make sure the following applications are installed on your workstation:
...
For more information, see Execute Upgrade Script.
Create Database Logins/Users. Select the option to connect to the database and create database logins: ADPW, AD_UPGRADE, and REPL.
When installing APM on a new server, first, restore the backup, then install APM without a database. During this installation, link APM to the restored database and create database logins/users. For more information, see Create Database Logins/Users.
Copy Files. Select the option to downgrade the program without updating the database. It is a time-saving procedure mainly intended for testing purposes in test/development environments.
Assume that you need to downgrade the current version of APM for testing/investigation purposes. To do this, run the executable file and select the Copy Files mode. For more information, see Copy Files.
Generate Update Package. Select the option to generate a .cab file with the APM installation set designed for the Replicator to automatically run the upgrade patches. For more information, see Generate Update Package.
| Anchor | ||||
|---|---|---|---|---|
|
...
Save AdonisRepl v. x.x..exe. file to the same Replicator folder where Replicator is installed.
| Info |
|---|
Note: For customers who use Replication between sites! |
The following steps need to be done in the same sequence to avoid possible issues:
Step 1: Disable Scheduler on the main site
Go to Replicator Manager >- Scheduler tab, clear the check-box for Use built-in scheduler option:
...
Step 2: On the main site - Run replication (all 4 phases), check if no errors exist (if any – contact support@adonis.no):
FTP: Receive Files;
Import;
...
Be sure that no errors exist (if any – contact support@adonis.no).
Step 4: After you've finished needed actions on every vessel (per Step 3), return to the main site:
On the main site:
...
Step 1. Run the executable file
Go to the download area of our website or your FTP area to download the latest patch with the name apm2017.4.0.XXX
where XXX is a build number.
...
If you want to upgrade the DB which is not defined in adpw ini. file, you can use Add new database option: 
As a result, it will be upgraded and added to adpw.ini file. Details for the new database that should be added:
Note: Defined value in Alias field of Upgrade Set will be stored as CON_NAME value in ADPW.ini file.
Indicate Server name, Database name, and Password of AD_UPGRADE database user.
Click test Connection and then Upgrade button.
Step 4. Define server connection details
...
| Info |
|---|
To check if a new version is correctly installed, you can log into APM: |
...
Step 2: Enable Scheduler on the main site.
Step 3: Run replication on all sites – vessels and main site (all 4 phases – FTP: Receive Files, Import, Export, FTP: Send Files).
Check if no errors exist, if any – contact support@adonis.no
| Anchor | ||||
|---|---|---|---|---|
|
...
Step 1. Run the executable file
Go to the download area of our website or your FTP area to download the latest patch with the name like apm2017.4.0.XXX
where XXX is a build number.
...
Please pay attention: Install / Upgrade Personnel Manager is the standard, commonly used mode.
The Create Database Logins/Users mode is an additional option used by the Adonis Development team for some special/uncommon situations.
*Step 1. Run the executable file:*
Go to the download area of our website or your FTP area to download the latest patch with the name apm2017.4.0.XXX
where XXX is a build number
...
Please pay attention: Install / Upgrade Personnel Manager is the standard, commonly used mode.
The Copy Files mode is an additional option used by the Adonis Development team for some special/uncommon situations.
Step 1. Run the executable file
Go to the download area of our website or your FTP area to download the latest patch with the name apm2017.4.0.XXX
where XXX is a build number
...
Generate Update Package
The newest replicator version provides the possibility to distribute & run upgrade patches automatically.
As upgrade requires passing a certain set of parameters, from APM ver. 2018.1. - we should provide the possibility to use this command for this purpose - to generate CAB of an installation set to install APM by Replicator.
This file should be then published in Replicator Manager (see separate The Adonis Replicator manual).
Step 1. Run the executable file
Go to the download area of our website or your FTP area to download the latest patch with the name like apm2018.1.0.XXX
where XXX is a build number
...
The system will ask you to identify the target folder where you have your APM application installed.
Please browse the correct path in your system.Click Generate button.
The system generates a CAB file of the installation set. It will be saved in the 'APM SETUP' folder of the APM root folder. This file should be published by the Replicator manager (see separate The Adonis Replicator manual).
Step 4. Generating process
...
How to publish and schedule APM upgrade date & time via The Adonis Replicator Manager - see The Adonis Replicator manual.