[Contents] [Prev] [Next] [Index] [Report an Error] [No Frames]


Configuring SRC-ACP Properties

To configure SRC-ACP properties, perform these tasks:

Configuring Logging Destinations for SRC-ACP

Use the following configuration statements to configure logging destinations for SRC-ACP:

shared acp configuration logger name ... 

shared acp configuration logger name file { 
    filter filter; 
    filename filename; 
    rollover-filename rollover-filename; 
    maximum-file-size maximum-file-size; 
} 

shared acp configuration logger name syslog { 
    filter filter;
    host host;
    facility facility;
    format format; 
}

Configuring Logging Destinations to Store Messages in a File

To configure logging destinations to store log messages in a file:

  1. From configuration mode, access the configuration statement that configures the name and type of logging destination. In this sample procedure, the logging destination called file-1 is configured in the config group.
  2. user@host# edit shared acp group config configuration logger file-1 file 
    
    
    
  3. Specify the properties for the logging destination.
  4. [edit shared acp group config configuration logger file-1 file] 
    
    user@host# set ? 
    
    
    

For more information about configuring properties for the logging destination, see SRC-PE Monitoring and Troubleshooting Guide, Chapter 3, Configuring Logging for SRC Components with the CLI.

  1. (Optional) Verify your configuration.
  2. [edit shared acp group config configuration logger file-1 file] 
    
    user@host# show 
    
    filename var/log/acp_debug.log;
    
    rollover-filename var/log/acp_debug.alt;
    
    
    

Configuring Logging Destinations to Send Messages to System Logging Facility

To configure logging destinations to send log messages to the system logging facility:

  1. From configuration mode, access the configuration statement that configures the name and type of logging destination. In this sample procedure, the logging destination called syslog-1 is configured in the config group.
  2. user@host# edit shared acp group config configuration logger syslog-1 syslog 
    
    
    
  3. Specify the properties for the logging destination.
  4. [edit shared acp group config configuration logger syslog-1 syslog] 
    
    user@host# set ? 
    
    
    

For more information about configuring properties for the logging destination, see SRC-PE Monitoring and Troubleshooting Guide, Chapter 3, Configuring Logging for SRC Components with the CLI.

  1. (Optional) Verify your configuration.
  2. [edit shared acp group config configuration logger syslog-1 syslog] 
    
    user@host# show 
    
    filter /error-;
    
    host loghost;
    
    
    

Configuring SRC-ACP Operation

Use the following configuration statements to configure how SRC-ACP operates:

shared acp configuration acp-options { 
    backup-directory backup-directory; 
    mode (edge | backbone | dual); 
    event-cache-size event-cache-size; 
    overload-method overload-method; 
    reservation-timeout reservation-timeout; 
    congestion-point-auto-completion; 
    tuning-factor tuning-factor; 
    subscriber-bandwidth-exceed-message subscriber-bandwidth-exceed-message; 
    network-bandwidth-exceed-message network-bandwidth-exceed-message; 
    backup-database-maximum-size backup-database-maximum-size; 
    remote-update-database-index-keys remote-update-database-index-keys; 
    interface-tracking-filter interface-tracking-filter; 
    state-sync-bulk-size state-sync-bulk-size; 
} 

To configure SRC-ACP operation:

  1. From configuration mode, access the configuration statement that configures SRC-ACP operation. In this sample procedure, the SRC-ACP operating properties are configured in the config group.
  2. user@host# edit shared acp group config configuration acp-options 
    
    
    
  3. Specify the folder that stores backup information about subscribers, services, and congestion points.
  4. [edit shared acp group config configuration acp-options] 
    
    user@host# set backup-directory 
    
    
    
  5. Specify the regions of the network that SRC-ACP manages.
  6. [edit shared acp group config configuration acp-options] 
    
    user@host# set mode (edge | backbone | dual) 
    
    
    
  7. Specify the number of plug-in events from the SAE that SRC-ACP can store in its cache.
  8. [edit shared acp group config configuration acp-options] 
    
    user@host# set event-cache-size event-cache-size 
    
    
    
  9. Specify how SRC-ACP deals with situations in which the components exceed the allocated bandwidth because the service was activated after the authorization was granted.
  10. [edit shared acp group config configuration acp-options] 
    
    user@host# set overload-method overload-method 
    
    
    

