Striim 3.9.7 documentation

Configuring the Forwarding Agent

Before starting the agent, you must specify its settings in agent/conf/agent.conf.

Two properties are always required: striim.cluster.clusterName, which specifies the cluster to connect to, and striim.cluster.password, the encrypted cluster password, which you may copy from Striim/conf/startUp.properties on the server.

If the system on which the agent is running has more than one IP address, specify the one you want the agent to use as the value for the striim.node.interface property.

By default, the agent will join the Agent deployment group. If you wish to change that, specify another deployment group as the value for the striim.cluster.deploymentGroups property. If the specified deployment group does not exist, it will be created automatically. When multiple agents on different remote hosts will be used by the same source, they must belong to the same deployment group.

When Striim is running in Amazon EC2, specify the server's IPv4 Public IP address (displayed on the EC2 instance's Description tab) as the value for the striim.node.servernode.address property.

When Striim is running in Azure, specify the server's DNS name (displayed on the Essentials tab for the Striim VM) as the value for the striim.node.servernode.address property.

When Striim is running in Google Cloud, specify the server's IP address as the value for the striim.node.servernode.address property. (Note that you should change the public IP address for the virtual machine running Striim from Ephemeral to Static or it will change every time the VM is restarted. See Promoting an ephemeral external IP address for instructions.)

When the Striim cluster is not discoverable using multicast UDP (for example, if it is running in Amazon EC2), specify the server's IP address or fully-qualified domain name as the value for the striim.node.servernode.address property. If the server's Hazelcast port is not the default 5701, include that as well (for example, 192.0.2.21:5702).

When the Striim cluster is Using TCP/IP instead of multicast UDP, specify a comma-delimited list of server IP addresses or ranges, for example, ‑S "192.0.2.0-7,192.0.2.21", as the value for the striim.node.servernode.address property.

When the Striim cluster and Forwarding Agent are on different private networks linked by VPN with a NAT gateway, you cannot specify the server's IP address as the value for striim.node.servernode.address since it is not reachable by the agent. To work around this, create a DNS name for the Striim server that resolves to a different IP address in each environment.

For example, say that in the Striim cluster's network the DNS name striim.mycompany.com resolves to 192.0.2.101 and on the Forwarding Agent's network it resolves to 192.51.100.25. On each server in the Striim cluster, edit /etc/hosts and add 192.0.2.101 striim.mycompany.com and in startUp.properties set ServerFQDN=striim.mycompany.com. On the agent system, edit /etc/hosts and add 192.51.100.25 striim.mycompany.com. Restart the server(s), then restart the agent.