GenericSubversionStitcher
Overview
The Unified Assurance Topology Subversion Stitcher is used to create device relationships in the graph database using data gathered from a subversion repository. The stitcher connects to the given SVN repository, retrieves a file list and contents and makes it available to the rules files for special processing and entry into the graph database.
Subversion Stitcher Setup
-
Update the URL in the configuration so the application connects to the correct subversion repository.
-
Review the logic in the rules files referenced in the configuration to see the processing that will be done on the devices that are selected:
-
"LoadRules" will be executed during application startup to load data that might be needed during processing.
-
"IncludeRules" will be read during application startup to load additional files that might be called during processing.
-
"BaseRules" will be executed for each device that is selected based on the configuration.
Update the logic as needed.
-
-
Enable the default Service, unless a specific configuration option is needed:
Default Scheduled Job
Field | Value |
---|---|
Package Name | coreCollection-app |
Job Name | Topology Subversion Stitcher |
Job Program | bin/core/collection/GenericSubversionStitcher |
Job Arguments | |
Job Description | Topology rules-based create and update Hierarchy from network inventory via subversion repository |
Failover Type | Standalone (Supported: Standalone, Primary/Backup) |
Status | Disabled |
Privileged | (Checked) |
Minutes | 0 |
Hours | 20 |
Days | * |
Months | * |
WeekDays | * |
Default Configuration
Name | Value | Possible Values | Notes |
---|---|---|---|
BaseRules | collection/topology/svn/base.rules | Text, 255 characters | Relative path to Base Rules |
BranchDir | core/default | Text, 255 characters | relative path to Rules dir |
IncludeRules | collection/topology/svn/base.includes | Text, 255 characters | Relative path to Include Rules |
LoadRules | collection/topology/svn/base.load | Text, 255 characters | Relative path to Load Rules |
LogFile | logs/TopologySubversionStitcher.log | Text, 255 characters | Relative path to Log File. |
LogLevel | ERROR | OFF, FATAL, ERROR, WARN, INFO, DEBUG | Logging level used by application. |
Threads | 3 | Integer | The number of process threads created. |
URL | https://<FQDN>/repos/config | Text, 255 characters | The web address of the SVN repository. Should be in the format http://YOUR-SERVER-NAME/ADDITIONAL/PATHS/ . |
Rules
This application uses the Unified Assurance standard rules architecture. The rules are written in Perl syntax. Refer to the following guides for details on rules creation:
Tokens
The stitcher exposes the following tokens for use in rules processing.
Token | Description |
---|---|
$AppConfig | Hash reference to the application configuration name-value pairs that were configured. (i.e. use $AppConfig->{'Host'} to retrieve the set value for 'Host'.) |
$DataRow->{'BaseURL'} | URL of repository (same value as "$AppConfig->{'URL'}"). |
$DataRow->{'FileURL'} | URL of current file. |
$DataRow->{'FileContents'} | Current file contents (results of the "svn cat"). |
Administration Details
The following list shows the technical details you will need for advanced administration of the application:
-
Package - coreCollection-app
-
Synopsis -
./GenericSubversionStitcher [OPTIONS]
-
Options:
-c, --AppConfigID N Application Config ID (Service, Job, or Request ID) -?, -h, --Help Print usage and exit
-
Threaded - Multi-Threaded