If you specify -1, SRC-ACP ignores overload. An integer greater than or equal to 0 specifies the bandwidth (in bits per second) by which the maximum may be exceeded.

  1. Specify the time to wait before a bandwidth reservation expires. The reserved bandwidth is reclaimed by SRC-ACP when the reservation expires.
  2. [edit shared acp group config configuration acp-options] 
    
    user@host# set reservation-timeout reservation-timeout 
    
    
    
  3. Specify whether SRC-ACP uses the information acquired from the router to determine the congestion points.
  4. [edit shared acp group config configuration acp-options] 
    
    user@host# set congestion-point-auto-completion 
    
    
    
  5. Specify the factors that compensate for actual use of bandwidth, as opposed to allocated bandwidth.
  6. [edit shared acp group config configuration acp-options] 
    
    user@host# set tuning-factor tuning-factor 
    
    
    
  7. Specify the error message that SRC-ACP sends when the subscriber exceeds the allocated bandwidth.
  8. [edit shared acp group config configuration acp-options] 
    
    user@host# set subscriber-bandwidth-exceed-message 
    subscriber-bandwidth-exceed-message 
    
    
    
  9. Specify the error message that SRC-ACP sends when traffic flow exceeds the allocated bandwidth on an interface between the subscriber and the router.
  10. [edit shared acp group config configuration acp-options] 
    
    user@host# set network-bandwidth-exceed-message 
    network-bandwidth-exceed-message 
    
    
    
  11. Specify the value by which the sum of the sizes of the files that contain SRC-ACP data can increment before SRC-ACP reorganizes the files.
  12. [edit shared acp group config configuration acp-options] 
    
    user@host# set backup-database-maximum-size backup-database-maximum-size 
    
    
    

Choose a value that is significantly lower than the capacity of the machine's hard disk.

  1. Specify the values to look for in the configuration data. Specifying index keys can improve performance by filtering the data.
  2. [edit shared acp group config configuration acp-options] 
    
    user@host# set remote-update-database-index-keys 
    remote-update-database-index-keys 
    
    
    

The value is a list of attributes, separated by commas. An attribute is one of the following text strings:

  1. Specify the interface tracking event to be ignored by SRC-ACP.
  2. [edit shared acp group config configuration acp-options] 
    
    user@host# set interface-tracking-filter interface-tracking-filter 
    
    
    

The value is filter strings in the format of a list of <attribute>=<value> pairs. The filter strings can be contained within query operations.

  1. (Optional) Specify the number of events the SAE sends to SRC-ACP in a single method call during state synchronization.
  2. [edit shared acp group config configuration acp-options] 
    
    user@host# set state-sync-bulk-size state-sync-bulk-size 
    
    
    
  3. (Optional) Verify your configuration.
  4. [edit shared acp group config configuration acp-options] 
    
    user@host# show 
    
    
    

Configuring CORBA Interfaces

Use the following configuration statements to configure CORBA interfaces for SRC-ACP:

shared acp configuration corba { 
     acp-ior acp-ior; 
     remote-update-ior remote-update-ior; 
} 

To configure CORBA interfaces:

  1. From configuration mode, access the configuration statement that configures CORBA interfaces for SRC-ACP. In this sample procedure, the CORBA interfaces are configured in the config group.
  2. user@host# edit shared acp group config configuration corba 
    
    
    
  3. Export the object reference for SRC-ACP through either a local file or a Common Object Services (COS) naming service.
  4. [edit shared acp group config configuration corba] 
    
    user@host# set acp-ior acp-ior 
    
    
    
  5. Specify the object reference for the ACP external interface.
  6. [edit shared acp group config configuration corba] 
    
    user@host# set remote-update-ior remote-update-ior 
    
    
    
  7. (Optional) Verify your configuration.
  8. [edit shared acp group config configuration corba] 
    
    user@host# show 
    
    acp-ior file:///var/acp/acp.ior;
    
    remote-update-ior file:///var/acp/sra.ior;
    
    
    

Configuring SRC-ACP Redundancy

Use the following configuration statements to configure SRC-ACP redundancy and state synchronization with the SAE:

shared acp configuration redundancy {
    enable-redundancy; 
    local-ior local-ior; 
    remote-ior remote-ior; 
    ignore-user-tracking-out-of-sync; 
    community-heartbeat community-heartbeat; 
    community-acquire-timeout community-acquire-timeout; 
    community-blackout-timeout community-blackout-timeout; 
    redundant-naming-service redundant-naming-service; 
} 

