Adonis Installation Manual

Yüklə 76.21 Kb.
ölçüsü76.21 Kb.

Welcome to the Adonis Installation manual. It will help you through the installation process of Adonis software from A to Z.

First step is to upload your software from Adonis server. Please send a request to to get your login/password & connection details. You should mention your full company name, name & email of responsible person. You will get all necessary details & license files. The set of our products will be available for download at your area.
Depending on the number of your sites (offices, vessels, other) you may require one or several installations.

Steps for single site installation:

  1. Install MS SQL Server;

  2. Install Adonis Personnel Manager (APM) – see Chapter 1 for details;

  3. Install Adonis Personnel Portal – see Chapter 2 for details.

Steps for multi-site installation:

  1. Install MS SQL Server at Host (main site / office);

  2. Install Adonis Personnel Manager (APM) at Host – see Chapter 1 for details;

  3. Install Replicator at Host – see Chapter 2 for details;

  4. Install MS SQL Server  at Satellite (vessel/other site);

  5. Install APM at Satellite - same steps as in Chapter 1 for host;

Note that when you perform Step 7 – you must enter the correct Main SiteNo & Current SiteNo that are different in case of vessel installation;

  1. Please don't pass to further steps until you ensure that all sites' versions for APM are synchronized;

  2. Install Replicator at Satellite – see Chapter 2 for details;

  3. Perform Partial Replication – see Chapter 3 for details;

  4. Install Adonis Crew Portal – see Chapter 4 for details;

  5. Start full replication - run replicator at all sites, enable ALL 4 options at Status menu & use Scheduler section to schedule periodical replication

CHAPTER 1: Install APM

1. Start ApmSetup4.10.exe & click Next to continue.

Then browse the directory in which you want to install APM. By default it is installed to C:\ADONIS

2. Choose the components that you would like to install. We recommend you to have all items selected. Click Next to proceed

3. The installation will suggest to create backups of the files replaced during the installation. We recommend to do this, so answer yes. The replaced files will be placed to a folder \BACKUP under the installation folder you selected.

4. Please select the directories to be used for Data and for APM folders. By default the directories C:\ADONIS\DATA and C:\ADONIS\APM are suggested.

Usually default values can be accepted.

Program folder is a directory where apmgr.exe file is placed and files the application will use.
Data folder – contains info like: database counters, payroll scripts, selection definitions and so on. The Data folder should be a must for all the APM instances working with one database.

5. In this screen you should provide the Database connection details: database type, server name and host name. The Database name is defined as ADONIS by default.
On the next screen you can choose the name of the Program Manager group to add Adonis Maritime Suite icons to

6. Please specify the location of your license file. You will not be able to proceed until the correct path is selected.
You will then be able to choose whether to Create shortcuts on the Desktop & finish the installation.

7. Adonis Personnel Manager database Setup Wizard starts automatically when the Installation is complete. After the welcome screen you will be asked to input necessary data for this installation site. Please input the same digital code for Main SiteNo & SiteNo fields.

8. Please define preliminary list of sites that will be using replication. This list can be modified later but this will require additional steps for setup of replication channels.

9. Please specify the SQL Server name, Host name or IP address where the server is located, and password for SA user. Click Test connection button to verify that all data is input correctly.

You will see a message informing that the connection has been established, Click OK, then proceed with "Next" button.

10. The next 3 steps are to define and confirm the password for the ADPW user, AD_UPGRADE user & REPL user.

11. Then please define required data for the superuser in Adonis Personnel Manager. Click Next.
Now everything is ready to create the database and users for Adonis Personnel Manager. Click Create in the following window. The status screen will inform you on installation progress & successful completion.

12. If you are installing APM over the restored database (not from scratch) - an extra step should be performed.

Please runs your SQL Management Studio and execute the 3 scripts as given at the right.

Then please run the script to set the correct data directory that might have been different for the former database installation. Please note that you should input the correct path to your Adonis data directory inside the quotation marks.

exec sp_change_users_login 'Auto_Fix', 'ADPW'
exec sp_change_users_login 'Auto_Fix', 'AD_LOGIN'
exec sp_change_users_login 'Auto_Fix', 'AD_UPGRADE'

update pworgcon set DATADIR='C:\Adonis\Data'

13. Please note that the installation set provides you with the release version To be able to upgrade to a later build you should download the latest available file (like 4.10.1.xx.exe) from our ftp area to your APM folder.

Please run this exe-file & confirm the data extraction to the same folder.

14. Confirm file replacement clicking “Yes to All” button. Please note that no APM files cannot be in use at this moment, otherwise you will receive an error message & you should re-start this step.

15. Please run your Adonis Personnel Manager with your superuser credentials. You will be offered to upgrade your system & to input your password for user AD_UPGRADE.

After that the progress screen will inform you on the upgrade process. APM will be started automatically once the upgrade is finished.

CHAPTER 2: Install replicator

