admin@glassfish.java.net

Re: create-cluster options multicastport, multicastaddress

From: Jennifer Chou <jennifer.chou_at_oracle.com>
Date: Thu, 22 Jul 2010 15:17:56 +0100

Unless I'm doing something wrong it appears that hearbeataddress and
heartbeatport were not options on create-cluster in v2.x?
I have v2.1.1 installed and when I try create-cluster with those
options, it says it does not apply.

C:\glassfishv2.1.1\glassfish\bin>asadmin create-cluster --port 6868
--heartbeataddress asda
Usage: create-cluster [--terse=false] [--echo=false]
[--interactive=true] [--host localhost] [--port 4848|4849]
[--secure|-s=true] [--user admin_user] [--passwo
rdfile file_name] [--config config_name] [--systemproperties
(name=value)[:name=value]*] [--hosts hadb-host-list] [--haagentport
port_number] [--haadminpassword
 password] [--haadminpasswordfile file_name] [--devicesize devicesize]
[--haproperty (name=value)[:name=value]*] [--autohadb=false] [--portbase
port-number] cluster_name
CLI013 Option heartbeataddress does not apply to create-cluster.

C:\glassfishv2.1.1\glassfish\bin>asadmin create-cluster --port 6868
--heartbeatport asda clos
Usage: create-cluster [--terse=false] [--echo=false]
[--interactive=true] [--host localhost] [--port 4848|4849]
[--secure|-s=true] [--user admin_user] [--passwo
rdfile file_name] [--config config_name] [--systemproperties
(name=value)[:name=value]*] [--hosts hadb-host-list] [--haagentport
port_number] [--haadminpassword
 password] [--haadminpasswordfile file_name] [--devicesize devicesize]
[--haproperty (name=value)[:name=value]*] [--autohadb=false] [--portbase
port-number] cluster_name
CLI013 Option heartbeatport does not apply to create-cluster.

On 7/22/2010 4:59 AM, Joseph Fialli wrote:
>
>
> On 7/21/10 10:59 PM, Nazrul Islam wrote:
>> Hi Joe,
>>
>> Please confirm that v2.x has these two options in create-cluster
>> command:
>> --multicastaddress and --multicastport
>
> In v2.x, the values were called heartbeataddress and heartbeatport.
> We introduced multicastaddress and multicastport in v3.1, so they
> could not have been documented in v2.x.
>
> Now I must admit I can not find any v2.x documentation on
> --heartbeataddress and --heartbeatport. But past emails and
> current GFv3.1 Cluster.java led us to believe that they were
> valid options in v2.x.
>
> -Joe
>>
>> Based on v2.1.1 documentation
>> <http://docs.sun.com/app/docs/doc/821-0179/create-cluster-1?l=en&a=view>,
>> it was not there. Is this a bug?
>> --
>> Nazrul Islam - (408) 276-6468 - Oracle
>>
>>
>>
>> Jennifer Chou wrote:
>>> Thanks I have updated the spec with the usage. So
>>> --heartbeadaddress and --heartbeatport were options on
>>> create-cluster in v2.x?
>>>
>>> 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
>>>
>>>
>>> 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
>>>>>
>>