Documentation 1.01
Prev: 1.00 Installation InstructionsNext: 1.00 Modules
Installation: Requirements
DadaIMC runs properly with Apache 1.3x on Linux boxes. PHP is officially unsupported with Apache 2.x, but dadaIMC has been made to work with it. It requires an additional configuration change, but allows dadaIMC to run on other Unix flavors in addition to Linux. The following is a more-or-less comprehensive list of the software you need installed on your server to run a dadaIMC site:
- Apache 1.3.22 (may work with slightly earlier versions)
- MySQL 3.23.23 or higher (needs FULLTEXT indexing)
- PHP 4.2 or higher (4.3 highly recommended, especially for multi-lingual sites)
- cURL 7.8 or higher (for cron jobs)
- gd 1.6.2 or higher (for image resizing)
- phpMyAdmin is essential for quick, raw database access (handy!)
- ...and recent versions of common libraries (libtiff,libjpeg,zlib,etc).
PHP was compiled with the following options. Also read the important notes below.
./configure --with-config-file-path=/usr/local --with-mysql (*) --with-gettext (*) --with-gd (*) --with-jpeg-dir (*) --with-png-dir (*) --with-curl (*) --enable-ftp (*) --enable-trans-sid (*) --with-tiff-dir --with-ttf --enable-bcmath --enable-inline-optimization --enable-sysvsem --enable-sysvshm --enable-shared-pdflib --with-zlib --with-regex=system --enable-sockets --with-apxs=/usr/sbin/apxs
Not all of these are essential to dadaIMC, which doesn't currently use things like LDAP or the PDFlib, but the options marked with (*) are essential. If you're already using PHP and don't know what options are enabled, create a page with <? echo(phpinfo()) ?> on it to display them. If you are using RedHat RPMs, some of these options may be added to your PHP configuration through Dynamic Object modules, and not compiled in directly.
Important Notes
PHP 4.2 now defaults to having the register_globals directive set to off. dadaIMC since version .95 has been rewritten to work with register_globals OFF, so it is safe to leave it off. dadaIMC will certainly work fine with it set to ON as well.
PHP must be compiled with gettext() support if you wish to support multiple languages. For English only, dadaIMC will work without gettext() support.
If you wish to use a remote content server for your images, you must have FTP support compiled into PHP.
Apache 2.x: dadaIMC uses a URL-parsing technique to maintain clean URLs. This technique requires a modification to the Apache configuration file for support in Apache 2.x. In the Apache configuration file, either in the global scope, or within the VirtualHost directive covering your dadaIMC site, add the directive
AcceptPathInfo on
inside the VirtualHost directive governing your site. This has been made to work in the past, but officially, dadaIMC is not supported with Apache2 (since PHP isn't officially supported under Apache2).
The GD libraries are needed for resizing images and creating thumbnails automatically. It isn't essential, and there are checks in place to see whether or not it's installed, but things can get confusing if you install only some of the components, like GD, but not libjpeg. So if you compile GD support, be sure you also include libpng, libjpg, and ideally, libtiff. PHP version 4.3 includes a bundled GD library that allows for the resizing of GIF images. Since dadaIMC version .96, support for the external software ImageMagick has been added to replace the functionality of the GD library.
phpMyAdmin is highly recommended for quick administrative access to the databases. Get it here.
Report Bugs
dadaIMC uses the Mantis bug-tracking system for bug reporting. Please use it! And check for existing reports of your bug before submitting a new one.
CVS
The current CVS version of dadaIMC is now browseable online. Be forewarned, though, that it is not always in a useable state as-is!
