IceGridAdmin.*
On this page:
IceGridAdmin.AuthenticateUsingSSL
Synopsis
IceGridAdmin.AuthenticateUsingSSL=num
Description
If num
is a value greater than zero, icegridadmin
uses SSL authentication when establishing its session with the IceGrid registry. If not defined or the value is zero, icegridadmin
uses user name and password authentication.
IceGridAdmin.Discovery.Address
Synopsis
IceGridAdmin.Discovery.Address=addr
Description
Specifies the multicast IP address to use for sending multicast discovery queries. If not defined, the default value depends on the setting of Ice.IPv4
: if enabled (the default), the client uses the address 239.255.0.1
, otherwise the client assumes it should use IPv6 and defaults to the address ff15::1
instead. This property is used to compose the value of IceGridAdmin.Discovery.Lookup
.
IceGridAdmin.Discovery.Interface
Synopsis
IceGridAdmin.Discovery.Interface=intf
Description
Specifies the IP address of the interface to use for sending multicast discovery queries. If not defined, the discovery will use all the network interfaces available on the system to send UDP multicast datagrams. This property is used to compose the value of IceGridAdmin.Discovery.Lookup
and IceGridAdmin.Discovery.Reply.Endpoints
.
IceGridAdmin.Discovery.Lookup
Synopsis
IceGridAdmin.Discovery.Lookup=endpoints
Description
Specifies the endpoints that the client uses to send multicast discovery queries. If not defined, the endpoint is composed as follows:
udp -h addr -p port [--interface intf]
where addr
is the value of IceGridAdmin.Discovery.Address
, port
is the value of IceGridAdmin.Port
, and intf
is the value of IceGridAdmin.Discovery.Interface
. If multiple endpoints are defined, the queries will be sent on each endpoint.
IceGridAdmin.Discovery.Reply.AdapterProperty
Synopsis
IceGridAdmin.Discovery.Reply.AdapterProperty=value
Description
The client creates an object adapter named IceGridAdmin.Discovery.Reply
for receiving replies to multicast discovery queries. If not otherwise defined by IceGridAdmin.Discovery.Reply.Endpoints
, the endpoint for this object adapter is composed as follows:
udp [-h intf]
where intf
is the value of IceGridAdmin.Discovery.Interface
. A fixed port is not necessary for this endpoint.
You don't normally need to set other properties for this object adapter.
IceGridAdmin.Host
Synopsis
IceGridAdmin.Host=host
Description
When used together with IceGridAdmin.Port
, icegridadmin
connects directly to the target registry at the specified host and port.
IceGridAdmin.InstanceName
Synopsis
IceGridAdmin.InstanceName=name
Description
Specifies the name of an IceGrid instance to which icegridadmin
will connect.
When using multicast discovery, you can define this property to limit your discovery results only to those locators deployed for the given instance, in case you have multiple unrelated IceGrid instances deployed that use the same multicast address and port.
IceGridAdmin.Password
Synopsis
IceGridAdmin.Password=password
Description
Specifies the password that icegridadmin
should use when authenticating its session with the IceGrid registry. For security reasons you may prefer not to define a password in a plain-text configuration property, in which case you should omit this property and allow icegridadmin
to prompt you for it interactively. This property is ignored when SSL authentication is enabled via IceGridAdmin.AuthenticateUsingSSL
.
IceGridAdmin.Port
Synopsis
IceGridAdmin.Port=port
Description
When used together with IceGridAdmin.Host
, icegridadmin
connects directly to the target registry at the specified host and port.
When using multicast discovery, this property specifies the port to use for sending multicast discovery queries. This property is also used to compose the value of IceGridAdmin.Discovery.Lookup
.
If not set, the default value is 4061
.
IceGridAdmin.Replica
Synopsis
IceGridAdmin.Replica=name
Description
Specifies the name of the registry replica that icegridadmin
should contact. If not defined, the default value is Master
.
IceGridAdmin.Server.AdapterProperty
Synopsis
IceGridAdmin.Server.AdapterProperty=value
Description
When icegridadmin
is started with the --server
option, icegridadmin
creates an object adapter named IceGridAdmin.Server
to host its file parser object. adapter properties can be used to configure this object adapter. When IceGridAdmin.Server.Endpoints
is left unset, icegridadmin
uses "tcp -h localhost"
for these endpoints.
IceGridAdmin.Trace.Observers
Synopsis
IceGridAdmin.Trace.Observers=num
Description
If num
is a value greater than zero, IceGrid GUI displays trace information about the observer callbacks it receives from the registry. If not defined, the default value is zero.
IceGridAdmin.Trace.SaveToRegistry
Synopsis
IceGridAdmin.Trace.SaveToRegistry=num
Description
If num
is a value greater than zero, IceGrid GUI displays trace information about the modifications it commits to the registry. If not defined, the default value is zero.
IceGridAdmin.Username
Synopsis
IceGridAdmin.Username=name
Description
Specifies the username that icegridadmin
should use when authenticating its session with the IceGrid registry. This property is ignored when SSL authentication is enabled via IceGridAdmin.AuthenticateUsingSSL
.