The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This module provides the configuration instructions to configure the SOAP LEG.
The SOAP LEG is configured using two configuration files, soap_leg.cfg and soap_pkg.cfg, which reside in the sm-inst-dir/sm/server/root/config directory (sm-inst-dir refers to the SM installation directory). The configuration file is loaded only upon SCMS SM SOAP LEG startup.
The configuration files consist of sections headed by a bracketed section title; for example, [SOAP-LEG] for the SOAP LEG configuration section. Each section consists of one or more parameters having the format parameter=value. The number sign ("#") at the beginning of a line signifies that it is a comment.
The general configuration of the SOAP LEG resides in soap_leg.cfg. The dynamic package association configuration resides in soap_pkg.cfg.
•Configuring the SOAP LEG Settings
•Information about Configuring the Package Association
The [SOAP-LEG] section in the configuration file defines the behavior of the SOAP LEG and contains the following parameters:
•start
Defines whether to start the LEG at SM startup.
Possible values for this parameter are true and false.
The default value is false.
•server_url
The URL of the policy server the LEG will query.
There is no default value.
This parameter must be configured for proper LEG functioning.
•log_failed_queries
Defines whether the LEG will log messages that are issued for failed queries.
Possible values for this parameter are true and false.
The default value is true.
•log_all_queries
Defines whether the LEG will log messages for every query sent and any reply received.
Possible values for this parameter are true and false.
The default value is false.
Note This parameter should only be set to true when troubleshooting.
The [Package] section in the configuration file contains the following parameter:
•pkg_cfg_file
Defines the configuration file to be used by the converter. The path must be relative to the config directory.
The default value is soap_pkg.cfg.
The following example illustrates the SOAP LEG configuration file:
[SOAP-LEG] server_url=http://1.1.1.1:8080/services/QueryServiceSoap.asmx log_failed_queries=true log_all_queries=false [Package] pkg_cfg_file=soap_pkg.cfg
Note The configuration described in this section is optional.
•Configuring the Package Assocation
This configuration file is intended for the customization of the output produced by the SOAP LEG.
The LEG concatenates the data extracted from the configured labels and creates a package name.
To extract the package information data from the SOAP package, the soap_pkg.cfg configuration file must define the conversion map of package-names to the package IDs of the SCA BB application.
The [SOAP.Policy.Package] section of the configuration file contains the following parameters:
•policy_name_format
This parameter is a comma-separated list that specifies the labels that contain the data from which the policy name is comprised. The LEG converter searches for the labels within the received arguments and concatenates them according to the specified order. A value of LABEL_A, LABEL_B indicates that the SOAP LEG needs to concatenate values that reside under the LABEL_A and LABEL_B labels.
There is no default value for this parameter.
•name_seperator_value
Defines the separator value to use when concatenating options.
The default value is '_'.
•default_value
Defines the default value to use when it is not possible to associate the created policy name with any of the configured policy names.
There is no default value for this parameter.
•allow_login_with_no_policy
Defines whether a login can be performed when no policy is found for assignment.
Possible values for this parameter are true or false.
The default value is true.
•policy_property_name
Defines the package property key to use for policy assignment.
The default value is packageId.
Note The policy_property_name parameter is case sensitive and must be written exactly as defined by the SCA BB Console. For example, packageId, upVlinkId, or downVlinkId.
•mapping_table.<key>=<value>
A set of values (key,value) used to map the package information determined by the SOAP LEG and the package ID index that the SCA BB application uses.
Note Every policy name is preceded by the mapping_table. key. For example:
mapping_table.PolicyLabel1=11 mapping_table.PolicyLabel2=12
The [SOAP.Policy Logging] section of the configuration file contains the following parameters:
•log_missing_policy_name
Defines whether log messages will be issued when no policy was found.
Possible values for this parameter are true or false.
The default value is false.
•log_all
Defines whether to write detailed user-log messages for all policy association events.
Possible values for this parameter are true or false.
The default value is false.
Note Set the log_all parameter to true only when troubleshooting.
•log_default_policy_assignment
Defines whether to write a user-log message for every assignment of the default value (as defined in default_value)
Possible values for this parameter are true or false.
The default value is false.
Assuming that the package information appears inside labels TYPE and DOMAIN, configure the order of the labels for the policy name format as follows:
policy_name_format=TYPE,DOMAIN
Assuming that label TYPE (returned as a query reply) contains the type of package (gold, silver, or bronze) and label DOMAIN (passed as an input parameter) contains domain information (the package type has a different meaning in different domains). If the separator value is configured to the default value, configure the package names as follows:
[SOAP.Policy.Package] mapping_table.gold_domain1=11 mapping_table.gold_domain2=12 mapping_table.silver_domain1=13 mapping_table.silver_domain2=14
This configuration means that if the SOAP LEG received a query reply with the value 'gold' under the label "TYPE", and the value 'domain1' was passed to the SOAP LEG by the SM core under the label "DOMAIN", the package ID that will be associated to the subscriber in the SM will have the value 11.
The following is an example of the entire configuration file:
[SOAP.Policy Logging] log_missing_policy_name=false log_all=false log_default_policy_assignment=false [SOAP.Policy.Package] policy_name_format=TYPE,DOMAIN name_seperator_value=_ policy_property_name=packageId # default package configuration default_value=1 allow_login_with_no_policy=false # Mapping table mapping_table.gold_domain1=11 mapping_table.gold_domain2=12 mapping_table.silver_domain1=13 mapping_table.silver_domain2=14
After editing the relevant configuration files, use the following p3sm command-line utility to load the configuration file:
>p3sm --load-config