apps diameter-whitelist
Required Command-Line Mode = Configure
Use the apps diameter-whitelist command to configure diameter forward listing.
The apps diameter-whitelist command has the following syntax:
apps diameter-whitelist alias <diameter whitelist file alias>
add username <username>
create
delete <all | username <username>>
destroy
fetch <add | delete> <URL for a diameter whitelist file>
The following table describes the arguments for the apps diameter-whitelist command:
Argument |
Description |
||||||||||||
diameter-whitelist alias <diameter whitelist file alias> |
Specifies an alias of the forward list file. |
||||||||||||
add username <username> |
Adds a user name entry to a forward list. You can specify up to 15 numeric digits. For example: (config) # apps diameter-whitelist alias dia-wl add username 123456789123456 |
||||||||||||
create |
Creates a new forward list. For example: (config) # apps diameter-whitelist alias dia-wl create To create a forward list, refer to How to Create a Forward List. |
||||||||||||
delete username <username> |
Specifies actions for delete as follows:
When using delete all to delete a forward list, unlike destroy, you do not have to delete the forward list maps, the GigaSMART operation, or disassociate the GigaSMART group from the forward list. Examples: (config) # apps diameter-whitelist alias dia-wl delete username 123456789123456 (config) # apps diameter-whitelist alias dia-wl delete all |
||||||||||||
destroy |
Destroys a forward list. For example: (config) # apps diameter-whitelist alias dia-wl destroy When using destroy to delete a forward list, unlike delete all, you must first delete the forward list maps, the GigaSMART operation, and disassociate the GigaSMART group from the forward list before deleting the forward list. For the procedure to destroy the forward list, refer to How to Delete a Forward List. |
||||||||||||
fetch <add | delete> <URL for a diameter whitelist file> |
Specifies actions for fetch as follows:
To fetch a specified forward list file from a location, use one of the following formats:
For diameter forward listing in a cluster, only fetch the forward list to the leader in the cluster. On member nodes, fetch is not available. Examples: (config) # apps diameter-whitelist alias dia-wl fetch add http://1.1.1.1/tftp/temp/MyIDs1.txt (config) # apps diameter-whitelist alias dia-wl2 fetch add scp://user1:mypw@1.1.1.1:/home/temp/C_ID_file1.txt (config) # apps diameter-whitelist alias dia-wl fetch delete http://1.1.1.1/tftp/temp/MyIDstoDelete.txt (config) # apps diameter-whitelist alias dia-wl fetch delete scp://user1:mypw@1.1.1.1:/home/temp/C_ID_delfile.txt |
How to Create a Forward List
To create a forward list, use the following CLI command sequence:
Task |
Command |
Create the forward list. |
(config) # apps diameter-whitelist alias dia-wl create |
Associate the GigaSMART group to the forward list. |
(config) # gsparams gsgroup gsg1 diameter-whitelist add dia-wl |
Configure the GigaSMART operation. |
(config) # gsop alias dia_wl flow-ops diameter-whitelist lb app diameter metric hashing key username port-list gsg1 |
Add single entries to the whitelist.orFetch and download forward list files. |
(config) # apps diameter-whitelist alias diameter-scp1 add username 123455546666 (config) # apps diameter-whitelist alias diameter-scp1 fetch add http://1.1.1.1/tftp/temp/whitelist1.txt (config) # apps diameter-whitelist alias diameter-scp1 fetch add http://1.1.1.1/tftp/temp/whitelist2.txt |
Create a second level map, the forward list map. When the map configuration is complete, the forward list will take effect. Note: The diameter forward list map does not have any rules. |
(config) # map alias diameter-WL-S11 (config map alias diameter-WL-S11) # type secondLevel flowWhitelist-diameter (config map alias diameter-WL-S11) # from vp1 (config map alias diameter-WL-S11) # use gsop diameter_wl1 (config map alias diameter-WL-S11) # to pg-wl-1 (config map alias diameter-WL-S11) # exit (config) # |
How to Delete a Forward List
To destroy the entire forward list, use the following CLI command sequence:
Task |
Command |
Delete a forward list map. |
(config) # no map alias diameter-WL-S11 |
Delete the GigaSMART operation. |
(config) # no gsop alias diameter_wl1 |
Disassociate the GigaSMART group from the forward list. (You do not need to delete the gsgroup.) |
(config) # gsparams gsgroup gsg1 diameter-whitelist delete |
Destroy () the entire forward list. |
(config) # apps diameter-whitelist alias sip-scp1 destroy |
Related Commands
The following table summarizes other commands related to the apps diameter-whitelist command:
Task |
Command |
Displays a particular user name associated with the GigaSMART group. |
# show gsgroup diameter-whitelist alias gsg1 username 302701237777777 |
Displays the diameter forward list entry count. |
# show apps diameter-whitelist alias diameter-scp count |