Skip to content

Install Problems

rhoekstrancsc edited this page Apr 11, 2024 · 13 revisions

We need your feedback on issues which arise during the installation of Taranis. Please contact us when the hints below are insufficient.

Table of Contents

Fixing the scripts

During installation bootstrap or upgrade, you will see the scripts which are executed. Each installation script can be run as often as you want: they will attempt to make minimal changes into the desired situation. Any failure will cause installation to stop.

The lines before the error message show which script fails. You can ask our help to fix the script or attempt it yourself (please report the issue to info@ncsc.nl!) Then simply rerun the bootstrap or install from the start. The modified install scripts will not get overwritten once unpacked.

Installation problems with Perl modules

Taranis uses dozens of Perl packages, which are downloaded from Perl’s distribution archive 'CPAN'. That does not always work flawless: sometimes packages do not install smoothly. When you encounter installation problems, please inform us.

There are two ways around it:

  1. Most Perl modules we install from CPAN are also available as package from your Linux distribution. When you install it that way, the Taranis installation will not attempt to install the module anymore.
  2. Become user 'taranis' and install the module by hand, before attempting the bootstrap/install again:
root#   su – taranis
tara$   cpan -i $module

If that results in a regression test failure then attempt it again adding the -f (force) option. Simply rerun the installation again.

Proxy and other configuration

When you need proxy or other settings, then add them to ~/etc/CPAN-MyConfig.pm. For instance,

http_proxy => 'http://my-proxy-server',
You can find a full list of configurable options in the manual page named 'CPAN', section "Config Variables".

These settings will get merged with the defaults of the Perl distribution into the file ~/.cpan/CPAN/MyConfig.pm each time that you restart Taranis installation. Editing this file or the system wide perl CPAN configuration file will not help you.

Various errors

"Could not find ParserDetails.ini in ../lib/XML/SAX"

Cross-dependency issue when installing XML::SAX. Force a re-installation like this:

tara$  cpan -if XML::SAX::Expat

"WARNING-NEEDS-CONFIGURATION ..."

When you install Taranis under https, you need to complete the SSL configuration by hand. There are various alternatives, and Taranis cannot make that choice for you.

So, when you have chosen to use https, you will always get this error. The Apache2 error will tell you which file in ~/etc/apache-vhost-extra/ you need to change.

Consider consulting the NCSC whitepaper on TLS for information on a secure configuration of TLS:

Clone this wiki locally