Download Ruby installer for Windows from http://rubyinstaller.org/downloads/. For non-Windows platforms, compile the installer from source.
Download redis.gem from https://rubygems.org/.
Syntax: gem install <path-to-gem-file>
Last updated on
May 30, 2024
|
Also applies to ColdFusion
- ColdFusion Tools User Guide
- Performance Monitoring Toolset
- Overview of ColdFusion Performance Monitoring Toolset
- Auto-discovery of ColdFusion nodes and clusters
- Code profiler in ColdFusion Performance Monitoring Toolset
- Configure ColdFusion Performance Monitoring Toolset settings
- Install ColdFusion Performance Monitoring Toolset
- View cloud metrics
- Monitor GraphQL in Performance Monitoring Toolset
- Configure TLS/SSL and Authentication for Elasticsearch 8.x in Performance Monitoring Toolset
- View cluster and node metrics
- View data source metrics
- View external services
- View incoming services
- View list of sites and busy connections
- View topology of sites
- Datastore Health Monitoring
- Performance Monitoring Toolset Update 1
- Secure Performance Monitoring Toolset with HTTPS/SSL
- Performance Monitoring Toolset deployment guide
- Use ColdFusion Builder
- About ColdFusion Builder
- System requirements | ColdFusion Builder
- Install ColdFusion Builder
- Edit code in ColdFusion Builder
- Manage servers in ColdFusion Builder
- Manage projects in ColdFusion Builder
- What's new in Adobe ColdFusion Builder (2018 release)
- Frequently Asked Questions (FAQ) | Adobe ColdFusion Builder (2018 release)
- Debug applications in ColdFusion Builder
- ColdFusion Builder workbench
- ColdFusion Builder extensions
- Debugging Perspective in ColdFusion Builder
- Build mobile applications using ColdFusion Builder
- Bundled ColdFusion Server
- Debug mobile applications in ColdFusion Builder
- Use extensions in ColdFusion Builder
- Coldfusion API Manager
- Overview of Adobe ColdFusion API Manager
- Features in ColdFusion API Manager
- Get started with ColdFusion API Manager
- Install ColdFusion API Manager
- Authentication types
- Create and publish APIs
- Administrator
- Subscriber
- Throttling and rate limiting
- Notifications
- Connectors
- Set up cluster support
- Integrate ColdFusion and API Manager
- Metrics and Logging in API Manager
- Generate Swagger documents
- Configure SSL
- Known issues in this release
- Policies in ColdFusion API Manager
- Create a Redis cluster
- Multitenancy in API Manager
- Docker images for ColdFusion API Manager
Creating a Redis cluster in ColdFusion API Manager
In ColdFusion 2021 API Manager, you can use a Redis cluster as your datastore.
Using the Redis cluster, you can scale API Manager by adding or removing Redis nodes and manage automatic failover by creating slaves.
This is independent of your API Manager cluster.
A Redis cluster requires at least three master nodes. We recommend creating three corresponding slave nodes for better availability and reliability.
Creating a Redis cluster involves installing individual Redis nodes that will become a part of the cluster. The next step involves adding the nodes to the cluster and providing the Redis cluster information to API Manager.
Installing a Redis node
You can install a Redis node using the API Manager add-on installer.
Enable the Enable Cluster Configuration check-box when installing each Redis node.
Each Redis node requires two open TCP connections.
The first port is the Datastore port (provided during installation), for example 6379, plus the port obtained by adding 10000 to the datastore port, so 16379 in this case.
This second port is used for the cluster bus, which is a node-to-node communication channel using a binary protocol.
The cluster bus port must be reachable from all the other cluster nodes. If you do not open both TCP ports, your cluster will not work as expected.
Creating a Redis cluster
You can create a Redis cluster by adding individual Redis nodes to the cluster and establishing communication between the nodes.
-
-
Execute the Ruby script redis-trib.rb located at <APIM_AddOn_Home>\datastore\ruby-script.
You can execute this script in any machine that has Ruby pre-installed and redis.gem added.
-
Execute the following command to configure Redis cluster with three master nodes and no slave nodes:
ruby redis-trib.rb create <machine-ip>:<port> <machine-ip>:<port> <machine-ip>:<port>
-
Execute the following command to configure Redis cluster with three master nodes and three slave nodes:
ruby redis-trib.rb create --replicas 1 <machine-ip>:<port> <machine-ip>:<port> <machine-ip>:<port> <machine-ip>:<port> <machine-ip>:<port> <machine-ip>:<port>
For more information, refer the Redis cluster documentation at http://redis.io/topics/cluster-tutorial.
Providing the Redis cluster information to API Manager
To provide the Redis cluster information to API Manager during installation:
-
Uncheck the Datastore check-box.
Uncheck datastore Uncheck datastore -
In the Datastore and API Manager Cluster configuration dialog, choose Redis Cluster as Yes, and enter the details of any one node in the Redis cluster.
Choose Redis cluster Choose Redis cluster You can also move to a Redis Cluster after installation by providing the details at API Manager Administrator > Server > API Datastore
You can also migrate all the data from single node to Redis Cluster from here by enabling the Perform Migration check-box.
Redis Cluster to a single node or cluster to cluster configuration is not supported.
When you start Redis from the command line, there is no logging. Logging gets redirected to redis.log file that can be found in datastore folder.
