diff --git a/ChangeLog b/ChangeLog index 314b7dfe..3477a901 100644 --- a/ChangeLog +++ b/ChangeLog @@ -16270,3 +16270,6 @@ * Moved the contents of 'docs/ripc.txt' to 'docs/apis/ripc.xml.' 2017-11-06 Fred Gleason * Removed 'docs/NEXGEN_FILTER.txt'. +2017-11-06 Fred Gleason + * Moved the contents of 'docs/RIVENDELL_FILTER.txt' to the + Operation Guide. diff --git a/docs/Makefile.am b/docs/Makefile.am index 86ba0fc4..4a152c14 100644 --- a/docs/Makefile.am +++ b/docs/Makefile.am @@ -36,7 +36,6 @@ EXTRA_DIST = ALSA.txt\ PODCASTING.txt\ RDMONITOR.txt\ reports.txt\ - RIVENDELL_FILTER.txt\ SAGE_ENDEC.txt\ scheduler_formats.ods\ WIN32.txt\ diff --git a/docs/RIVENDELL_FILTER.txt b/docs/RIVENDELL_FILTER.txt deleted file mode 100644 index e0bfe3c9..00000000 --- a/docs/RIVENDELL_FILTER.txt +++ /dev/null @@ -1,70 +0,0 @@ - Usage Notes for the 'rivendell_filter' Import Script. - -Rivendell_filter is a script designed to be used to import existing audio -and meta-data from another Rivendell system. It is invoked as follows: - -USAGE - -rivendell_filter -h -u -p -A --g -s -e -Where: - = The MySQL hostname of the source Rivendell database. - - = The MySQL username of the source Rivendell database. - - = The MySQL password of the source Rivendell database. - - = The name of the directory containing the source - Rivendell audio files. - - = The name of the group in which to place carts - belonging to a source Group for which there - is no corresponding destination Group. - - = The first cart in the range of those to be transferred. - - = The last cart in the range of those to be trasnferred. - -OVERVIEW -In order transfer carts from an external Rivendell system, proceed as -follows: - -1) CREATE RIVENDELL GROUPS -In RDAdmin->ManageGroups, create a Group to correspond to each Rivendell -Group that exists in the library to be imported, and an additional -group to catch any carts that may not have a corresponding Group. - -2) LOCATE THE EXTERNAL RIVENDELL DATABASE AND AUDIO FILES -The directory containing the audio files can be mounted from a remote -system if needs be. Read-only access is adequate (and in fact recommended), -as the script does not modify these items in any way. - -3) VERIFY AVAILABLE DISK SPACE -Verify that enough disk space is available in the '/var/snd/' -directory of the destination system to accomodate the audio to be -imported. You should have at least the amount of space currently occupied -by the source files, plus 5 percent additional. - -4) INVOKE SCRIPT -Start up the script, as described in the USAGE section above. The -script will print progress reports as it proceeds, or notify you of -error conditions as required. - -WARNING -If a cart from the source system has the same number as one one the -destination, the destination cart (data and *all* audio) will be overwritten! - -NOTE ON AUDIO PROCESSING -Rivendell_filter does not alter or reencode the audio sample data in any -way, and thus does *not* incurr any generation or transcoding loss of -quality. At the same time, this means that the incoming audio will be -brought into the new Rivendell system *exactly* as it exists in the -source system, with all parameters (e.g. sample rate, bit rate, level, -etc) unaltered. If you need to alter one or more of these parameters as -part of the import process, we suggest you use the RDImport script -instead. - -NOTE ON GROUP ASSIGNMENTS -WARNING: Rivendell_filter makes no attempt to enforce group numbering rules! -If a group to which a given source cart belongs exists on the destination -system, the cart will be placed in that group, regardless of numbering rules. diff --git a/docs/opsguide/Makefile.am b/docs/opsguide/Makefile.am index 956434a4..07a6ae66 100644 --- a/docs/opsguide/Makefile.am +++ b/docs/opsguide/Makefile.am @@ -23,6 +23,7 @@ OPSGUIDE_HTML = appendix.filepath_wildcards.html\ appendix.gpio_switcher_devices.html\ appendix.gplv2.html\ appendix.metadata_wildcards.html\ + appendix.rivendell_filter.html\ chapter.overview.html\ chapter.rdairplay.html\ chapter.rdcatch.html\ @@ -197,6 +198,7 @@ OPSGUIDE_DEPS = $(OPSGUIDE_IMAGES) \ rdlogedit.xml\ rdlogin.xml\ rdlogmanager.xml\ + rivendell_filter.xml\ rml.xml\ utilities.rmlsend_screenshot.png\ utilities.xml\ diff --git a/docs/opsguide/opsguide.xml b/docs/opsguide/opsguide.xml index 6aece174..5e7bbd1c 100644 --- a/docs/opsguide/opsguide.xml +++ b/docs/opsguide/opsguide.xml @@ -16,6 +16,7 @@ + ]> @@ -34,6 +35,7 @@ &gpio_switcher_devices; &filepath_wildcards; &metadata_wildcards; + &rivendell_filter;