To configure SRC-ACP redundancy and state synchronization with the SAE:

  1. From configuration mode, access the configuration statement that configures SRC-ACP redundancy. In this sample procedure, the properties are configured in the config group.
  2. user@host# edit shared acp group config configuration redundancy 
    
    
    
  3. (Optional) Enable SRC-ACP redundancy.
  4. [edit shared acp group config configuration redundancy] 
    
    user@host# set enable-redundancy 
    
    
    
  5. Export the object reference for this SRC-ACP (local interface) through a Common Object Services (COS) naming service in a redundant SRC-ACP configuration.
  6. [edit shared acp group config configuration redundancy] 
    
    user@host# set local-ior local-ior 
    
    
    
  7. Resolves the object reference for the other SRC-ACP (remote interface) through a Common Object Services (COS) naming service in a redundant SRC-ACP configuration. For redundancy, the remote IOR value of one SRC-ACP must match the local IOR value of the other SRC-ACP.
  8. [edit shared acp group config configuration redundancy] 
    
    user@host# set remote-ior remote-ior 
    
    
    
  9. (Optional) Specify whether user tracking events should be ignored when they raise an OutOfSync exception to the SAE when state synchronization is enabled. SRC-ACP raises an OutOfSync exception when SRC-ACP handles service tracking or authentication events without receiving a user start event first.
  10. [edit shared acp group config configuration redundancy] 
    
    user@host# set ignore-user-tracking-out-of-sync 
    
    
    
  11. (Optional) Specify the time interval for community members to check each other's availability when both redundancy and state synchronization are enabled.
  12. [edit shared acp group config configuration redundancy] 
    
    user@host# set community-heartbeat community-heartbeat 
    
    
    
  13. (Optional) Specify the time to wait before trying to reacquire the distributed lock when both redundancy and state synchronization are enabled.
  14. [edit shared acp group config configuration redundancy] 
    
    user@host# set community-acquire-timeout community-acquire-timeout 
    
    
    
  15. (Optional) Specify the time to wait before regaining control when both redundancy and state synchronization are enabled.
  16. [edit shared acp group config configuration redundancy] 
    
    user@host# set community-blackout-timeout community-blackout-timeout 
    
    
    
  17. Export the object reference for the backup naming service through a local file or COS naming service in a redundant SRC-ACP configuration. The primary SRC-ACP registers the IOR and redundancy IOR to both naming services, while the secondary SRC-ACP registers the redundancy IOR to both naming services.
  18. [edit shared acp group config configuration redundancy] 
    
    user@host# set redundant-naming-service redundant-naming-service 
    
    
    
  19. (Optional) Verify your configuration.
  20. [edit shared acp group config configuration redundancy] 
    
    user@host# show 
    

Configuring Connections to the Subscribers' Directory

Use the following configuration statements to configure how SRC-ACP connects to the directory that contains subscriber information:

shared acp configuration ldap subscriber-data {
     congestion-points-eventing; 
     server-address server-address; 
     server-port server-port; 
     dn dn; 
     principal principal; 
     password password; 
     event-dn event-dn; 
     directory-eventing; 
     polling-interval polling-interval; 
} 

To configure connections to the directory that stores subscriber information:

  1. From configuration mode, access the configuration statement that configures SRC-ACP connections to the subscribers' directory. In this sample procedure, the connections are configured in the config group.
  2. user@host# edit shared acp group config configuration ldap subscriber-data 
    
    
    
  3. (Optional) Enable directory eventing for congestion points.
  4. [edit shared acp group config configuration ldap subscriber-data] 
    
    user@host# set congestion-points-eventing 
    
    
    
  5. Specify the list of primary and redundant servers that manage data for subscribers.
  6. [edit shared acp group config configuration ldap subscriber-data] 
    
    user@host# set server-address server-address 
    
    
    
  7. Specify the TCP port for the directory.
  8. [edit shared acp group config configuration ldap subscriber-data] 
    
    user@host# set server-port server-port 
    
    
    
  9. Specify the DN of the root of the directory.
  10. [edit shared acp group config configuration ldap subscriber-data] 
    
    user@host# set dn dn 
    
    
    
  11. Specify the DN used to authorize connections to the directory.
  12. [edit shared acp group config configuration ldap subscriber-data] 
    
    user@host# set principal principal 
    
    
    
  13. Specify the password used to authorize connections to the directory.
  14. [edit shared acp group config configuration ldap subscriber-data] 
    
    user@host# set password password 
    
    
    
  15. Specify the DN of the directory that contains event information.
  16. [edit shared acp group config configuration ldap subscriber-data] 
    
    user@host# set event-dn event-dn 
    
    
    
  17. (Optional) Enable directory eventing.
  18. [edit shared acp group config configuration ldap subscriber-data] 
    
    user@host# set directory-eventing 
    
    
    
  19. Specify the time interval at which the SRC component polls the directory.
  20. [edit shared acp group config configuration ldap subscriber-data] 
    
    user@host# set polling-interval polling-interval 
    
    
    
  21. (Optional) Verify your configuration.
  22. [edit shared acp group config configuration ldap subscriber-data] 
    
    user@host# show 
    
    
    

Configuring Connections to the Services' Directory

Use the following configuration statements to configure how SRC-ACP connects to the directory that contains information about services:

