Install Redis open source

Overview

Install Redis directly from the Redis site to ensure that updated packages are provided. The instructions in this topic are streamlined for an IPLM installation. For more detailed instructions, refer to Redis documentation.

Considerations

  • Prior to IPLM Core 2025.3, Redis used to be provided as the package iplm-backend-redis.

  • The service is called redis rather than iplm-backend-redis.

Step 1: Configure Redis package repository

Packages for Debian, Ubuntu

Run the following command to configure the repository where the packages are downloaded from:

Copy
apt-get install lsb-release curl gpg
curl -fsSL https://packages.redis.io/gpg | sudo gpg --dearmor -o /usr/share/keyrings/redis-archive-keyring.gpg
chmod 644 /usr/share/keyrings/redis-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/redis-archive-keyring.gpg] https://packages.redis.io/deb $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/redis.list
apt-get update

Step 2: Download and install signing key

Run the following command to download and install the signing key:

Copy
curl -fsSL https://packages.redis.io/gpg > /tmp/redis.key
rpm --import /tmp/redis.key

Step 3: Check for patch versions (optional)

You can check to see if there are more recent patch versions of Redis. The most recent version of 8.2.2 is supported.

Run the following command:

Copy
apt policy redis

Step 4: Install Redis

It is recommended to install a known supported version of Redis. This will install redis-server, redis-cli and redis-sentinal in /bin directory.

Run the following command to install Redis:

Copy
apt install redis=6:8.2.2-1rl1~bookworm1

Step 5: Configure Redis

Once installed, the Redis configuration file is found in /etc/redis/redis.conf. This is where you can make any configuration changes.

By default, Redis listens on port localhost:6379, and does not use a password. This means that it can only be accessed from the local machine. Unless IPLM is being installed on a single machine, then you will need to open up the bind so that Redis can be accessed remotely, and you should also set a password to enable security. Binding it to 0.0.0.0 means that it can be accessed remotely on any network interface.

Remove the comment from the following in the configuration file to open up the bind and set a password:

Copy
bind 0.0.0.0
requirepass myinsecurepassword

Detailed configuration

See Events administration for more detailed Redis configuration steps.

Step 6: Enable and start Redis

If you are migrating from iplm-backend-redis, see Migrate iplm-backend-redis to Redis open source package.

Run the following commands to enable and Redis:

Copy
systemctl enable redis
systemctl start redis

Next steps

Once you have completed the Redis open source installation, follow the instructions to install IPLM Cache.