Service Definitions

A service definition is a high-level, platform-independent template that defines a service that you want to let your subscribers use. You use the JunosE Software’s embedded macro language on your computer to create the macro file that defines the service. You copy and install the macro file on the E Series Broadband Services Routers, and then you can associate the service definition with subscribers to create their service sessions.

Service definitions gives you flexibility by enabling you to use:

• A single service definition to create a service for multiple subscribers.
• Parameterized service definitions to create variations of a service definition.
• Different service definitions to create multiple services for a single subscriber.

A service definition might use the following types of JunosE objects to define the characteristics and capabilities of the service you want to provide:

• Interface profiles—Specify a set of characteristics that can be dynamically assigned to IP interfaces. A service definition must use at least one interface profile.
• Policy lists—Specify policy actions for traffic traversing an interface.
• Classifier lists—Specify the criteria by which the router defines a packet flow.
• Rate-limit profiles—Specify a set of bandwidth attributes and associated actions that limit a classified packet flow or a source interface to a rate that is less than the physical rate of the port.
• QoS parameters—Specify attributes such as shaping rate, shared-shaping rate, assured rate, and scheduler weight for scheduler nodes and queues.
• QoS profiles—Specify queue, drop statistics gathering, and scheduler configuration for an interface hierarchy.

Creating Service Definitions

To create a service definition, you use the JunosE Software’s macro language to specify the parameters that define the desired service. A macro file can define only one service—however, the file can have multiple templates to define characteristics of the desired service. You create service definitions independent of the Service Manager commands and operations, which are performed on the E Series router.

For detailed information about the JunosE Software’s macro language, see the Command Line Interface chapter in JunosE System Basics Configuration Guide.

Figure 29 is an example of a service definition macro file that creates a tiered service. A tiered service typically provides set bandwidths for both inbound and outbound traffic for a subscriber. In this example, the input (inputBW) and output (outputBW) bandwidth values are parameterized. This example assumes that QoS profile triplePlayIP and QoS parameter maxSubscBW are configured. See Service Definition Examples for additional service definition examples.

Service Manager only tracks JunosE objects that are passed back in the env.setResult method when a service definition is executed. Table 141 describes the supported objects:

Figure 29: Sample Service Definition Macro File

Managing Your Service Definitions

After you have created the macro file for your service definition, you can perform the following operations with the service definition macro file:

1. Copy—You must copy the service definition from the local computer that you used to create the macro file to the router’s NVS card.
2. Install—You must install the service definition before you can use it to create a service session. During installation, Service Manager precompiles the definition and extracts the definition file’s timestamp. Precompiling the service definition improves Service Manager performance. The timestamp enables the Service Manager application to track any modifications you might make while the definition is being used.
3. Uninstall—You can uninstall a service definition file, for example, if you no longer want to use that definition. When you uninstall a service definition file, any existing service sessions that were activated using the original service definition continue to use the original definition until you deactivate the service session.
4. Modify—You can update an existing service definition file at any time. To update a service definition file:
   1. Use your text editor on your computer to make changes to the original service definition file.
   2. Copy the updated service definition file back to your router’s NVS—this overwrites the original file on the router.
   3. Install the new service definition file.

   All new service sessions will be activated using the new service definition. Any existing service sessions that were activated using the original service definition continue to use the original definition until you deactivate the service session.