shared acp configuration ldap service-data {
     edge-congestion-point-dn edge-congestion-point-dn; 
     backbone-congestion-point-dn backbone-congestion-point-dn; 
     reload-congestion-points; 
     congestion-points-eventing; 
     server-address server-address; 
     server-port server-port; 
     dn dn; 
     principal principal; 
     password password; 
     event-dn event-dn; 
     directory-eventing; 
     polling-interval polling-interval; 
} 

To configure connections to the directory that stores service information:

  1. From configuration mode, access the configuration statement that configures SRC-ACP connections to the services' directory. In this sample procedure, the connections are configured in the config group.
  2. user@host# edit shared acp group config configuration ldap service-data 
    
    
    
  3. Specify the DN of the directory that contains information about network interfaces for edge congestion points.
  4. [edit shared acp group config configuration ldap service-data] 
    
    user@host# set edge-congestion-point-dn edge-congestion-point-dn 
    
    
    
  5. Specify the DN of the directory that contains information about network interfaces for backbone congestion point objects.
  6. [edit shared acp group config configuration ldap service-data] 
    
    user@host# set backbone-congestion-point-dn backbone-congestion-point-dn 
    
    
    
  7. (Optional) Specify whether SRC-ACP detects changes in the backbone congestion point for a service while SRC-ACP is operative.
  8. [edit shared acp group config configuration ldap service-data] 
    
    user@host# set reload-congestion-points 
    
    
    

Set this value only when you want to modify a congestion point.

  1. (Optional) Enable directory eventing for congestion points.
  2. [edit shared acp group config configuration ldap service-data] 
    
    user@host# set congestion-points-eventing 
    
    
    
  3. Specify the list of primary and redundant servers that manage data for subscribers.
  4. [edit shared acp group config configuration ldap service-data] 
    
    user@host# set server-address server-address 
    
    
    
  5. Specify the TCP port for the directory.
  6. [edit shared acp group config configuration ldap service-data] 
    
    user@host# set server-port server-port 
    
    
    
  7. Specify the DN of the root of the directory.
  8. [edit shared acp group config configuration ldap service-data] 
    
    user@host# set dn dn 
    
    
    
  9. Specify the DN used to authorize connections to the directory.
  10. [edit shared acp group config configuration ldap service-data] 
    
    user@host# set principal principal 
    
    
    
  11. Specify the password used to authorize connections to the directory.
  12. [edit shared acp group config configuration ldap service-data] 
    
    user@host# set password password 
    
    
    
  13. Specify the DN of the directory that contains event information.
  14. [edit shared acp group config configuration ldap service-data] 
    
    user@host# set event-dn event-dn 
    
    
    
  15. (Optional) Enable directory eventing.
  16. [edit shared acp group config configuration ldap service-data] 
    
    user@host# set directory-eventing 
    
    
    
  17. Specify the time interval at which the SRC component polls the directory.
  18. [edit shared acp group config configuration ldap service-data] 
    
    user@host# set polling-interval polling-interval 
    
    
    
  19. (Optional) Verify your configuration.
  20. [edit shared acp group config configuration ldap service-data] 
    
    user@host# show 
    
    
    

Configuring SRC-ACP Scripts and Classification

Use the following configuration statements to configure SRC-ACP scripts and classification:

shared acp configuration scripts-and-classification {
     script-factory-class script-factory-class; 
     classification-factory-class classification-factory-class; 
     classification-script classification-script; 
     congestion-point-profile-script congestion-point-profile-script; 
     extension-path extension-path; 
} 

To configure scripts and classification:

  1. From configuration mode, access the configuration statement that configures SRC-ACP scripts and classification. In this sample procedure, the properties are configured in the config group.
  2. user@host# edit shared acp group config configuration scripts-and-classification 
    
    
    
  3. Specify the script factory class name.
  4. [edit shared acp group config configuration scripts-and-classification] 
    
    user@host# set script-factory-class script-factory-class 
    
    
    
  5. Specify the congestion point classifier factory class name.
  6. [edit shared acp group config configuration scripts-and-classification] 
    
    user@host# set classification-factory-class classification-factory-class 
    
    
    
  7. Specify the class name for congestion point classification.
  8. [edit shared acp group config configuration scripts-and-classification] 
    
    user@host# set classification-script classification-script 
    
    
    
  9. Specify the class name for generating the congestion point DN by using the congestion point profile.
  10. [edit shared acp group config configuration scripts-and-classification] 
    
    user@host# set congestion-point-profile-script congestion-point-profile-script 
    
    
    
  11. Specify the extension class path for classes not located in the /opt/UMC/acp/lib directory.
  12. [edit shared acp group config configuration scripts-and-classification] 
    
    user@host# set extension-path extension-path 
    
    
    
  13. (Optional) Verify your configuration.
  14. [edit shared acp group config configuration scripts-and-classification] 
    
    user@host# show 
    
    
    

[Contents] [Prev] [Next] [Index] [Report an Error] [No Frames]