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
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
|
INSTALLING REPORT MAGIC
Installation
The first time you install Report Magic can be somewhat complicated. Please
read through the instructions on this page completely before starting so you
have a good idea of what will be required. Because much of Report Magic is
built with reusable code, upgrades will be simple. For upgrade notes, see the
docs/whatsnew.html page. These instructions and the included Install.PL script
assume you are using a Unix-like system. If not, it is up to you to make the
necessary translations in the instructions and the Install.PL file to reflect
you computer's file system.
To run Report Magic, you need to have Perl 5.004 or newer installed on your
system. You can find the version of Perl that you have by typing 'perl -v' at
the prompt. If the system says 'unknown command' you either do not have Perl
installed or it is not on your path. If you don't have it see
http://www.perl.com/ for details on getting the Perl interpreter. Compiled
binaries for Perl are available for almost every platform.
Before installing for the first time, you will need to install some system
libraries if they aren't already installed. To generate the graphs, Report
Magic needs three libraries - zlib, libpng and libgd. If you want TrueType font
support in your graphs, you can also install the lttf TrueType library from
FreeType.
zlib
The zlib compression library can be acquired from http://www.gzip.org/zlib/.
Download the source code archive and extract it. Read the
installation documentation and the license. On most systems (Solaris is an
exception) you will not have to build the zlib library if you don't want.
When you build libpng, it incorporates the source files rather than the
actual lib files. If you choose to build and install zlib (or your system
requires that you do) Then do the standard install procedure:
$ ./configure
$ make
# make install (as root)
libpng
Installing libpng is a little more complicated. You can acquire the latest
version from http://download.sourceforge.net/libpng/. Look for something like
'libpng-x.x.x.tar.gz', where x.x.x is the newest (i.e. highest) version
number. Download this and extract it. Read the installation documentation
and the license. You need to have the zlib, that you just uncompressed, on
the same level as the libpng directory and they should both be named
without their versions. Your directory structure should look like this:
|
+- zlib
|
+- libpng
Something like this should do it, but may differ from system to system.
You'll have to remove the archive before doing this (rm *.tar or
rm *.tar.gz depending on your tar version). You should choose one of the
makefiles in the libpng/scripts directory according to your system (e.g.
scripts/makefile.linux for Linux or scripts/makefile.sunos for Solaris).:
$ mv zlib* zlib
$ mv libpng* libpng
$ cd libpng
$ cp scripts/makefile.stf Makefile
$ make
# make install (as root)
freetype (Optional)
If you want to allow support for TrueType fonts in your graphs you can
install freetype. This library is not required for installation, but may be
useful. (If you intend to output in Japanese or Polish, you will need this
library installed. It is also helpful for Italian ouput.) You can download
lttf from http://freetype.sourceforge.net/download.html. After reading the
installation instructions and license, you can build it with the standard
techinique:
$ ./configure
$ make
# make install (as root)
jpeg-6b
The jpeg-6b library may already be installed on your system. Check /lib,
/usr/lib, and /usr/local/lib or your system's equivalents. If not it can
be downloaded from the Independent JPEG Group at
ftp://ftp.uu.net/graphics/jpeg/. After reading the installation
instructions and license, you can build it with the following commands:
$ ./configure --enable-shared
$ make
$ make test
# make install (as root)
libgd
Installing libgd should then be straight-forward. Download the latest
version from link at the top of http://www.boutell.com/gd/ and extract it.
Read the installation documentation and the license. You will need to
edit the Makefile to have it include support for jpeg or freetype. You may
also have to add -I/usr/local/include/freetype to the INCLUDEDIRS= line to
make it work with freetype-1.3.1. You can then build the library with the
standard:
$ make
# make install (as root)
If all system libraries installed successfully, then the rest should be quite
simple. To install change to root user, change directory into the rmagic
directory where you uncompressed the Report Magic archive and type the
following command:
perl Install.PL
If all goes well, this will load all the necessary Perl modules (that aren't
already loaded and up-to-date), install Report Magic in the directory
/usr/local/etc/httpd/rmagic/ (or similar directory with version number) and
install the documentation below that.
If you want to install Report Magic elsewhere, simply edit the configuration
settings in the top of the Install.PL file.
Autoloading the required perl modules from CPAN may require several more steps.
First, this uses the CPAN module to load modules from CPAN. You will need to
configure this the first time it runs by answering serveral questions. It also
requires that you are connected to the Internet (or a local CPAN mirror if you
have such and your CPAN module has been configured for such). Second, using
this may be a security risk. There is no signature system for CPAN code. It is
possible (though unlikely) that CPAN downloads may have been tampered with. If
this bothers you, don't run this part of the install. Instead install all the
modules by hand (see below). (Although, this still could contain tampered
modules, but at least you can look at all the sources first before you put them
in your Perl site library.)
When configuring your CPAN setup, you will be asked for the URL of your
favorite CPAN site. On some systems this includes a list to choose from, on
some it doesn't. If no list is presented, you can type in
'ftp://ftp.cpan.org/CPAN'.
While the install script is running, watch carefully for any errors. The script
will continue to try to install all necessary Perl even if some fail. This may
mean that other will fail later (because of dependencies). Also, the latest
version of GD will ask you some question about the way libgd was installed on
your system.
If you don't want to auto-load the latest version of the necessary Perl modules,
use this instead:
perl Install.PL -no_modules
If you just want to auto-load the latest version of the necessary Perl modules,
but don't want to move Report Magic (i.e. you will run it from the directory
you unarchived it into) use this instead:
perl Install.PL -only_modules
For instructions on manually install Perl modules, see docs/inst_src.html.
|
