Click Start > Control Panel. Select Programs and Features.
- 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
Overview
In the API Manager, connectors redirect the requests from web servers to application servers. Connectors also provide load balancing between various nodes in a cluster. Web server connectors in the API Manager manage the communication between the web server and the application server.
For Internet Information Services (IIS), the connector is isapi_redirect. On the other hand, for Apache web server, the connector is mod_jk.
In the API Manager, the connector communicates with a single cluster and a ColdFusion instance or cluster, if present.
Also copy the cluster.xml in the wsconfig folder file if you want to run wsconfig from outside the API Manager folder structure.
Connectors also refresh the information of a cluster dynamically. You need not restart the web server. There are some limitations:
- You cannot add a cluster.
- You can only add a node to a pre-configured cluster.
- You cannot modify the information of an existing node.
Configuration files
Connectors in the API Manager use the following configuration files:
- worker.properties: This file contains information about all application servers and clusters.
- uriworkermap.properties: This file contains rules of when to redirect a client request. This file also contains uri prefixes and filename extensions mapped to application servers or clusters defined in the file worker.properties.
Configuring connectors using Wsconfig tool
You can use the Wsconfig tool to configure connectors. The Wsconfig tool supports both a Graphical User Interface (GUI) and a Command Line Interface (CLI). You can configure the connectors in the API Manager and ColdFusion, if installed.
The Wsconfig tool reads the configuration files and configures the connectors based on some parameters. You can use this tool to add or remove a connector. This tool can be run from any server, but it requires a configuration file to get the information about a cluster and its nodes.
You can refresh information in a cluster after adding a node. Enter wsconfig -help in the command prompt and view the parameters for refresh.
To serve PUT and DELETE requests through connector in IIS, remove the following:
- webDAVModule from IIS > Modules
- WebDAV from IIS > Handler Mapping in IIS Manager
Configuring IIS
-
-
Click Turn Windows features on or off.
-
Select Internet Information Services > World Wide Web Services > Application Development Features.
Select the following check-boxes:
- ASP.NET
- CGI
-
In the <API Manager Installation Directory>/wsconfig/ directory, double-click wsconfig.exe.
-
Click Add.
-
From the IIS Web Site drop-down list, select Default Web Site. Click OK.
-
Restart the server. Click Yes.
The default IIS server becomes the default web site.
-
To verify the successful installation of the connector, enter <localhost>:80/portal in the address bar of a web browser.
Note:The Administrator is blocked in the web server. To access the portal, use the port, 9000.
To configure a web server on a remote machine, copy the cluster.xml file to the folder <API Manager installation directory>/conf/. Start the API Manager first and then run the wsconfig tool.
Configuring Apache
-
In the <API Manager Installation Directory>/wsconfig/ directory, double-click wsconfig.exe.
-
Click Add. On the Add Web Server Configuration dialog box, select Apache from the Web Server drop-down list.
-
Restart the server. Click Yes.
The Apache server becomes the default web server.
You can configure connectors for a particular Apache Virtual Host, similar to IIS. The Virtual Host serves requests only to the API Manager, not to any non-API Manager configurations.
If you use the command line, specify - vhost <virtual_host_name>. The parameter is mandatory.
If you do not have a virtual host or you want to install Apache globally, use - vhost All in the command line.
Use the command wsconfig –usage to explore more on connectors.