Server Environments

The following applies to all servers:

• Business Processes with parameters cannot be launched, as there is no mechanism for manually entering a value for parameters. In order to launch a Business Process with a parameter, you must encapsulate parameters in another Business Process that assigns them value.
• File Monitors, Database Monitors, Email Receive Monitors, Web Services, and Harmony Monitors are started/stopped from Admin Console / Resource Monitors.
• The results of executed processes can be viewed in Admin Console / Auditor.
• The Server Log view displays log information for a selected server, supporting all server types, including Server Cluster environments.
• Active Projects in your Workspace are available for deployment once a server starts.
• Admin Console / Projects displays a list of all objects deployed on the server. It also displays deployment errors, which can be very useful when troubleshooting issues on the Local Test Server.
  Note: Avoid hard-stopping servers.

The Local Test Server is installed/integrated with the Studio. It serves to test Business Processes during the design and development stages of integration. To ensure the best results when using the Local Test Server, the following guidelines should be followed:

• Don’t start the Local Test Server immediately after starting the Studio. Instead, only start it when ready to test an integration process.
• Ensure that the Local Test Server isn’t started while converting objects from previous versions.
• Ensure that the Local Test Server isn’t started when checking out objects from an SVN Repository.
• Global Variables will be updated in the Local Test Server when modified in the Studio.
• Always close Projects that contain invalid objects, or objects that aren’t ready for development testing, before starting the Local Test Server. Valid objects automatically deploy, but will be unusable if referenced objects are not valid. An example is a Business Process that references a Ruleset with a reference to an invalid Schema.
• Run the Local Test Server in debug mode to assist with troubleshooting integration projects.
• If you experience deployment problems or are missing expected objects, use the Project | Clean option from the main menu to rebuild the Project’s objects.

Clarify Servers are for test and production environments. These runtime servers are installed on different machines than the Studio(s). The following applies to all Servers:

• One person is assigned the role of deploying test or production Projects. This ensures that the intended Project (with the correct objects) is deployed, and avoids deployment of duplicate Projects from different Workspaces.
• Ensure the Server is started prior to deployment.
• When deploying a Project with a large amount of Packages and/or objects, the initial deployment process may take longer than normal.
• Servers should be backed-up at regular intervals.
• If you need to change a Global Variable, Next Number, or Control Number Generator value, you must do so in the Settings View. Updating the value in the Studio and re-deploying the object has no effect.

A test Server is installed on a different machine than the Studio(s). It is the server to which completed Projects are deployed for the purpose of integration environment testing. This is where you load-test your environment, identify benchmarks, and guarantee that all of your integrations function together. This Server should mirror your production environment. To ensure the best results when using a test Server, the following guidelines should be followed:

• Disable the communication paths to your trading partners. Instead, use the file system to test your solution’s output.
• Ensure that all objects are saved in your SVN Repository, or in a different branch for test data.

To ensure the best results when using the production Server, the following guidelines should be followed:

• Ensure that communications to your trading partners are enabled.
• Ensure that all objects are saved in your SVN Repository, or in a different branch for production data.