During installation, the Tealeaf Canister Server is configured and enabled automatically. While you can configure the Canister Server through TMS, you should not have to make any adjustments after the software is installed and configured properly.
After installation, you might need to perform additional configuration of the Canister for single server or multi-server installations. Changes to these settings can be used to deploy Canister and indexing functions across multiple servers, or you can install multiple Canisters on the same machine or across multiple machines.
Important: Since the Canister is a high-performance component integrated into the capture and processing stream, changes should be applied with care.
Note: The ctsrvr.cfg file in the Tealeaf installation directory contains a
LOCAL_DIRECTORY setting that defines the root directory for the Canisters. The names of the Canister directory are specified as paths relative to LOCAL_DIRECTORY, in the Canister configuration. Do not define LOCAL_DIRECTORY to be the root directory of a volume, such as C:.To view or edit canister configuration settings:
- Log in to the Portal as an admin user.
- From the Portal menu, navigate to TMS.
- In the Servers view, click the next to the desired server to drill down to components.
- Click next to the Canister component to display the configurations.
- Click Canister configuration to display the Config information.
- Click View/Edit. The Configuration Editor is displayed.
Notes:
- Changing the value of the
LOCAL_DIRECTORYrequires a rebuild of the Canister. - When applying changes to the Canister, select
Add Restart Task(s)only when changing the number of Hit and Session processors. When these settings are changed, a restart of the Transport Service is also required because the Canister Manager requests the Transport Service to spool the data stream. Restarting the Transport Service restarts the flow of the data stream. - After modifying Canister settings and restarting the Transport Service, hits may be spooled until the Canister is up and running. In some situations, the Extended Decoupler session agent does not receive notification that the Canister has restarted, and hits continue to be spooled even though the Canister is ready to receive them. In this case, a restart of all Tealeaf services is required.
- Changing the value of the
- After the changes have been saved, the Canister Server must be restarted for the changes to take effect.
The following configuration option tabs are available for the canister configuration by using TMS.