Installing the IBM Watson IoT Platform - Message Gateway messaging server RPM

Install the IBM® Watson IoT Platform - Message Gateway messaging server RPM. The IBM Watson IoT Platform - Message Gateway messaging server handles connected clients and devices, and processes messages.

Before you begin

Ensure that you have root privileges and access to a yum repository so that you can use the RPM file in the .tz file to install the RPM.
Ensure that core files can be redirected to a known location. For more information about how to redirect core files, see Core file redirection.

About this task

Complete the following procedure to install the IBM Watson IoT Platform - Message Gateway messaging server RPM. The IBM Watson IoT Platform - Message Gateway service uses the Systemd init system to manage the service. As part of yum install, the IBM Watson IoT Platform - Message Gateway service file is installed in the Systemd configuration directory. Use the systemctl commands to configure the IBM Watson IoT Platform - Message Gateway service for the IBM Watson IoT Platform - Message Gateway server.

Procedure

Ensure that the current working directory is the sub-directory which contains the RPM file that you unpacked when you prepared the .tz file.

Enter the following command:

 yum --nogpgcheck localinstall -y IBMWIoTPMessageGatewayServer*.rpm

Use the following systemctl commands to start and enable the IBM Watson IoT Platform - Message Gateway service for the IBM Watson IoT Platform - Message Gateway server.
1. Start the IBM Watson IoT Platform - Message Gateway service, by entering the following command:
```
systemctl start imaserver
```
2. Enable the IBM Watson IoT Platform - Message Gateway service, by entering the following command:
```
systemctl enable imaserver
```
Optional: You can use the following systemctl commands to further configure the IBM Watson IoT Platform - Message Gateway service.
1. To check the status of the IBM Watson IoT Platform - Message Gateway service, enter the following command:
```
systemctl status imaserver
```
2. To stop the IBM Watson IoT Platform - Message Gateway service, enter the following command:
```
systemctl stop imaserver
```
3. To disable the IBM Watson IoT Platform - Message Gateway service, enter the following command:
```
systemctl disable imaserver
```
4. To restart the IBM Watson IoT Platform - Message Gateway service, enter the following command:
```
systemctl restart imaserver
```

What to do next

You can install an IBM Watson IoT Platform - Message Gateway Web UI RPM that you can use to administer the IBM Watson IoT Platform - Message Gateway messaging server. For more information, see Installing the IBM Watson IoT Platform - Message Gateway Web UI RPM.