X4 Produktdokumentation
X4 Produktdokumentation
Breadcrumbs

X4 Server and Keycloak – RPM package for Red Hat Enterprise Linux

The following sections describe how to automatically install the X4 Server based on an RPM package (.rpm) on a Red Hat Enterprise Linux System.

Installing the X4 Server

Prerequisites:

  • Make sure that the IP address of the server and the host name are entered under /etc/hosts (example: 192.168.147.153 vmettopensuse01).

  • Run the dnf install redhat-lsb-core command, because the redhat-lsb-core module must be installed.


  1. Download the X4 Server – RPM package for Red Hat Enterprise Linux package from the Resources > X4 Downloads section of the the SoftProject website.

  2. Run the installation using the sudo rpm -i X4-Server_RHEL-7.v.v-r.x86_64.rpm command.

For example, sudo rpm -i X4-Server_RHEL-7.0.0-1.x86_64.rpm for release 1 of X4 Server version 7.0.0.

By default, the X4 Server is installed under /opt/X4. The --prefix parameter can be used to change the installation path.

For example, sudo rpm -i X4-Server_RHEL-7.v.v-r.x86_64.rpm --prefix=/new_path

The X4 Server will now be installed in the specified folder. This process may take a few seconds.

  1. Add a valid X4 license. For more information, see License Information .

  2. Start the X4 Server manually by running the startX4.sh script in the installation path.

If you want to install the X4 Server as a service, follow the steps in Instructions: Creating and Managing systemd Services for X4-Server and X4-Authentication-Provider .

  1. After running the script or starting the service, check whether the server log /opt/X4/WildFly/standalone/log/server.log contains error messages.
    A correctly installed and started X4 server does not display any error messages (ERROR or FATAL). This should be the case at the latest at the second start of the X4 Server.

Control options for the X4-Server service

The following options are available via the command line to control the X4 Server or its service X4-Server.

Note:

These options are available only if you have completed the required service installation steps. For more information, see Instructions: Creating and Managing systemd Services for X4-Server and X4-Authentication-Provider.

Action

Command

Start the X4-Server service

systemctl start X4-Server

Stop the X4-Server service

systemctl stop X4-Server

Restart the X4-Server service

systemctl restart X4-Server

View the status of the service X4 Server

systemctl status X4-Server

Reload the X4-Server service

systemctl reload X4-Server

Unstalling the X4 Server

To uninstall an X4 Server installed via the RPM package, enter the sudo rpm -e X4-Server_RHEL-7.v.v-r.x86_64 command.

Note:

If you have manually installed service files and want to remove them, follow the steps in Instructions: Creating and Managing systemd Services for X4-Server and X4-Authentication-Provider .