Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation
Guide That Contains This Content
[+] Expand All
[-] Collapse All

    Configuring SIC Service Templates (SRC CLI)

    Service templates are used to specify any services that you want to enable for your router. What services are available vary from router to router, so it is important that you understand the properties of your router to successfully implement custom services.

    When you configure a service template, you need to specify the mode, and any variables or attributes you want included in the template.

    Refer to Device and Service Template Configuration Overview (SRC CLI) for details on configuring the options in the following procedure.

    Creating an SIC Service Template (SRC CLI)

    Use the following statements to create an SIC service template:

    shared sic group identifier device-template id service-template name {description description;}

    To create an SIC service template:

    1. From configuration mode, access the statement that configures the service template and specify the name of the template.
      [edit]user@host# edit shared sic group identifier device-template id service-template name

      For example, to specify a service template called st1:

      [edit]user@host# edit shared sic group g1 device-template dt1 service-template st1
    2. (Optional) Specify a description for the template.
      [edit shared sic group g1 device-template dt1 service-template st1]user@host# set description description

    Configuring the Mode of the SIC Service Template (SRC CLI)

    Use the following statements to configure the mode of service template:

    shared sic group identifier device-template id service-template name mode (activation | deactivation | initial-authorization | service-correlation-id | service-profile-download)

    To configure the mode of the SIC service template:

    • From configuration mode, access the statement that configures the service template mode. For example, to specify the activation mode:
      [edit]user@host# edit shared sic group g1 device-template dt1 service-template st1 mode activation

    Configuring Variables for the SIC Service Template (SRC CLI)

    Variables control the behavior of the rendering process.

    Use the following statements to configure service template variables:

    shared sic group identifier device-template id service-template name mode (activation | deactivation | initial-authorization | service-correlation-id | service-profile-download) variable name {value value;type (integer | string);}

    To configure variables in the service template:

    1. From configuration mode, access the statement that configures variables for the service template and specify a name for the variable. For example, to create a variable named var1:
      [edit]user@host# edit shared sic group g1 device-template dt1 service-template st1 mode activation variable var1

      Specify the type of variable you want to add to the template. For example, to specify an integer for the variable:

      [edit shared sic group g1 device-template dt1 service-template st1 mode activation variable var1]user@host# set type integer

      Where the type is either:

      • integer
      • string
    2. Specify the value of the variable. For example, to specify a value of 5 for the variable:
      [edit shared sic group g1 device-template dt1 service-template st1 mode activation variable var1]user@host# set value 5

    Configuring Normal Attributes for the SIC Service Template (SRC CLI)

    shared sic group identifier device-template id service-template name mode (activation | deactivation | initial-authorization | service-correlation-id | service-profile-download) attributes {}
    shared sic group identifier device-template id service-template name mode (activation | deactivation | initial-authorization | service-correlation-id | service-profile-download) attributes attribute id
    shared sic group identifier device-template id service-template name mode (activation | deactivation | initial-authorization | service-correlation-id | service-profile-download) attributes attribute id normal {name name;copy-from copy-from;}

    To configure normal attributes to be included in the service template:

    1. (Optional) From configuration mode, access the statement that configures normal attributes and specify an identifier for the attribute. For example, to create an identifier named attr1:
      [edit]user@host# edit shared sic group g1 device-template dt1 service-template st1 mode activation attributes attribute attr1
    2. (Optional) Specify the attribute as a normal attribute.
      [edit shared sic group g1 device-template dt1 service-template st1 mode activation attributes attribute attr1]user@host# edit normal
    3. Specify the name of the attribute. For example, to specify the attribute Unisphere-Service-Timeout:
      [edit shared sic group g1 device-template dt1 service-template st1 mode activation attributes attribute attr1 normal]user@host# set name Unisphere-Service-Timeout
    4. (Optional) Specify the attribute to copy the value from. For example, to copy the value from the Session-Timeout attribute contained in the downstream AAA server response, and place it in the Unisphere-Service-Timeout attribute:
      [edit shared sic group g1 device-template dt1 service-template st1 mode activation attributes attribute attr1 normal]user@host# set copy-from Session-Timeout
    5. Verify the configuration.
      [edit shared sic group g1 device-template dt1 service-template st1 mode activation attributes attribute attr1 normal]user@host# show
      copy-from Session-Timeout;
      name Unisphere-Service-Timeout;
      
      [edit shared sic group g1 device-template dt1 service-template st1 mode activation attributes attribute attr1 normal]
      user@host#
      

    Configuring Required Attributes for the SIC Service Template (SRC CLI)

    With required attributes, if the renderer finds the attribute in the downstream AAA server response, it copies the value into the RADIUS message for the router, otherwise, rendering fails.

    shared sic group identifier device-template id service-template name mode (activation | deactivation | initial-authorization | service-correlation-id | service-profile-download) attributes {}
    shared sic group identifier device-template id service-template name mode (activation | deactivation | initial-authorization | service-correlation-id | service-profile-download) attributes attribute id
    shared sic group identifier device-template id service-template name mode (activation | deactivation | initial-authorization | service-correlation-id | service-profile-download) attributes attribute id required {name name;copy-from copy-from;}

    To configure required attributes to be included in the service template:

    1. (Optional) From configuration mode, access the statement that configures required attributes and specify an identifier for the attribute. For example, to create an identifier named attr1:
      [edit]user@host# edit shared sic group g1 device-template dt1 service-template st1 mode activation attributes attribute attr1
    2. (Optional) Specify the attribute as a required attribute.
      [edit shared sic group g1 device-template dt1 service-template st1 mode activation attributes attribute attr1]user@host# edit required
    3. Specify the name of the attribute. For example, to specify the attribute Unisphere-Service-Timeout:
      [edit shared sic group g1 device-template dt1 service-template st1 mode activation attributes attribute attr1 required]user@host# set name Unisphere-Service-Timeout
    4. (Optional) Specify the attribute to copy the value from. For example, to copy the value from the Session-Timeout attribute contained in the downstream AAA server response, and place it in the Unisphere-Service-Timeout attribute:
      [edit shared sic group g1 device-template dt1 service-template st1 mode activation attributes attribute attr1 required]user@host# set copy-from Session-Timeout
    5. Verify the configuration.
      [edit shared sic group g1 device-template dt1 service-template st1 mode activation attributes attribute attr1 required]user@host# show
      copy-from Session-Timeout;
      name Unisphere-Service-Timeout;
      
      [edit shared sic group g1 device-template dt1 service-template st1 mode activation attributes attribute attr1 required]
      user@host#
      

    Configuring Default Attributes for the SIC Service Template (SRC CLI)

    With default attributes, if the renderer finds the attribute in the downstream AAA server response, it copies the value into the RADIUS message. Otherwise, it creates the attribute name with the specified value.

    shared sic group identifier device-template id service-template name mode (activation | deactivation | initial-authorization | service-correlation-id | service-profile-download) attributes {}
    shared sic group identifier device-template id service-template name mode (activation | deactivation | initial-authorization | service-correlation-id | service-profile-download) attributes attribute id
    shared sic group identifier device-template id service-template name mode (activation | deactivation | initial-authorization | service-correlation-id | service-profile-download) attributes attribute id default {name name;value value;copy-from copy-from;}

    To configure default attributes to be included in the service template:

    1. (Optional) From configuration mode, access the statement that configures default attributes and specify an identifier for the attribute. For example, to create an identifier named attr1:
      [edit]user@host# edit shared sic group g1 device-template dt1 service-template st1 mode activation attributes attribute attr1
    2. (Optional) Specify the attribute as a default attribute.
      [edit shared sic group g1 device-template dt1 service-template st1 mode activation attributes attribute attr1]user@host# edit default
    3. Specify the name of the attribute. For example, to specify the attribute Unisphere-Service-Timeout:
      [edit shared sic group g1 device-template dt1 service-template st1 mode activation attributes attribute attr1 default]user@host# set name Unisphere-Service-Timeout
    4. Specify the value of the attribute. For example, to specify the value of 5:
      [edit shared sic group g1 device-template dt1 service-template st1 mode activation attributes attribute attr1 default]user@host# set value 5
    5. (Optional) Specify the attribute to copy the value from. For example, to copy the value from the Session-Timeout attribute contained in the downstream AAA server response, and place it in the Unisphere-Service-Timeout attribute:
      [edit shared sic group g1 device-template dt1 service-template st1 mode activation attributes attribute attr1 default]user@host# set copy-from Session-Timeout

      If the rendering process finds the attribute in the downstream AAA server response, it copies the value into the RADIUS message. Otherwise, it creates the attribute name with the specified value.

    6. Verify the configuration.
      [edit shared sic group g1 device-template dt1 service-template st1 mode activation attributes attribute attr1 default]user@host# show
      copy-from Session-Timeout;
      name Unisphere-Service-Timeout;
      value 5;
      
      [edit shared sic group g1 device-template dt1 service-template st1 mode activation attributes attribute attr1 default]
      user@host#
      

    Configuring Parameterized Attributes for the SIC Service Template (SRC CLI)

    shared sic group identifier device-template id service-template name mode (activation | deactivation | initial-authorization | service-correlation-id | service-profile-download) attributes {}
    shared sic group identifier device-template id service-template name mode (activation | deactivation | initial-authorization | service-correlation-id | service-profile-download) attributes attribute id
    shared sic group identifier device-template id service-template name mode (activation | deactivation | initial-authorization | service-correlation-id | service-profile-download) attributes attribute id parameterized {format format;name name;}

    To configure parameterized attributes to be included in the service template:

    1. (Optional) From configuration mode, access the statement that configures parameterized attributes and specify an identifier for the attribute. For example, to create an identifier named attr1:
      [edit]user@host# edit shared sic group g1 device-template dt1 service-template st1 mode activation attributes attribute attr1
    2. (Optional) Specify the attribute as a parameterized attribute.
      [edit shared sic group g1 device-template dt1 service-template st1 mode activation attributes attribute attr1]user@host# edit parameterized
    3. Specify the format of the parameterized attribute.
      [edit shared sic group g1 device-template dt1 service-template st1 mode activation attributes attribute attr1 parameterized]user@host# set format format
    4. Specify the name of the attribute.
      [edit shared sic group g1 device-template dt1 service-template st1 mode activation attributes attribute attr1 parameterized]user@host# set name name
    5. Verify the configuration.
      [edit shared sic group g1 device-template dt1 service-template st1 mode activation attributes attribute attr1 parameterized]user@host# show
      copy-from Session-Timeout;
      name Unisphere-Service-Timeout;
      
      [edit shared sic group g1 device-template dt1 service-template st1 mode activation attributes attribute attr1 parameterized]
      user@host#
      

    Configuring Override Attributes for the SIC Service Template (SRC CLI)

    With override attributes, whether or not the renderer finds the attribute in the downstream AAA server response, it creates the attribute name with the specified value.

    shared sic group identifier device-template id service-template name mode (activation | deactivation | initial-authorization | service-correlation-id | service-profile-download) attributes {}
    shared sic group identifier device-template id service-template name mode (activation | deactivation | initial-authorization | service-correlation-id | service-profile-download) attributes attribute id
    shared sic group identifier device-template id service-template name mode (activation | deactivation | initial-authorization | service-correlation-id | service-profile-download) attributes attribute id override {name name;value value;}

    To configure override attributes to be included in the service template:

    1. (Optional) From configuration mode, access the statement that configures override attributes and specify an identifier for the attribute. For example, to create an identifier named attr1:
      [edit]user@host# edit shared sic group g1 device-template dt1 service-template st1 mode activation attributes attribute attr1
    2. (Optional) Specify the attribute as an override attribute.
      [edit shared sic group g1 device-template dt1 service-template st1 mode activation attributes attribute attr1]user@host# edit override
    3. Specify the name of the override attribute. For example, to specify the attribute Unisphere-Service-Timeout:
      [edit shared sic group g1 device-template dt1 service-template st1 mode activation attributes attribute attr1 override]user@host# set name Unisphere-Service-Timeout
    4. Specify the value of the attribute. For example, to specify a value of 5:
      [edit shared sic group g1 device-template dt1 service-template st1 mode activation attributes attribute attr1 override]user@host# set value 5
    5. Verify the configuration.
      [edit shared sic group g1 device-template dt1 service-template st1 mode activation attributes attribute attr1 override]user@host# show
      name Unisphere-Service-Timeout;
      value 5;
      
      [edit shared sic group g1 device-template dt1 service-template st1 mode activation attributes attribute attr1 override]
      user@host#
      

    Modified: 2016-12-29