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.

copy

• Use to copy a service definition macro file from your computer to the router’s NVS.
• Specify the directory containing the macro file you want to copy and the name you want to use for the file in NVS.
• Example

  host1#copy boston:/serviceDefs/triplePlay/tiered.mac tiered.mac

• There is no no version.
• See copy

service-management install

• Use to install or uninstall a service definition.
• You must include the .mac extension.
• During installation, Service Manager precompiles the service definition and extracts the definition file’s timestamp.
• After you install the service definition, you can use the definition to create service sessions for subscribers.
• To update an existing service definition, you make changes to the original macro file on your computer, copy the updated file to NVS, and install the updated file. All subsequent service sessions use the new service definition file. However, currently active service sessions continue to use the original definition file until the sessions are deactivated, then reactivated.
• Example 1—Installing

  host1(config)#service-management install tiered.mac

• Example 2—Uninstalling

  host1(config)#no service-management install tiered.mac

• Example 3—Updating

  ! update the original macro file on the remote system

  ! copy the updated macro file to the router

  host1#copy boston:/serviceDefs/triplePlay/tiered.mac tiered.mac

  host1#configure terminal

  ! install the updated service definition on the router

  host1(config)#service-management install tiered.mac

• Use the no version to uninstall a service definition.
• See service-management install

Copyright © 2008, Juniper Networks, Inc. All rights reserved. Trademark Notice.