<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> <HTML> <HEAD> <META NAME="GENERATOR" CONTENT="LinuxDoc-Tools 0.9.21"> <TITLE>OpenH323 Gatekeeper - The GNU Gatekeeper: RAS Configuration</TITLE> <LINK HREF="manual-8.html" REL=next> <LINK HREF="manual-6.html" REL=previous> <LINK HREF="manual.html#toc7" REL=contents> </HEAD> <BODY> <A HREF="manual-8.html">Next</A> <A HREF="manual-6.html">Previous</A> <A HREF="manual.html#toc7">Contents</A> <HR> <H2><A NAME="s7">7.</A> <A HREF="manual.html#toc7">RAS Configuration</A></H2> <H2><A NAME="gwprefixes"></A> <A NAME="ss7.1">7.1</A> <A HREF="manual.html#toc7.1">Section [RasSrv::GWPrefixes]</A> </H2> <P>This section lists what E.164 numbers are routed to a specific gateway.</P> <P> <DL> <DT><B>Format:</B><DD><P><CODE>gw-alias=prefix[:=priority][,prefix[:=priority],...]</CODE></P> <P>Note you have to specify the alias of the gateway. If a gateway registered with the alias, all numbers beginning with the prefixes are routed to this gateway. Special characters <CODE>.</CODE> and <CODE>!</CODE> can be used here to match any digit and disable the prefix. A priority can be given to each prefix for each gateway (using := syntax), so in case of several gateways match the dialed number, the one with the highest prefix priority will be selected to route the call (when the ActivateFailover switch is ON call will be routed to all selected gateways in order of the prefix priority). The smaller value corresponds to the higher priority. Default value is 1. In case when prefix priority intersectes with GatewayPriority (see section <A HREF="manual-11.html#epconfig">[EP::...]</A>) prefix one is preferred.</P> <DT><B>Example:</B><DD><P><CODE>test-gw=02,03:=3,04.:=1</CODE></P> </DL> </P> <H2><A NAME="ss7.2">7.2</A> <A HREF="manual.html#toc7.2">Section [RasSrv::PermanentEndpoints]</A> </H2> <P>In this section you can put endpoints that don't have RAS support or that you don't want to be expired. The records will always keep in registration table of the gatekeeper. However, You can still unregister it via status port. Special characters <CODE>.</CODE> and <CODE>!</CODE> can be used with prefixes here to match any digit and disable the prefix. You may use := syntax to set a prefix priority in the same manner as in <A HREF="#gwprefixes">[RasSrv::GWPrefixes]</A> section. <DL> <DT><B>Format:</B><DD><P><CODE>IP[:port]=alias[,alias,...;prefix[:=priority][,prefix[:=priority]]...]</CODE></P> <DT><B>Example:</B><DD><P>For gateway, <BLOCKQUOTE> <CODE>10.0.1.5=Citron;009,008:=2,0.7:=3</CODE> </BLOCKQUOTE> For terminal, <BLOCKQUOTE> <CODE>10.0.1.10:1720=700</CODE> </BLOCKQUOTE> </P> </DL> </P> <H2><A NAME="ss7.3">7.3</A> <A HREF="manual.html#toc7.3">Section [RasSrv::RRQFeatures]</A> </H2> <P> <UL> <LI><CODE>AcceptEndpointIdentifier=1</CODE><BR> Default: <CODE>1</CODE><BR> <P>Whether to accept <B>endpointIdentifier</B> specified in a full RRQ.</P> </LI> <LI><CODE>AcceptGatewayPrefixes=1</CODE><BR> Default: <CODE>1</CODE><BR> <P>A gateway can register its prefixes with the gatekeeper by containing <B>supportedPrefixes</B> in the <B>terminalType</B> field of RRQ. This option defines whether to accept the specified prefixes of a gateway.</P> </LI> <LI><CODE>OverwriteEPOnSameAddress=1</CODE><BR> Default: <CODE>0</CODE><BR> <P>In some networks an endpoint's IP address may change unexpectedly. This may happen when an endpoint is using a PPP connection (e.g. modem or ADSL). This option defines how to handle a registration request (RRQ) from an IP address which does not match what we have stored. The default action is to reject the request. With this option enabled the conflicting request will cause an unregister request (URQ) to be sent for the existing IP address and the entry to be removed allowing the endpoint to register with the new address.</P> </LI> <LI><CODE>IRQPollCount=0</CODE><BR> Default: <CODE>1</CODE><BR> <P>When the gatekeeper does not receive a keep-alive RRQ from an endpoint within TimeToLive time period, it sends an IRQ message to "poll" the endpoint and check if it is alive. After IRQPollCount messages are sent and no reply is received, the endpoint is unregistered. To disable this feature (and unregister endpoints immediately after TimeToLive timeout), set this variable to 0. IRQ poll interval is 60 seconds.</P> </LI> <LI><CODE>SupportDynamicIP=1</CODE><BR> Default: <CODE>0</CODE><BR> <P>When the IP address of an endpoint changes, the gatekeeper can maintain registration. This will force the EP to fully reregister if the IP Address changes. </P> </LI> </UL> </P> <H2><A NAME="ss7.4">7.4</A> <A HREF="manual.html#toc7.4">Section [RasSrv::ARQFeatures]</A> </H2> <P> <UL> <LI><CODE>ArjReasonRouteCallToGatekeeper=1</CODE><BR> Default: <CODE>1</CODE><BR> <P>If yes, the gatekeeper rejects an answered ARQ without a pre-existing CallRec found in the CallTable by reason <B>routeCallToGatekeeper</B> in routed mode. The endpoint shall release the call immediately and re-send call Setup to the gatekeeper.</P> </LI> <LI><CODE>CallUnregisteredEndpoints=0</CODE><BR> Default: <CODE>1</CODE><BR> <P>With this option set on, the gatekeeper will accept an ARQ from a registered endpoint with <B>destCallSignalAddress</B>, no matter the address is belongs to a registered endpoint or not. That means you can explicitly specify the IP of endpoint (registered or not) you want to call.</P> </LI> <LI><CODE>RemoveTrailingChar=#</CODE><BR> Default: <CODE>N/A</CODE><BR> <P>Specify the trailing character to be removed in <B>destinationInfo</B>. For example, if your endpoint incorrectly contains the termination character like `#' in <B>destinationInfo</B>, you may remove it by this option.</P> </LI> <LI><CODE>RoundRobinGateways=0</CODE><BR> Default: <CODE>1</CODE><BR> <P>Enable/disable round-robin gateway selection, if more than one gateway matches a dialed number. If disabled, the first available gateway will be selected. Otherwise, subsequent calls will be sent to gateways in round-robin fashion.</P> </LI> </UL> </P> <H2><A NAME="ss7.5">7.5</A> <A HREF="manual.html#toc7.5">Section [NATedEndpoints]</A> </H2> <P>The gatekeeper can automatically detect whether an endpoint is behind NAT. However, if the detection fails, you can specify it manually in this section.</P> <P> <DL> <DT><B>Format:</B><DD><P><CODE>alias=true,yes,1,...</CODE></P> <DT><B>Example:</B><DD><P>Specify an endpoint with alias 601 is behind NAT. <BLOCKQUOTE> <CODE>601=true</CODE> </BLOCKQUOTE> </P> </DL> </P> <HR> <A HREF="manual-8.html">Next</A> <A HREF="manual-6.html">Previous</A> <A HREF="manual.html#toc7">Contents</A> </BODY> </HTML>
