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.
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.
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.
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
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.
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.