Installing Redis server
Issues in existing Redis installation
SigningHub installs Redis 3.0 by default with its installer. This distribution of Redis is ported specially to work with Windows operating systems. The following are the issues identified in the ported version of Redis 3.0
Vulnerabilities were reported in Redis v3.0, so it is recommended to upgrade to the latest stable version.
This specialised ported version does not support upgrade to any latest version of Redis
If Redis is already installed for your SigningHub instance, then first uninstall the existing version of Redis 3.0 using the following steps.
Uninstall Redis service
Launch Windows Command Prompt as an Administrator and stop the installed Redis services by typing the following command:
redis-server - -service-stop
Now, uninstall the service by using the following command:
redis-server - -service-uninstall
The existing version of Redis 3.0 will be uninstalled from the system. If you have more than one instance of the Redis server installed in your environment, uninstall all of these versions using the above steps.
Installation of the latest Redis server
Latest versions of the Redis Server instances are not available for Windows operating systems by default; therefore, the recommended approach is to install on Linux. The Redis organisation provides the latest packages for Linux servers. The Redis Server can be installed for testing and for production. The following are the details.
Installing Redis for production
Run Redis using the screen.
Install Redis in your Linux box in a proper way using an init script, so that after a restart, everything will start again properly.
Choice 2 is strongly suggested because the security and other general configurations would not persist otherwise, i.e. the password will be removed on server restart. The configurations must be set to daemonize = true in order to start automatically on system restart.
First, get the latest Redis Server package for Linux. Follow the link below.
After getting the Redis Server installation package, follow the instructions in the link below to install it properly for the production environment. This guide should be strictly followed.
Installing Redis for testing
Redis Server can be installed on a Linux Server in quick mode. This type of installation is quick and easy, but there are a few limitations that are mentioned below.
Configurations cannot be controlled using a config file
Service needs to restart manually on system restart
The password set using the CLI is lost on service restart
Looking into the limitations, this installation should be done only for testing purposes. In order to quickly install, Windows 10 and above provides an option to set up Linux Subsystem called WSL (Windows Subsystem Linux). WSL feature needs to be enabled on Windows first, and for that, the guide is given at the bottom. For the installation of the Redis Server on Windows WSL, follow the link below.
Install the Redis server using the following command:
sudo apt-get install redis-server
After installation Redis server can be reached with the following command to check if installation is properly done.
redis-cli –v
To ‘restart’ the Redis Server and to ensure it is running, type following command.
sudo service redis-server restart
After a restart, ping the Redis service using the following command.
redis-cli and ping
Update Redis server configurations for SigningHub
After installing the Redis Server, the configurations should be updated for the Redis server connection string in SigningHub. Log in to the SigningHub admin and navigate to ‘Configurations -> Redis’. The Redis Server connection string can be updated, as shown in the screenshot below. The connection string format is as follows:
[HOST_URL]:[PORT],password=[YOUR_PASSWORD],ssl=[True/False],abortConnect=[ True/False]
Click on ‘SAVE’ to keep changes and restart IIS where SigningHub is deployed.
Enable Linux on Windows with WSL
Linux distributions such as Ubuntu, OpenSUSE, Kali, Debian, and more can be installed on Windows 10 and above using the Windows Subsystem for Linux option. The WSL enables the use of Linux tools, like Bash or Grep, completely integrated with Windows tools like PowerShell or VS Code. For the complete installation guide, follow the link below.
Last updated
Was this helpful?