On 7/21/10 9:37 AM, Jennifer Chou wrote:
> Thanks I have updated the spec with the usage. So --heartbeadaddress
> and --heartbeatport were options on create-cluster in v2.x?
I was lead to believe that. But since they were not documented, I am
uncertain now.
We have the following support in GF v3.1 asadmin create-cluster based on
the feedback that these were legal options in past.
The code below makes it so GF v3.1 asadmin create-cluster would accept
deprecated options --heartbeataddress and --heartbeatport.
/**
* Sets the value of the gmsMulticastPort property.
*
* @param value allowed object is
* {_at_link String }
* @throws PropertyVetoException if a listener vetoes the change
*/
@Param(name="multicastport", optional=true, alias="heartbeatport")
void setGmsMulticastPort(String value) throws PropertyVetoException;
/**
* Sets the value of the gmsMulticastAddress property.
*
* @param value allowed object is
* {_at_link String }
* @throws PropertyVetoException if a listener vetoes the change
*/
@Param(name="multicastaddress", optional=true,
alias="heartbeataddress")
void setGmsMulticastAddress(String value) throws PropertyVetoException;
Perhaps it is a misunderstanding that --heartbeatport and
--heartbeataddress were
valid options for gf v2.x.
All I know is that for ease of use, it is good to use the defaults.
For production systems, it is best to explicitly specify and manage
which multicast address and ports
are being used.
-Joe
>
> Usage: create-cluster
> [--config <config>]
> [--systemproperties (name=value)[:name=name]*]
> [--multicastport <multicastport>]
> [--multicastaddress <multicastaddress>]
> cluster_name
>
> You may want to add @Pattern(regexp= for the multicastaddress
Agree. Will figure out how to do that and add it to enforce only valid
values.
Joe
>
>
> On 7/21/2010 1:00 PM, Joseph Fialli wrote:
>> Jennifer,
>>
>> They should be documented.
>>
>> --multicastaddress and --multicastport are used to broadcast messages
>> to all instances in the cluster.
>> GMS uses it to monitor health of instances in the cluster.
>>
>> --multicastaddress is a renaming of undocumented v2.x --heartbeataddress
>> It must be a valid multicast address in the range from 224.0.0.0
>> through 239.255.255.255,
>> When this parameter is not specified, the create-cluster command
>> generate a multicast address of "228.9.XX.YY" where XX and YY are
>> independent
>> values between 0..255.
>>
>> --multicastport is a renaming of undocumented v2.1 --heartbeatport
>> Valid values are from 2048 to 32000. When this parameter is not
>> specified,
>> we generate a value between the valid ranges mentioned above.
>>
>> For ease of use, these parameters being optional and generation of
>> these values is a good thing.
>>
>> However, for an administrator, they would prefer to control this.
>> So it is best to document so it is easier for them to do it.
>>
>> -Joe
>>
>> On 7/20/10 11:08 PM, Jennifer Chou wrote:
>>> Hi Joe, Bobby,
>>>
>>> We're trying to finalize the usage of the commands in the design
>>> spec:
>>> http://wikis.sun.com/display/GlassFish/V3.1Clustering#V3.1Clustering-ClusterAdminCommands
>>>
>>> I wanted to verify if these options should be added for
>>> create-cluster in 3.1: --multicastport and --multicastaddress ?
>>> They are not in the v2.1.1 doc
>>> http://docs.sun.com/app/docs/doc/821-0179/create-cluster-1?l=en&a=view
>>>
>>> create-cluster:
>>> Usage: asadmin [asadmin-utility-options] create-cluster
>>> [--config <config>]
>>> [--properties <properties>] [--systemproperties
>>> <systemproperties>]
>>> [--multicastport <multicastport>]
>>> [--multicastaddress <multicastaddress>]
>>> [-?|--help[=<help(default:false)>]]
>>> cluster_name
>>>
>>> Thanks,
>>> Jennifer
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: admin-unsubscribe_at_glassfish.dev.java.net
>>> For additional commands, e-mail: admin-help_at_glassfish.dev.java.net
>>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: admin-unsubscribe_at_glassfish.dev.java.net
>> For additional commands, e-mail: admin-help_at_glassfish.dev.java.net
>>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: admin-unsubscribe_at_glassfish.dev.java.net
> For additional commands, e-mail: admin-help_at_glassfish.dev.java.net
>