Skip to main content
Version: 15.1

Upgrade from ADOIT 14.0 to ADOIT 15.1 (Standard Library)

If you are planning to upgrade from ADOIT 14.0 to ADOIT 15.1, and you're using the ADOIT Standard Application Library, this guide will walk you through the necessary steps to ensure a smooth transition.

note

This guide is also valid if you are using an ADOIT Standard Application Library with changes in the metamodel or functional extensions or another specific library.

If you are using ADOIT 14.0 with the ArchiMate Application Library, read on here.

Prerequisites

Before you proceed, note the following prerequisites:

  • Before installing, make sure that all Hardware/Software Requirements are met.

  • Download the ADOIT 15.1 installation package (your ADOIT consultant will email you a link).

Stop Services

First, the ADOIT 14.0 application server and the Apache Tomcat web server have to be stopped.

To stop the services (on Windows):

  • Open Services. Press <Windows> + <R> to open the Run box, enter services.msc, and then click OK.

  • Stop the ADOIT application server (service name e.g. "ADOITServer14.0Service") and the Apache Tomcat web server (service name e.g. "Tomcat9").

Backup Deployment-Specific Data

Deployment-specific data encompasses various settings and information that are not stored in the database. This includes comments on models and objects, settings such as server ports, and more.

Depending on your ADOIT 14.0 installation, you have to back up the following folders and files:

ADOIT Application Server Configuration

  • <ADOIT 14.0 application server>/conf/server.conf (contains the database name, application server or aworker processes ports, and trusted IP address of the web server).

  • <ADOIT 14.0 application server>/conf/adoxx.conf (optional, if parameters have been changed from their default value)

  • <ADOIT 14.0 application server>/conf/adoxx_web_conf.js (optional, if parameters have been changed from their default value)

Apache Tomcat Configuration

  • <Tomcat>/webapps/ADOIT14_0/adoxx_web.properties (contains the application server IP address and definition of aworker processes)

  • <Tomcat>/webapps/ADOIT14_0/WEB-INF/classes/logback.xml (optional, if logging parameters have been changed)

  • <Tomcat>/webapps/ADOIT14_0/WEB-INF/web.xml (optional, if additional file types have been whitelisted for uploading)

  • <Tomcat>/webapps/ADOIT14_0/WEB-INF/registry/rest/RESTAuthorization.xml (part of the REST API configuration)

Comment Data

  • <Tomcat>/webapps/ADOIT14_0/WEB-INF/registry/collaboration (contains XML files that hold all comments for a model or object)

  • <Tomcat>/webapps/ADOIT14_0/WEB-INF/registry/upload (contains files that were uploaded along with comments)

  • <Tomcat>/webapps/ADOIT14_0/WEB-INF/registry/axw.ids (contains the last assigned and highest comment ID)

Install and Configure ADOIT 15.1 Rich Client

Now, it's time to install and configure the ADOIT 15.1 rich client, which serves as an application server and is required for using the Administration Toolkit. Detailed instructions are provided in the following sections.

Perform Installation

Install the ADOIT 15.1 rich client now. Depending on your deployment scenario, you must perform the following steps:

  • Install ADOIT as an application server on the designated server machine.

  • Install ADOIT for using the Administration Toolkit, for example on client machines or on a terminal server.

To perform the installation:

  • Double-click setup.exe located in the 02 Rich Client folder within the ADOIT 15.1 installation package, and then follow the instructions provided by the setup wizard.
note

For detailed instructions on the installation process, see Install Rich Client.

Configure Application Server

After the installation is complete, configure the ADOIT 15.1 application server. Unlike a new installation where you'd set initial values, you will use your backup ADOIT 14.0 application server configuration files and transfer the values from there.

To configure the application server:

  • Navigate to the directory <ADOIT 15.1 application server>/conf.

  • Edit the configuration file server.conf and transfer the values from your backup file, including the database name, application server or aworker processes ports, and the trusted IP address of the web server.

  • Optional: Edit the configuration files adoxx.conf and adoxx_web_conf.js, and transfer the values from your backup files if parameters in these files were changed in ADOIT 14.0.

Example

For example, if you previously modified the file adoxx_web_conf.js to set the standard language the web client should be started with, then copy the value of the parameter ADOXX_WEB_CLIENT_LANGUAGE to the new adoxx_web_conf.js file.

caution

Always merge your changes into the new configuration files - never overwrite them!

Install Application Server as a Service

With the rich client installation and configuration tasks completed, it's now time to install the ADOIT 15.1 application server as a service.

  • Open the Windows Command Prompt as an administrator. Press <Windows> + < R> to open the Run box, enter cmd, and then press <Ctrl> + <Shift> + <Enter>.

  • Navigate to the directory <ADOIT 15.1 application server>.

  • Type aserver.exe -i to install the Windows Service (e.g. ADOITServer15.1Service).

The application server is now installed as a service. Do not start the service yet.

Install and Configure ADOIT 15.1 Web Client

Now, you need to deploy the ADOIT 15.1 web client and configure it using backup files from your ADOIT 14.0 deployment. You'll benefit from reduced configuration efforts by utilising the same Tomcat instance that already hosts the ADOIT 14.0 web client. Detailed instructions are provided in the following sections.

Deploy Web Client

Deploy the ADOIT 15.1 web application to Apache Tomcat now by copying the necessary files:

  • Copy the file ADOIT15_1.war to the directory <Tomcat>/webapps. This file can be found in the folder 03 Web Client within the ADOIT 15.1 installation package.

The ADOIT 15.1 web client is now deployed. Do not start the Apache Tomcat service yet.

Configure Web Client

Now, it's time to configure the ADOIT 15.1 web client. Unlike a new installation where you'd set initial values, you will use your backup ADOIT 14.0 Apache Tomcat configuration files and transfer the values from there. You will also import the comment data.

To configure the web client:

  1. Navigate to the directory <Tomcat>/webapps.

  2. Open the file ADOIT15_1.war with a file archiver and perform the following steps on its contents:

    • Edit the configuration file adoxx_web.properties. Transfer the values from your backup file, including the application server IP address and definition of aworker processes.

    • Optional: Edit the configuration files WEB-INF/classes/logback.xml, WEB-INF/web.xml and WEB-INF/registry/rest/RESTAuthorization.xml, and transfer the values from your backup files if parameters in these files were changed in ADOIT 14.0.

    • Copy the backup folders collaboration and upload, as well as the backup file axw.ids, to the folder WEB-INF/registry.

  3. Save the changes.

caution

Always merge your changes into the new configuration files - never overwrite them!

Uninstall ADOIT 14.0

You've completed the ADOIT 15.1 installation; now, it's time to uninstall ADOIT 14.0.

  • Uninstall the ADOIT 14.0 application server, and any other ADOIT 14.0 rich client installations for using the Administration Toolkit. You can do this through the control panel.

  • Remove the ADOIT 14.0 web application from Apache Tomcat.

note

For detailed instructions on how to uninstall, see Uninstall ADOIT.

Start Services

Finally, the ADOIT 15.1 application server and the Apache Tomcat web server have to be started.

To start the services (on Windows):

  • Open Services. Press <Windows> + <R> to open the Run box, enter services.msc, and then click OK.

  • Start the ADOIT application server (service name e.g. "ADOITServer15.1Service") and the Apache Tomcat web server (service name e.g. "Tomcat9").

You can access the web client via the following address: http://<SERVER_NAME>:<TOMCAT_PORT>/ADOIT15_1/. Here, <SERVER_NAME> represents the server machine's name, and <TOMCAT_PORT> corresponds to the HTTP/1.1 Connector Port that was configured during setup (the default value is “8000”).