Troubleshooting Portals Via Firewall

Move the portals to a different server than where CAMS Enterprise is located and outside a firewall.

Problem: Portals are not on the same machine as CAMS Enterprise and outside a firewall.

Possible Solution: Because Unit4 Education Solutions, Inc. cannot account for every firewall configuration, we cannot make a suggestion as to the best method of running the portals on a separate server from CAMS Enterprise. We can provide the requirements for doing so, and may be able to assist with any issues you encounter.

It is necessary for the portal pages running on the Portal Server to have access to the CAMS Enterprise middleware objects. These .dll files reside in the CAMSEnterprise\MTSDLL folder and are installed as a COM+ application on your CAMS Enterprise Server. Giving the Portal Server access to these objects can be accomplished in 2 ways.

  1. Copy the .dll files themselves from the CAMSEnterprise\MTSDLL folder on the CAMS Enterprise Server to a location on the Portal Server and create an application in COM+ on the Portal Server and add those objects. This means that the Portal Server has its own copy of the dll’s and runs them directly on that server when the portal pages request the object.
  2. Export the COM+ application on the CAMS Enterprise Server to an application proxy install file and run that install file on the Portal Server. This installs a shell application in COM+ on the Portal Server. This means that the Portal Server calls the objects on the CAMS Enterprise Server to be executed there when the portal pages request the object. No middleware code executes on the Portal Server itself.

Both options have several implications as far as maintenance, and communication requirements between the two servers.

Communication

The two installation options above require different communication scenarios for the Portal Server. In option 1, since the middleware code is executing directly on the Portal Server, it will require access to the CAMS SQL Server. In option 2, the code is still executing on the CAMS Enterprise Server, so access to it will be necessary as it handles the needed communication to the CAMS SQL Server.

In either case, the following is necessary for the DTC (Microsoft Distributed Transaction Coordinator) to operate between the two servers. Generally speaking the DTC on a server can only communicate to other DTC’s on other servers by name. This requires manually editing the host files on the two servers to assign a name to the IP. Also, network traffic between port 135 and the port range 1024-65535 must be open between the two servers for the DTC’s on both to talk to each other.

Port 135 is the RPC port that allows one DTC to tell the other that it will be making a request, and on what port. When the DTC replies to the subsequent request from that port, it selects a port at random from the 1024-645535 range and sends the reply.

This means that if a firewall is present between the two machines, some configuration will be necessary to allow network traffic between the two servers on those ports. That either means opening those ports on the firewall, or creating a permanent VPN tunnel between the two servers through the firewall.

Maintenance

In both cases, some work is necessary after a CAMS Enterprise update has been installed.

In case 1, the Portal Server needs a copy of the new objects installed as part of the patch and those objects must be reinstalled in COM+ on the Portal Server

In case 2, the COM+ application on the CAMS Enterprise Server must be re-exported and re-installed on the Portal Server.

For Unit4 Education Solutions to be able to perform this maintenance for you, there are some requirements.

  1. Remote access to the Portal Server
  2. Admin rights on the Portal Server
  3. Depending on whether option 1 or 2 was chosen:
  1. We must be able to either copy the files from the CAMS Enterprise server to the Portal Server, or have access to our ftp site from the Portal Server
  2. We must be able to copy files from the CAMS Enterprise Server to the Portal Server

It is up to you to choose the best configuration for your environment.

Back to Troubleshooting Menu