|These instructions contain an overview of the steps needed to get WebDNA for|
Mac OS X configured and running. This distribution has been designed to operate under the Apache server as found in the Mac OS X operating system
Once you have downloaded the WebDNA distribution, open the Terminal, found
in /Applications/Utilities, and at the # prompt, use command "cd" to go to the
location where you download WebCatalog distribution. Use "tar" command to unpack WebDNA distribution tar xvpfz WebDNA-x.xxxx.tar.gz("x.xxxx" is the release number) This command will extract the archive and create a WebCatalog/Mac OS X package file (called WebDNA-xxxx/WebCatalog.pkg). This file is used by the Mac OS
X application called the package Installer Installing WebDNA: Note: You must login as root/administrator or you will need administrator's password to install WebDNA. Open the WebDNA-x.xxxx folder and double-click the WebCatalog.pkg file. This will launch the Apple Installer to finish installation process. The WebCatalog
application will start up automatically after the installation process has finished. Starting from version 4.0.2rc2, WebDNA can be installed with installer.zsh script which is included with this package. The next step decribes what the package will do in your system:The package installer will expand the WebCatalog package into two folders:1: WebCatalogEngine folder located inside /Library/WebServer/CGI-Executables/ 2: WebCatalog folder located inside /Library/WebServer/
The installer will add the WebCatalog module to the Apache dynamic module list and modify the configuration file /etc/httpd/httpd.conf to force all .tpl URL suffixes (extensions) to handled by WebDNA. Additional extensions may be handled by WebCatalog by adding the extension to
the line:AddHandler webcatalog2-handler .tpl in the /etc/httpd/httpd.conf file The installer completes by launching WebDNA and restarting the Apache Server
The WebDNA "engine" is the /Library/WebServer/CGI-Executables/WebCatalogEngine/WebCatalog application program. This program fields and responds to browser
requests via the WebCatalog Apache module. On generic Apache/Mac OS X systems, the application is controlled by /Library/WebServer/CGI Executables/WebCatalogEngine/WebCatalogCtl utility script. Accessing WebDNA:
After installation, browse to the main WebCatalog index page at the following URL:http://your.server.com/WebCatalog
(Note that the 'WebCatalog' path is case insensitive) Make certain you set up a default WebDNA Administrator password at: http://your.server.com/WebCatalog/Admin/Security/Index.tpl Additional information for user: For people who use WebDNA package to install WebDNA application for the first time, the package will expand the entire WebDNA distribution and modify all needed configuration files on your system
For people who use the WebDNA package to update to a new version of
WebDNA application, the package will reinstall the WebDNA distribution
into your system. It will rebuild WebCatalog & WebCatalogEngine folders in your system, but it will not overwrite the following database files that are customized for your old setup:
The package update does not change any of your configuration files which
were changed in previous installation
Uninstalling WebCatalog: Mac OS X 's package Installer does not include an uninstall option, therefore WebDNA will use its own uninstall script. Login as root, open the Terminal window, and at # prompt, enter: /Libray/Receipts/WebCatalog-uninstall.sh
This script will uninstall the entire WebCatalog package in your system
Starting from version 4.0.2rc2, WebDNA can be uninstalled with installer.zsh script which is included with package
Changes for WebCatalog
Starting with 4.0.2rc1 version, the [sendmail] context now has the capability of using a remote SMTP server for mail delivery
You can browse to the URL http://your.server.com/cgi-bin/WebCatalogEngine/Admin/EmailPrefs.tpl to setup your remote mail server.
You can also leave the default setting of "localhost", for the value of the "POP Mail Server" preference,
if you wish to have the mail delivered from the local machine.
Bug fixes and change history are available at http://your.server.com/WebCatalog/WebCatReference/WebCatalog Change History.html Security Note: A trigger must be created in order for the "Delete on Expire"option to actually delete a user on the expiration date. The trigger should
target the file: users_expire.tpl located in the WebCatalogEngine folder.
Thank you for using WebDNA.