1. To install Adonis Replicator software, you need to run AdonisRepl_v3.19.exe file. Setup Wizard will start.

2. Please choose the components you want to be installed. The item "Replicator service & manager" is mandatory & cannot be un-tagged.

Please select if you use single or multi-instance installation. Multi-instance is for a site that is used as an intermediate for replications of several different sites.
If you would like that each site (vessel/office) works with its own replicator - please use Default Instance option.
If you use multi-instance installation - please use Named Instance giving different names for each site that you add.

3. In the next screen you need to define the path where you would like to install the Replicator.
If an earlier version of Replicator was already installed in your system, you need to install the new version to an existing path. If this is the first time you start to use Replicator, you can install it to the path, that is suggested by default, that is to C:\Program Files\ADONIS Replicator folder, or you can click Browse and select a needed folder, hard drive or shared drive. Usually it is ...Adonis\Replicator folder.
Click Install.

3.1 At this step you should define Database type: Microsoft SQL Server.

Click Build button.

3.2 Provider tab:
On this screen you should select the data type you are connecting to.

Normally this is "Microsoft OLE DB Provider for SQL Server".

Click Next.

3.3 Connection tab:

On this screen please enter a server name, define a user name and password, and select the database at the server. User name should be 'REPL' (use upper case).

Select the option Allow saving password.

Click Test Connection. You will see a message "Test connection succeeded".

Click OK and the ADO Connection String field will be updated.

Click Test DB Connection. You will see a message that connection is established.

Click OK, then Next.

4. For the file transfer method you select FTP if you have a fixed network connection between the replication sites.

Other options are File Transfer if you choose to use an external ftp utility, and IMAP, SMTP and POP3 if you choose to use email.

If you choose:

FTP please skip to 4.1

File transfer please skip to 4.2

MAPI please skip to 4.3

SMTP and POP3 please skip to 4.4

4.1 If you have selected "FTP" as Mail system:

Please input as Server Name, 21 for Port.

Add User Name and Password.

In the Send Directory you need define the directory, from which the files will be sent. If you set it as ...replicator/site#DSN# , it will set the directory to the folder for this site automatically.

In the Receive directory you can set ...replicator/site10 (if you have one folder for all sites) or ..replicator/site#CSN# (if each site has a separate folder).

Define Send and Receive directories.

Click Test connection.

You should see a message informing that the connection has been established.

Click Next.

4.2 If you have selected "File Transfer" as Mail system:

Define the Send and Receive Directory.

Send directory is a path to the folder from which the replication files will be sent. Usually it is ...Adonis/Replicator/Out/Send.

Receive directory shows the path to the folder where replication files will be received. Usually it is ...Adonis/Replicator/In/Receive.

In this screen you can also define File Prefix and File Postfix, if your system uses a text before or after a name of a cab file.

Click Next.

4.3 If you have selected "MAPI" as Mail system.

Input the MAPI Mail User and a password.

Click Next.

4.4 If you have selected "SMTP and POP3" as Mail system:

Define server name and port. Click Test connection.

Input a user name and password. In-fill the SMTP server name and port. Click Test connection.

If SMTP server requires authentication, select the option "Server requires authentication" and input user name and password. Click Next.

5. Click Read Current Site Number from DB button or input the current site number manually.
For users who used Replicator before, the Data Directory can be left blank, in case if the new Replicator is installed to similar directory. If you did not use Replicator before, browse a new location.
Select the options Stop Export On Error and Stop Import On Error. You can also select DB errors if you would like some of the errors to be ignored. The error 3609 should be in that list.

3609 is a code of an error "The transaction ended in the trigger."

6. The replicator supports two types of export files, encrypted and plain archive files. For the latter you select the option Microsoft Cab Archive files.

If you choose to encrypt your export file you select option Adonis Replicator Data file (*.rpl) and select Encrypt data with AES algorithm. Without this option selected your files will not be encrypted.

Import File Format

By default the replicator accepts non-encrypted files on import. Select this option if this is not required.

Data Encryption password:

To open an encrypted file the system needs a password or key, This key needs to be the same at all sites. Enter this password in the field Data Encryption Password.

7. Select the port, to which the replicator service will listen to allow the Replicator Manager to connect remotely.
Define Username and password that will be used when connecting with the Replicator Manager.
Click Finish.

8. Please start Replicator manager. Define SMTP Server settings. Add e-mail to which the data will be sent to.

Check the options "Send reports on errors", "Send Status reports", "Send warning if no cab/rpl files have been received recently".

Define time interval that you want to be kept between replicating files in & out.

Normally 5 or 10 minutes interval is enough to keep sites updated & avoid excessive replication tasks.

Click Finish

After the installation, the replicator service is set to run as "local system" account. We recommend to change that to run as a domain account.

If you haven't yet got a user you want to use for the replicator service, then add that user to the domain or computer. It is better to set the option that the password never expires for that account, to prevent the replicator from stopping when the password expiry time has exceeded.

