

        !   !   !   !    README  !    !    !    !


RFC control requires a number of CPAN Perl modules to be installed on the target system
The modules will be installed automatically when running 'make install', but make sure
that an active conection to the internet exists so that the modules can be downloaded
from CPAN.org. The modules can be installed separatly by running 'make CPAN'.

As Centos 7 has changed the way CPAN works it is nescesary to run the 'centos7_CPAN_configuration.bash'
as root before running 'make CPAN'
Note that CentOS is no longer actively supported after the shift to CentOS-Stream by Redhat


Also remember to add all rig users to group sofc!
If this group is not the intended group (for instance the apache group may have insuficient
premissions for normal operation), add the web server to a more appropriate group and rerun make.
Notice that this sould be done BEFORE running make install!
New rigs can be added to the system by running ./ubuntu_create_rig.pl as root with the rig number as argument
If so, the group membership of the rig user will be set automatically when the resulting INSTALL_RIG
script is run!


To install, run 'make', 'make test' and 'make install' and 'make patch' as root!
It is nescesarry to run 'make test' as root as it installs any missing CPAN modules before running the 
actual test as make test depends on several CPAN modules.
If make test fails, the likely cause is a configuration error for one or more
of the rigs on the system, refer the test log to find the offending configuration
and fix this as RFCControl can only install/upgrade on a system with no configuration errors!
(This is in order to make sure that no rig configurations are broken by installation
upgrades, either manual or automatic)


If database datamining is to be used (by running the load_test_data_db.pl script in /usr/local/bin/celltest)
make sure that the 'make db' command is run also. This can only run if the postgresql database is
installed on the target syste. To install the postgresql server run the following command:

make db

However this can not be automated as if postgresql is already installed, any upgrades can irreversibly damage
the runing postgresql service crashing the database!, thus you have to install/upgrade postgresql manually!
Notice, that this database upload functionality only works in conjunction with a database conforming to the sql
script included in the dbload directory.
