The article describes the installation of Comarch ERP Enterprise on a server running Red Hat Enterprise Linux or Ubuntu server operating system and PostgreSQL database engine.
Requirements
A properly installed Redhat Enterprise Linux or Ubuntu server as the operating system is also required. The network must be configured so that the computer name can be recognized.
Prior to the installation, it is necessary to verify what follows:
- whether the postgres user (the default PostgreSQL engine user) can log in to the system with the command:
su postgres - the port on which the SQL server is running; this port will be used later in this instruction
- free hard drive space. Installation files and the installed system generally require 30 GB of free disk memory
- access to the root user or to the root group user
- requirements specified by Redhat Enterprise Linux or Ubuntu server and PostgreSQL, and the installation of necessary software updates
Conventions
A uniform directory structure should be ensured, especially when multiple systems are maintained on a single server.
Installation of JDK
Comarch ERP Enterprise is based on the Java programming language and requires the Java Development Kit (JDK) as a runtime environment.
The JDK installation procedure described below is only required in the case of the first installation or modification of the JDK version.
Procedure: Installation of Java JDK
The current JDK version 11 package is available for download at https://adoptopenjdk.net/. After downloading it, the following steps should be performed:
- Place the downloaded package on the server
mkdir /opt/comarch/java/ - Create the directory
/opt/comarch/javaand copy the downloaded tar.gz file to the directory/opt/comarch/java - Execute
tar –xzf OpenJDK11U-jdk_x64_linux_hotspot_11.0.10_9.tar.gz - Rename the JDK directory to
mv jdk-11.0.10+9/ jdk-11.0.10+9-64/
To later verify the installation, you can enter the following commands in the shell:
export JAVA_HOME=/opt/comarch/java/jdk-11.0.10+9-64
$JAVA_HOME/bin/java –version
Following information is displayed:openjdk version "11.0.10" 2021-01-19 OpenJDK Runtime Environment AdoptOpenJDK (build 11.0.10+9) OpenJDK 64-Bit Server VM AdoptOpenJDK (build 11.0.10+9, mixed mode)
strsas-MESSAGESERVER.shThis prevents problems with other JDK versions already installed.Installation of Comarch ERP Enterprise
The archive CEE630PA-Partnersystem.zip is necessary in order to install the system.
Running the script extracts the achive, configures the necessary database files and users, imports data from the export files, and creates statistics for the data. To install the provided system, run the bash shell as the root user.
Creating directories
Create the following setup directories:
mkdir –p /opt/comarch/CEE630PA
Then, extract the downloaded ZIP archive into the directory:
unzip CEE630PA-Partnersystem.zip file
License file
Add the license file into the extracted directory:
/opt/comarch/CEE630PA/install/licence
crtsem.sh install scripts
The operating system must have de_DE.UTF-8 language support installed.
For Ubuntu-based distributions:
- sudo apt install language-pack-de
For RHEL/CentOS-based distributions:
- yum install langpacks-de
- After the language is installed, go to the directory with scripts
cd /opt/comarch/CEE630PA/install/scripts/linux
- Change the crtsem.sh script permissions
chmod 774 /opt/comarch/CEE630PA/install/scripts/linux/crtsem.sh
- Run the crtsem.sh install script with –help parameter to display
help ./crtsem.sh –help
- The script is awaiting the following parameters:
– systemname: according to the license (e.g., CEE630PA)
– java: home directory java /opt/comarch/jdk-11.0.10+9-64
– licencefile: license file name (e.g., 300-CEE630PA-01-CEE630PA.lic)
– licencepassword: license password
– database_type: PGSQL
– filedestination_dir: destination directory where semiramis folder is to be configured. If this folder does not exist, the script creates this folder as well as all parent folders (e.g., /opt/comarch/CEE630PA )
– configuration_database: configuration database name as specified in the license (e.g., CEE630PACF )
The script may take a longer time to execute.
An examplary invocation looks as follows:
./crtsem.sh -systemname CEE630PA -java /opt/comarch/java/jdk11.0.10+9-64 -licencefile 300-CEE630PA-01-CEE630PA.lic -licencepassword <kennwort> -database_type PGSQL -filedestination_dir /opt/comarch/CEE630PA -configuration_database CEE630PACF
The semiramis.zip file is extracted into the specified directory /opt/comarch/CEE630PA/semiramis. Then the PostgreSQL databsae files and the database users are created. Next, the provided Comarch ERP Enterprise databases are imported. Finally, the optimizer statistics are created.
The log files can be viewed under /tmp/CEE630PA-log lub ${TMPDIR}/CEE630PA-log. They provide information about the successful import process.
Database users and passwords created for Comarch ERP Enterprise:
Username/Password | Database |
|---|---|
| CEE630PACF | for configuration database |
| CEE630PARP | for repository database |
| CEE630PA00 | for Base OLTP database |
| CEE630PA02 | for Multi-Site database |
If the CEE system database is to be stored on another server, you need to manually move the above databases to another server and update the address of the configuration database in the file:
/opt/comarch/CEE630PA/semiramis/classes/system.properties
Running Comarch ERP Enterprise application server
To start the application server of the ERP system (SAS), follow the steps below:
- Run the bach shell and navigate to the SAS working directory:
cd /opt/comarch/CEE630PA/semiramis/servers/MESSAGESERVER
- Execute the script to start SAS:
./strsas-MESSAGESERVER.sh
SAS stores the log files in the directory: /opt/comarch/CEE630PA/semiramis/servers/MESSAGESERVER/log. When strating SAS, the server already connects to the local database and reads the configuration settings from the configuration database.
After the server is started, a prompt is displayed:
ADMINISTRATOR@MASSAGESERVER>
You can now execute commands in CEE toolshell.
Generating database information
Before logging in to the system for the first time, it is necessary to generate database information. To do so, execute the following commands on SAS:
crtdbinf -configuration -repository
crtdbinf -oltp -nlsAutomatic
restart
Logging in to Comarch ERP Enterprise
The first login to the system is via the URL http://localhost using ADMINISTRATOR as user name and 12345 as password.
Generating certificates
To use a secure connection for logging in, certificates must be generated.
Further steps
After installation, a few additional steps are required to further configure the system. The installed system is licensed only for a limited range of functions. To use the full functionality of Comarch ERP Enterprise, you must first install a license for the new system and configure this system.
Uninstallation of Comarch ERP Enterprise
To uninstall Comarch ERP Enterprise, follow these steps:
- Exit all SAS accessing to the database through the database users to be deleted. User data cannot be deleted while the user is still connected to the database.
- Delete all databases created duing installation, such as CEE630PACF, CEE630PARP, CEE630PA00, CEE630PA02
- Delete the folowing directory and its content
/opt/comarch/CEE630PA/semiramis
Comarch ERP Enterprise system is now uninstalled.