Browse the Adonis directory structure and look at the properties for the folder. Go to the Security page and add the user that the replicator service is running as (unless the user for the replicator service is already in a group that has sufficient access to the directory structure). It needs write access to those directories where the replicator should be able to have data replicated from other sites. For instance if you are replicating customized reports, the replicator needs write access to the "Adonis\apm\reports" folder. If you are replicating calculation scripts, you will have to have write access to "Adonis\data\scripts" and so on. For simplicity, you could give write access to the Adonis folder and subfolders all together.

Go to Services (located in Administrative tools which you find in Windows Control Panel, or sometimes also directly in the start menu), or you can open services.msc (just run it from the command line or the search bar). Select the Adonis Replicator service. If you installed it as a named instance, you will have the instance name in parenthesis. Select the instance, rightclick and select Properties.

Set the service to start automatically.

Enter the account details on the Log On page. Rightclick on the service and start it.

Chapter 3: Start Replication


  1. Activate the Vessel in the replication set-up

Run Adonis Control Centre, login using your SuperUser credentials. Set the checkbox to Active for the sites which have both APM & Replicator installed. Set flag Current for the correct site.

2. Manually start the replication at Host (export only, don't receive, import or send)

Please run the Replicator Manager & Click Add New Connection button. Select Named Pipe in the Protocol field for connection to a service running on the same computer as the replicator manager.

Or use TCP / IP to connect to another computer.

Input username and password. Click Connect.

The new connection "localhost" that was just created will be displayed on the left. Expand the host for details:

a) The Status view will show you the replicator status. You can start or stop replication on that view.

b) Settings view enables you to check the settings set up during the installation, and edit them if needed.

c) You can later use Scheduler to enable scheduled replication and set replication intervals.

Select Services & Connections, set cursor to available instance name, then click Start Service.

Switch to Service menu & select Status. Set the checkboxes OFF for Receive Files & Import. Then click Start. The replication file containing all database info will be created & placed to Send directory according to your settings.

Pick-up the replication file (cab/rpl) & deliver it to a PC with vessel installation using memory stick, ftp, removable hard-drive etc.


Copy the initial cab/rpl file to the Receive directory according to your settings for vessel installation.

Run Replicator manager, establish connection (as described above). In Status window please set checkboxes OFF for Export & Send Files. Click Start to upload the replication file.

Chapter 4: Crew Portal Installation

Crew Portal Software minimum system requirements:

  • Windows Server 2008R2, Windows Server 2003 SP2 x86, Windows Server 2003 SP2 x64, Windows Server 2003 SP1 x86; Widows 7 x86; Windows 7 x64

  • MS SQL Server 2005/2008

  • IIS 6 up & running


1. Download files

  1. -Setup.exe

  2. - dotNetFx45_Full_setup.exe

  3. -wic_x64_enu.exe

  4. -wic_x86_enu.exe

Execute the ‘Setup.exe’ file. This is a self-extracting archive with files necessary for the installation to a temporarily directory and executing the setup.

2. In the window you see the windows components that need to be installed on your server. These components will be installed before Crew Portal.

Please choose components if not yet installed & click Install button. Note that installing .NET components will require additional steps to confirm the license agreement.

Click Next when welcome screen appears.

3. Define Virtual Directory: the virtual directory is the directory on your IIS server that contains the Crew Portal application. The application itself will be installed in an other location.

Note! The Virtual Directory will be the part of your URL to access the application.


4. Database Connection Settings:

The Crew Portal will be using the existing APM database, this screen prompts you for the credentials to connect to it.

Database – name of the database targeted by APM,

Server – name of the MS SQL server

5. Database Connection Settings:

Next screen will offer you to type Customer name.

Customer name is the name of you organization, program will create INI file with this name and the name will be used in URL to your Crew Portal application.


NOTE! Don’t use spaces in the name!

The email server and email address can be filled out later in the configuration screen of the application.

6. For Host installation you should define only feature “Crew Portal SQL Scripts” to be executed. No installation will be performed, but the database structure will be updated to be consistent with vessels.

Click Next & select Install on the next screen.


Please perform the same steps as for Host installation. Please use the same host, virtual directory & customer name that were used for Host installation.

On step 6 you should select all features to be executed. By default we offer to install them to Program Files folder but you can change it using Browse button

Once the installation is performed – you should set permissions for the current Windows user to a folder where the Crew Portal was installed.

CHAPTER 10: Add vessel site (set passive)

Use a desktop icon or run Accentre.exe from your APM folder. Login to Adonis Control Centre using your SuperUser credentials that were input during installation.

Click Sites icon & ensure that all sites are in place & their settings are correct: only the main site should be active & current. Others should have empty checkboxes.
In case if any site is missing – you should add it using New button on the tools panel.

Version 4.10.1 Page

Verilənlər bazası müəlliflik hüququ ilə müdafiə olunur © 2016
rəhbərliyinə müraciət

    Ana səhifə