Installation¶
System Requirements
Before installing Axon.ivy Engine check if your system meets the system requirements.
Install Axon.ivy Engine
To install the Axon.ivy Engine extract the correct zip file for your platform to the directory where you want to install the Axon.ivy Engine. For Debian based operating systems there is a convenient installer package available. The following platforms are supported:
CPU |
Architecture |
Operation System |
Installation File |
---|---|---|---|
Intel |
x64 |
Debian (Ubuntu/Mint) |
|
Intel |
x64 |
Windows |
|
Intel |
x64 |
Linux and Windows* |
|
Intel |
x64 |
Linux and Windows* |
* The All and Slim_All engines are delivered with launchers for Linux and
Windows, but without a JRE. To use the slim Axon.ivy Engine set up the IVY_JAVA_HOME
environment variable pointing to a supported x64 JRE, or the JAVA_HOME
environment variable pointing to a supported x64 JDK. The slim Axon.ivy Engine comes
without demo projects.
Note
Note, that the installation procedure implies sufficient administration and
access rights on the system. For example, the access to drive C:
on a
Windows Server 2008 system is very restrictive that you might install the
programs on drive D:
instead.
Start the Axon.ivy Engine
You can start the Axon.ivy Engine by navigation to the bin
folder and executing the
AxonIvyEngine
binary on Linux:
cd bin
./AxonIvyEngine
and the AxonIvyEngineC.exe
on Windows:
cd bin
AxonIvyEngineC.exe
Alternative, you can use the Control Center to start the Axon.ivy Engine. By default the Axon.ivy Engine starts in Demo Mode.
Installing a Licence
You have to install a licence in order to run Axon.ivy Engine in Production Mode. To order a licence file you need to know the public URLs that end users will use to access your Axon.ivy Engine.
Example
Let’s assume your Axon.ivy Engine is installed on a machine with the DNS name axonivyprod
.
Users access the Axon.ivy Engine in two different ways:
Intranet users use
http://axonivyprod:8080
to access it.Internet users use
https://www.customer.com
to access it through a reverse proxy.
An admistrator accesses the Axon.ivy Engine with an IP Address http://192.168.1.19
.
In this case the licence must contain three public URLs:
axonivyprod
www.customer.com
192.168.1.19
Remark: Access via localhost
, 127.0.0.1
and ::1
is always possible
and needs not to be provided in the licence.
To install a licence file use the Engine Cockpit or follow the steps below:
Copy the licence file
*.lic
to the directory[engineDir]/configuration
.Remove all other licence files in the
[engineDir]/configuration
directory.
Note
For container based installations it is also possible to make the licence file available via environment variables or docker-secrets.
Creating a system database
You have to create and configure a system database in order to run Axon.ivy Engine in Production Mode. See Configuration to find out how you can create and configure Axon.ivy Engine system database.
Detailed Installation Information