Administering Multicast Options

Configuring Multicast Options

Multicast options should be changed in a synchronous manner among the following:

Java virtual machine on which the SAS Remote Services reside. See Specify Multicast Options for SAS Remote Services.
any Web application server on which a SAS application is deployed. See Specify Multicast Options for Web Application Servers.
configuration for the Report Output Generation tool (if applicable). For information about this tool, see Processing Reports Outside of SAS Web Report Studio.

Specify Multicast Options for SAS Remote Services

You can make changes to the multicast configuration for the Java virtual machine where SAS Remote Services resides. Edit the appropriate file as needed.

On Windows:

If you are running the SAS Remote Services from a command prompt, edit the RemoteServices.bat file.
If you use the Window service, modify the wrapper.conf file located in the SAS-configuration-directory\Lev1\Web\Applications\ directory.

On UNIX and z/OS, edit the RemoteServices.sh file.

Note: Some multicast options for SAS Remote Services are specified in the environment.properties file located in the SAS-configuration-directory\Lev1\Web\Applications\RemoteServices directory. For more information about the environment.properties file, see About the SAS Environment File. [cautionend]

Specify Multicast Options for Web Application Servers

You can make changes to multicast for any Web application server on which a SAS application is deployed. Edit the appropriate files as needed:

JBoss on Windows:

Edit the JBoss\bin\SASServer1.bat file.
If you use the Windows service, modify theJBoss \server\SASServer1\wrapper.conf file.

On UNIX and z/OS, edit the SASServer1.sh file.

For multicast configuration changes to WebLogic or WebSphere application servers, see your product documentation.

Key Multicast Properties

The following table shows some key multicast properties and provides an explanation of these properties.

Multicast Properties
Property	Default Value	Unit	Description
multicast.address	239.X.Y.Z	Not applicable	This value is provided by the SAS Deployment Wizard prompting mechanism and defaults to 239.X.Y.Z, where X, Y, and Z are the last three octets of the metadata server's IP address. In an IP version 6 environment, the value defaults to ff14::/16.
multicast.port	8561	Not applicable	This value is provided by the SAS Deployment Wizard prompting mechanism and represents the port on which UDP communication occurs.
multicast_udp_ip_ttl	1	Decimal. Specifies how far a multicast packet should be forwarded from a sending host. 0 is restricted to the same host. 1 is restricted to the same subnet. 32 is restricted to the same site. 64 is restricted to the same region. 128 is restricted to the same continent. 255 is unrestricted.	The IP multicast routing protocol uses the Time to Live (TTL) field of IP datagrams to decide how far a multicast packet should be forwarded from a sending host. The default TTL for multicast datagrams is 1, which results in multicast packets going only to other hosts in the local network. If all SAS applications participating in the multicast (this includes Remote Services, any Java applications in the middle tier, and BI Report Services) are on the same machine, the value should be 0. If your site has a SAS middle-tier application that resides on a different subnet but uses the same metadata server within the same SAS deployment, increase the value for this property.
multicast.security	Not applicable	Not applicable	By default (with no value), both encryption and authentication are enabled. Valid values are: encrypt: encrypt but do not require authentication none: do not encrypt and do not require authentication
multicast.config.file	Not applicable	URL string (file://, http://, and so on)	By default, a JGroups configuration is provided. However, you can provide your own configuration by specifying the URL path to that configuration. This option enables you to specify a port range or change from IP multicast to the gossip router capabilities of JGroups.

Top of Page