User Guide Cancel

Set up cluster support

  1. ColdFusion Tools User Guide
  2. Performance Monitoring Toolset
    1. Overview of ColdFusion Performance Monitoring Toolset
    2. Auto-discovery of ColdFusion nodes and clusters
    3. Code profiler in ColdFusion Performance Monitoring Toolset
    4. Configure ColdFusion Performance Monitoring Toolset settings
    5. Install ColdFusion Performance Monitoring Toolset
    6. View cloud metrics
    7. Monitor GraphQL in Performance Monitoring Toolset
    8. Configure TLS/SSL and Authentication for Elasticsearch 8.x  in Performance Monitoring Toolset
    9. View cluster and node metrics
    10. View data source metrics
    11. View external services
    12. View incoming services
    13. View list of sites and busy connections
    14. View topology of sites
    15. Datastore Health Monitoring
    16. Performance Monitoring Toolset Update 1
    17. Secure Performance Monitoring Toolset with HTTPS/SSL
    18. Performance Monitoring Toolset deployment guide
  3. Use ColdFusion Builder
    1. About ColdFusion Builder
    2. System requirements | ColdFusion Builder
    3. Install ColdFusion Builder
    4. Edit code in ColdFusion Builder
    5. Manage servers in ColdFusion Builder
    6. Manage projects in ColdFusion Builder
    7. What's new in Adobe ColdFusion Builder (2018 release)
    8. Frequently Asked Questions (FAQ) | Adobe ColdFusion Builder (2018 release)
    9. Debug applications in ColdFusion Builder
    10. ColdFusion Builder workbench
    11. ColdFusion Builder extensions
    12. Debugging Perspective in ColdFusion Builder
    13. Build mobile applications using ColdFusion Builder
    14. Bundled ColdFusion Server
    15. Debug mobile applications in ColdFusion Builder
    16. Use extensions in ColdFusion Builder
  4. Coldfusion API Manager
    1. Overview of Adobe ColdFusion API Manager
    2. Features in ColdFusion API Manager
    3. Get started with ColdFusion API Manager
    4. Install ColdFusion API Manager
    5. Authentication types
    6. Create and publish APIs
    7. Administrator
    8. Subscriber
    9. Throttling and rate limiting
    10. Notifications
    11. Connectors
    12. Set up cluster support
    13. Integrate ColdFusion and API Manager
    14. Metrics and Logging in API Manager
    15. Generate Swagger documents
    16. Configure SSL
    17. Known issues in this release
    18. Policies in ColdFusion API Manager
    19. Create a Redis cluster
    20. Multitenancy in API Manager
    21. Docker images for ColdFusion API Manager

Overview

A cluster consists of a set of objects that act as a single instance, and divide the workload. Clustering improves performance as the requests are distributed across several objects. Clustering also improves reliability because if one object instance is unavailable or experiencing high traffic, other instances can handle the request.

The API Manager provides cluster support for application scaling and high availability. As an administrator, you can create a homogeneous cluster for scaling and availability for your APIs via the API Manager.

Starting a cluster

To start a cluster in the API manager:

  1. Change <cluster><enabled>false</enabled></cluster> to <cluster><enabled>true</enabled></cluster>.

To add a node to the cluster, start the node on a separate port. Any change in the API information in one node reflects in all nodes within a cluster.

If you add a new node to the cluster, perform the following SAML-related tasks:

  1. Copy the file seed.properties to the new node. You can locate the file in {API Manager_HOME}/conf/.
  2. Copy the file samlspcerts.jks to the new node. You can locate the file in {API Manager_HOME}/conf.
  3. Copy the following snippet in the config.xml file to the new node. You can locate the file in {API Manager_HOME}/config.
<keystore>
    <path>C:\ColdFusion2016APIManager\conf\samlspcerts.jks</path>
    <type>JKS</type>
    <password>eaf7e40627b249f7ab09d01b01efde77</password>
    <samlspalias>ampserviceprovider</samlspalias>
 <samlspkeypassword>8d4ba4d9cad64d31a29e6b05221e103a</samlspkeypassword>
</keystore>

Using the API Manager data store for clustering

When installing API Manager, you can opt to install the API Manager data store. All API Manager nodes that are a part of a cluster share a common data store. This server stores all configuration-related information of the API Manager. All nodes connected to the server share similar configuration.

Each server in the API Manager has its own cluster configuration. This configuration retrieves the connection details from the data store when a node starts up. In a clustered environment, the API Manager node connects to the server defined in the cluster configuration.

Accessing a node in Redis

By default when Redis is installed, it is reachable only through localhost (127.0.0.1). To access it from a remote machine, perform the following steps:

  1. Navigate to <API Manager installation directory>\database\datastore and open the file redis.windows.conf.properties. In case of Linux, it is redis.conf.properties.
  2. Specify the host name or IP address of the Redis data store in the bind section so that it can be accessible to remote API Manager nodes. You also perform this step when installing an API Manager node on a machine other than Redis datastore machine.

Viewing the cluster via the portal

You can view the cluster via the Administration portal if you install the API Manager stand-alone in your computer.

On the Admin portal, you can view the details of the data store to connect to.

Data store details
Data store details

On the Cluster Configuration page in the Administrator portal, you can view the list of nodes that are a part of a cluster. This information persists as part of the node configuration.

List of nodes in a cluster
List of nodes in a cluster

Accessing a node in Elastic Search

To access Elastic Search from a remote machine, perform the following steps:

  1. Navigate to <API Manager installation directory>\database\analytics\config and open the file elasticsearch.yml.
  2. Specify the host name or the IP address of the Elastic Search server in the network.host section so that the address is accessible to remote API Manager nodes.

Fault tolerance through clustering

Since clustering in the API Manager is homogenous, APIs published from one node are published from all nodes in the cluster. If any node fails, there is no impact on availability of the published APIs.

Get help faster and easier

New user?