BlockCountries/README.bcinstall at master · tlhackque/BlockCountries · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
bcinstall is an installation aid for BlockCountries.

To run:
   bcinstall

This script will determine if perl is installed on your system
and will determine  whether all the required library modules are installed.

Simply download the script, make it executable, and run it.
(No parameters are required.)

If it says 'All checks completed successfully', BlockCountries
should run.

To see the installed versions of the modules that it checks for, use
   bcinstall -v

If you are not going to filter IPv4:
   bcinstall -F

If you are not going to filter IPv6
   bcinstall -S

If it says that you need to install perl, it should be packaged for your
distribution (apt-get, yum, etc.) If you can’t find a current perl version
for your distribution (which would be very, very surprising)  you can find
it at http://www.perl.org.

If it says that you need to install a perl module, here is how to do this:

Most distributions provide all of the modules as packages, using yum, apt-get, etc.

If yours doesn't provide modules or doesn't have one that this needs, use
cpan.  bcinstall will provide guidance.

Install the module(s), then run bcinstall again. Repeat until bcinstall reports
that you have all the needed modules.  Usually, this is all that is
necessary.

Note that some of these modules are shipped with the Perl core distribution.
The others are on CPAN, though it's better to use the ones packaged by your
distribution, as multiple update managers can confuse each-other.

The library modules may depend on certain versions of Perl.  This is handled
by the distribution update managers.  With CPAN, if you are running an older
version of Perl, the latest version of a module may fail to install.  In
this case, you can either have CPAN install an older compatible version of
the module, or update Perl.

Versions of Perl and library modules:
=====================================

bcinstall checks the version of Perl installed on your system.

BlockCountries is known to run on Perl as early as 5.8.8, and as recent
as 5.12.4.  It should run on more recent releases; file bugs at
http://github.com/tlhackque/BlockCountries/issues if not.


bcinstall also checks the version of each library module.  The
minimums are fairly conservative.  However, in many cases earlier
versions have bugs that break BlockCountries.

As newer versions often fix bugs, updating is encouraged.
If you determine that a newer version of a library module is required by
or breaks BlockCountries, please file a bug report.

Caveat:
======

If Perl is used by other software on your system, that software may
depend on specific versions of Perl or Perl library modules.  Although
BlockCountries should not impose incompatible dependencies, managing
these is beyond the scope of this document.

iptables
========

bcinstall also checks for a minimum version of iptables.

BlockCountries requires at least a version that supports the -g [goto]
action, but there are many bugs in versions later than that.

bcinstall does several checks, but only reports its conclusion.

use -v to see the detail.