Skip to content
This repository has been archived by the owner on Aug 9, 2024. It is now read-only.
therealprof edited this page May 30, 2017 · 1 revision

Notes on installing and running BBF data model tools under Linux

Prerequisites

In order to use the tool you will need to have a Perl interpreter installed and there're a variety of possibilities to obtain one.

Debian / Ubuntu (and derivates)

Current Debian and Ubuntu (and derivate) distributions provide packages for Perl and all required modules.

Installing them is merely a matter of running:

sudo apt-get install libalgorithm-diff-perl libdata-compare-perl libstring-tokenizer-perl libxml-sax-perl libxml-libxml-perl libclone-perl

Other

Most other Linux distributions ship with a Perl interpreter out of the box or provide an easy way to install a current version of Perl 5.

In order to install the required Perl modules from CPAN manually you will need to ensure that your system is able to compile C code and that you have libxml2 including the required development files installed.

After this you ensured that this is the case you can install the CPAN modules using the following steps. First install a helper module to simplify CPAN use:

cpan App::cpanminus

and then follow up with the following command to install the required modules:

cpanm Algorithm::Diff Clone Data::Compare String::Tokenizer URI::Split XML::LibXML

Executing the report tool

After following the previous instructions you should now be able to run the report tool natively by simply executing the report.pl script.

Further information

If you need further help on using the report tool you can run the pod2html tool on the report.pl file in order to generate an HTML file with the synopsis of the command like

pod2html report.pl --outfile=report.html

Also please have a look at the extensive user guide in TR-154.

Clone this wiki locally