X4 Produktdokumentation
X4 Produktdokumentation
Breadcrumbs

X4 Server – RPM package for SUSE Linux Enterprise Server

The following sections describe how to automatically install the X4 Server based on an RPM package (.rpm) on an Open SuSe Linux System.

Installing the X4 Server

Prerequisites:

  • Make sure that the insserv-compat package has been installed.
    The package can be installed in the command line with the following command: zypper install insserv-compat

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

  1. Download the X4 Server – RPM package for SuSe Linux Enterprise Server package from the Resources > X4 Downloads section of theSoftProject website.

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

For example, sudo rpm -i X4-Server_SLES-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_SLES-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 or service X4-Server start

Stop the X4-Server service

Systemctl stop X4 server or service X4 server stop

Restart the X4-Server service

systemctl restart X4-Server or service X4-Server restart

View the status of the service X4 Server

systemctl status X4-Server or service X4-Server status

Reload the X4-Server service

systemctl reload X4-Server or service X4-Server reload


Unstalling the X4 Server

To uninstall an X4 Server installed via the RPM package and its X4-Server service, enter the sudo rpm -e X4-Server_SLES-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 .