srvctl update gns

Use the srvctl update gns command to modify a Grid Naming Service (GNS) instance.

Note:

This command is only available with Oracle Clusterware.

Syntax and Parameters

Use the srvctl update gns command with one of these syntax models:

srvctl update gns -advertise name -address ip_address [-timetolive time_to_live]
  [-verbose]

srvctl update gns -delete name [-address address] [-verbose]

srvctl update gns -alias alias -name name [-timetolive time_to_live] [-verbose]

srvctl update gns -deletealias alias [-verbose]

srvctl update gns -createsrv service -target target -protocol protocol 
  [-weight weight] [-priority priority] [-port port_number] 
  [-timetolive time_to_live] [-instance instance_name] [-verbose]

srvctl update gns -deletesrv service_name -target target -protocol protocol
   [-verbose]

srvctl update gns -createtxt name -target target [-timetolive time_to_live]
   [-namettl name_ttl] [-verbose]

srvctl update gns -deletetxt name -target target [-verbose]

srvctl update gns -createptr name -target target [-timetolive time_to_live]
   [-namettl name_ttl] [-verbose]

srvctl update gns -deleteptr name -target target [-verbose]

Table A-210 srvctl update gns Parameters

Parameter Description
-advertise name

Advertise a name through GNS

-address ip_address

The IP address for an advertised name

-timetolive time_to_live

Optionally, you can specify, in seconds, an amount of time for the record to live

-delete name

Remove the advertisement of a name from GNS

-alias alias

Create an alias for an advertised name

-name name

The advertised name associated with the alias

-deletalias alias

Delete an alias

-createsrv service

Create a service that is described by the record

-target target

Specify a name that is associated with the service

-protocol protocol

Specify which protocol is used to connect to the service

-weight weight

Specify the weight of the record

-priority priority

Specify the priority of the record, with a value ranging from 0 to 65535

-port port_number

Specify the port number used to connect to the service, with a value ranging from 0 to 65535

-instance instance_name

Instance name of service

-deletesrv service

Name of the service record to be deleted

-createtxt name

Add a text (TXT) record using the specified name

-namettl name_ttl

Time to live for the name, specified in seconds

-deletetxt name

Delete a text (TXT) record of the specified name

-createptr name

Add a pointer (PTR) record for the specified name

-deleteptr name

Delete a pointer (PTR) record for the specified name

Usage Notes

You must be logged in as the root user on Linux and UNIX platforms, or as an Administrator user on Windows platforms, to run this command.

Example

The following command advertises a name with GNS:

# srvctl update gns -advertise myname -address 192.168.1.45