Add_workflow_for_techpubs | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Panel | ||||
---|---|---|---|---|
In this section:
|
Info | ||
---|---|---|
| ||
Related articles: |
The Policy Server object allows you to configure up to 10 policy servers (one local server and nine external policy servers). When an active server becomes congested, the
Spacevars | ||
---|---|---|
|
The
Spacevars | ||
---|---|---|
|
Types of policy server configurations include:
The
Spacevars | ||
---|---|---|
|
Spacevars | ||
---|---|---|
|
The Policy Server global configuration commands are described below. The
Spacevars | ||
---|---|---|
|
Info | ||||
---|---|---|---|---|
| ||||
The
|
Info | ||
---|---|---|
| ||
The DNS query to an Interface Group outside the address context feature adds additional flexibility to query the PSX FQDN with a particular DNS Group. For more information, refer to DNS Support. |
Code Block | ||
---|---|---|
| ||
% set system policyServer globalConfig addressContext <address context name> congestionControl <disabled | enabled> dnsGroup <DNS group server name> dscpProfile <dscpProfileName> ipInterfaceGroup <ipInterfaceGroup_name> ipVar <metavariable name> mgmtInterfaceGroup <mgmtInterfaceGroup_name> reconnectTimeout <1-3600 seconds> sbcGatewayName <SbcGateway Name> switchOverMode <automatic | manual> type <ip | mgmt> |
0 | Table |
---|---|
1 | Policy Server Parameters |
Parameter | Length/Range | Description | ||||
---|---|---|---|---|---|---|
addressContext | 1-23 |
NOTE: This parameter is only configurable (visible from command line) when attribute | ||||
| N/A | When this parameter is enabled, the
| ||||
dnsGroup | N/A | <DNS group name> – The name of the DNS group to associate with the policy server global configuration to allow PSX FQDN resolution with a particular DNS group. | ||||
dscpProfile |
<profile_name> - Name of the DSCP Profile in which DSCP values are configured for HPC and non HPC calls. For more information, refer to DSCP Profile - CLI. | ||||||||||||||
ipInterfaceGroup | 1-23 |
NOTE: This parameter is only configurable once | ||||||||||||
ipVar | 1-255 | Use this parameter to specify a metavariable name (from the PSX’s metavariable table) used to provide an IP address for the
ipVar field is blank, the
NOTE: Use this parameter for
| ||||||||||||
| N/A | Specifies the Management Interface Group to be used for communication with an external PSX. NOTE: If attribute | ||||||||||||
| 1-3600 | Specifies the timeout period in seconds to re-attempt the connection to a policy server that is in the enabled state. Default is 10 seconds. | ||||||||||||
sbcGatewayName | N/A | The SBC Gateway name given to the softswitch. | ||||||||||||
| N/A | Specifies the mode to switch over the policy server to active state. Mode can be:
| ||||||||||||
type | N/A | Interface type supported by the policy server.
|
To set the policy server global configuration using management interface group called "mgmtGroup":
Code Block | ||
---|---|---|
| ||
% set system policyServer globalConfig type mgmt mgmtInterfaceGroup mgmtGroup congestionControl enabled reconnectTimeout 5 switchOverMode automatic |
To set the policy server global configuration using IP Interface Group called "ipInterfaceGroup":
Code Block |
---|
% set system policyServer remoteServer PSXSWE2 state disabled mode outOfService % commit |
Code Block |
---|
% set system policyServer globalConfig type ip addressContext a1 ipInterfaceGroup LIF1 reconnectTimeout 10 switchOverMode automatic congestionControl enabled % commit |
Code Block |
---|
% set system policyServer remoteServer PSXSWE2 state enabled mode active % commit |
To view the policy server global configuration settings with type
as mgmt
:
Code Block | ||
---|---|---|
| ||
% show system policyServer globalConfig reconnectTimeout 5; switchOverMode automatic; congestionControl enabled; type mgmt; mgmtInterfaceGroup mgmtGroup; |
To view the policy server global configuration settings with type
as ip
:
Code Block |
---|
> show system policyServer globalConfig reconnectTimeout 10; switchOverMode automatic; congestionControl disabled; type ip; addressContext a1; ipInterfaceGroup LIF1; |
To view the status of policy server global configuration from system-level mode with type
as mgmt
:
Code Block | ||
---|---|---|
| ||
> show table system policyServer globalConfig reconnectTimeout 5; switchOverMode automatic; congestionControl enabled; type mgmt; mgmtInterfaceGroup mgmtGroup; |
To view the status of policy server global configuration from system-level mode with type
as ip:
Code Block |
---|
> show table system policyServer globalConfig reconnectTimeout 10; switchOverMode automatic; congestionControl disabled; type ip; addressContext a1; ipInterfaceGroup LIF1; |
The Local Policy Server configuration commands are described below.
Code Block | ||
---|---|---|
| ||
% set system policyServer localServer <softswitch_name> action <dryUp | force> keepAliveTimer <1-60 seconds> mode <active | alternate | outOfService | standby> retries <0-32> retryTimer <# milliseconds> state <disabled | enabled> transactionTimer <50-60000 milliseconds> |
Parameter | Length/Range | Description | ||||
---|---|---|---|---|---|---|
| N/A | Specifies the name of the local policy server. | ||||
| N/A | Specifies the method on which queued transactions are processed, when operational state is either standby or out-of-service: | ||||
| 1-60 | Specifies the time interval (in seconds) to wait before issuing a "keepalive" poll to the policy server. This poll is issued only if there is no other policy server activity during this interval. The receipt of any message from the policy server resets the elapsed time to 0. | ||||
| N/A | Specifies the operational state of the local policy server:
NOTE: If two external active policy servers fail and local policy server is in standby mode, the standby local policy server is used as active server until the external policy server becomes active. | ||||
| 0-32 | Specifies the number of retries for any policy server transaction. Must be 0-32, default is 1. | ||||
| N/A | Specifies the time (in milliseconds) for the
| ||||
| N/A | The administrative state of the local policy server.
NOTE: If changing the state, ensure mode is first set to "outofservice". | ||||
| 50-60000 | Time to wait (in milliseconds) for a reply from the initial transaction request. When this timer expires, a transaction retry will be issued. Subsequent retries of this transaction are controlled by |
To set the local policy server configuration:
Code Block | ||
---|---|---|
| ||
% set system policyServer localServer PSX_LOCAL_SERVER action dryUp keepAliveTimer 3 mode standby retries 1 retryTimer 2500 state enabled transactionTimer 2500 |
To view the local policy server configuration settings:
Code Block | ||
---|---|---|
| ||
% show system policyServer localServer localServer PSX_LOCAL_SERVER { state enabled; mode standby; action dryUp; transactionTimer 2500; keepAliveTimer 3; retryTimer 2500; retries 1; } |
To view the status of local policy servers:
Code Block | ||
---|---|---|
| ||
% show table system policyServer localServer KEEP TRANSACTION ALIVE RETRY NAME STATE MODE ACTION TIMER TIMER TIMER RETRIES ------------------------------------------------------------------------------- PSX_LOCAL_SERVER enabled active dryUp 2500 5 2500 1 |
The Remote Policy Server configuration commands are described below.
Include Page | ||||
---|---|---|---|---|
|
Code Block | ||
---|---|---|
| ||
% set system policyServer remoteServer <softswitch_name> action <dryUp | force> fqdn <PSX cluster FQDN> ipAddress 169.254.77.2 <IPv4 or IPv6 address> keepAliveTimer <1-60 seconds> mode <active | alternate | outOfService | maxPolicyServerCount <1-40> mode <active | alternate | outOfService | standby> portNumber <softswitch port number> retries <0-32> retryTimer <# milliseconds> state <disabled | enabled> subPortNumber <port number for subscriber data> transactionTimer <50-60000 milliseconds> % request system policyServer remoteServer <softswitch_name> switchBack |
0 | Table |
---|---|
1 | Command parameters |
Parameter | Length/Range | Description |
---|---|---|
| N/A |
|
| N/A | Use this object to specify the action to take against the policy server.
|
ipAddress
N/A
the IP address.
| 0-256 |
Refer to SBC Support of Multiple PSX Clusters Using PSX Cluster FQDN for feature details. | |||||||||||||||||
| Up to 32 characters |
| |||||||||||||||||
| 1-60 | The time interval (in seconds) to wait before issuing a "keepalive" poll to the policy server. This poll is issued only if there is no other policy server activity during this interval. The receipt of any message from the policy server resets the elapsed time |
to 0 (default = 5). | ||
| 1-40 |
NOTE: This parameter is only visible when |
| N/A | The operational state of |
outofservice
the remote policy server.
|
active
– The remote policy server provides normal query services.
|
alternate
– The remote policy server is not expected to receive any query messages from the Spacevars | ||
---|---|---|
|
Spacevars | ||
---|---|---|
|
| ||
| 1-65535 |
|
| 0-32 |
|
|
N/A
50-60000 |
| ||||
| N/A | Administrative state of the remote policy server. |
NOTE: The mode must be set to ' |
subPortNumber
1-65535
| ||||||
| N/A | Use this parameter with the | ||||
| 50-60000 | The time for
retries setting. (default = 2500). |
To set the remote policy server configuration:
Code Block | ||
---|---|---|
| ||
% set system policyServer remoteServer RS-1 mode outOfService % set system policyServer remoteServer RS-1 ipAddress 169.254.77.2 state enabled |
To view the remote policy server configuration settings:
Code Block | ||
---|---|---|
| ||
% show system policyServer remoteServer remoteServer RS-1 { ipAddress 169.254.77.2; state enabled; mode outOfService; } |
To view the status of remote policy server from top-level CLI mode:
Code Block | ||
---|---|---|
| ||
> show table system policyServer remoteServer KEEP SUB IP PORT TRANSACTION ALIVE RETRY PORT NAME ADDRESS NUMBER STATE MODE ACTION TIMER TIMER TIMER RETRIES NUMBER -------------------------------------------------------------------------------------------- RS-1 169.254.77.2 3055 enabled active dryUp 2500 5 2500 1 3053 |
Use this command to reset the SIP registration count of the remote policy server.
Code Block | ||
---|---|---|
| ||
% request system policyServer remoteServer 5<softswitch_name> 2500 1 3053 |
switchBack |
Parameter | Description |
---|---|
| Use this parameter with the Note that the |
Code Block | ||
---|---|---|
| ||
Code Block | ||
| ||
% request system policyServerremoteServerpolicyServer remoteServer RS-1 switchBack result PASSED |
Info | ||
---|---|---|
| ||
In order to use the 'switchBack' command, the remote policy server must first be configured to allow a manual switchback. |
pagebreak