Chebucto Suite (CSuite) Release 1.0-beta-1
Status
This is a Beta release, so don't expect perfection or a lot of
documentation although it is definitely significantly better
in both respects than alpha releases. The installation and
most functionality has been tested on Linux (2.0 kernel) and
the functionality has been in production for a long time with
a lot of users on Chebucto Community Net.
This version does not necessarily install on SunOS or Solaris.
For those platforms please wait for a later beta or release.
Acknowledgment
The terms of distribution of CSuite have always required "prominent
acknowledgment" but at some sites using CSuite we have not always
found this to be the case, so we are firming up the requirement.
Unless an exception is made in writing, any site running
this version or later of CSuite in whole or in part will be required to
have an Acknowledgments page linked from the Home page (the first HTML
page a registered user sees). On this Acknowledgments page, the following text
must be included, with the CSuite acknowledgment the first link on the page
unless a link thanking volunteers is first in which case the CSuite
acknowledgment may be second.
The following text is installed when you install CSuite, with
your organization's full name and abbreviated name substituted for
@@@FULL_NAME@@@ and @@@SHORT_NAME@@@ respectively:
@@@FULL_NAME@@@ is pleased to acknowledge
- Primary Software
- @@@FULL_NAME@@@ uses the Chebucto
Suite (CSuite) Software developed by
Chebucto Community Net in
Halifax, N.S.
Software Prerequisites
If you are running a Debian Linux distribution, read the file DEBIAN
for a list of packages you should have installed before you attempt to install
CSuite.
If you are running GNU make, make sure it is version 3.75 or later -- earlier
versions have a bug which prevents compilation of lq-text, the search engine.
Please help us complete this section before release of version 1.0.
CSuite Documentation
CSuite documentation is changing rapidly. The distribution includes
bookmarks to local CSuite documentation located in:
CS_ROOT/info/csuite/docs
the document CS_ROOT/info/csuite/docs/index.html includes links back to the most
current documentation at Chebucto Community Net.
The distribution includes CSuite Documentation located in the following
directories:
info/adm/admin-helpdocs *Admin/Office Procedure w/examples
info/Help *User Documentation
info/Services/IPsupport *Information Provider Support
info/Services/Training *Training Documents
info/Services/Training/Materials *Training Materials
info/Services/Archives Access to Mailing List Archives
info/Services/MailList Request Form, etc..
info/Services/Member Membership Benefits
info/Services/PDA A pointer back to Chebucto's
Public Download Area
info/Services/Registration *The Account Registration Forms
info/Service/UserAccount ---under construction---
info/Services/Volunteers Volunteer Documents
info/Policy Policy related documentation
info/Policy/MailList *Mailing Lists *Draft*
info/Policy/Email ---under construction---
Files Needed
- README
- this file
- COPYRIGHT
- terms of distribution
- csbuild
- installation script
- build.tar.gz
- lots of files required for install
- vars
- global variable file
- src*.gz
- all the other parts of CSuite
Install
- Retrieve all the above files (about 20MB) into a directory of your
choosing.
- Select a destination directory (e.g. /var/csuite) with about 160MB
or more free.
- Run "sh csbuild".
- csbuild will build lynx and then the rest of the install will
take place from that interface. You can quit whenever you like
and restart later where you left off. Be careful -- lynx starts
up background processes, so make sure that one step finishes
before you start another.
Hints
There are five mailing lists available for CSuite support.
- csuite-install
- questions related to the CSuite install process
- csuite-setup
- questions related to getting up to speed running CSuite
- csuite-dev
- report your results here
- csuite-announce
- announcements concerning new CSuite releases.
- csuite-tech
- high-volume list for day-to-day development
Read the documents that are installed under CS_ROOT (your installation
directory) starting at info/csuite/docs/index.html . These give an overview
of administering a CSuite system. These and other documentation sources
will grow and mature in Release 1.0.
GOOD LUCK!
Known Problems
The following problems are known to exist in the distribution and should be fixed shortly following this release.
- FTPd may not accept logins on systems using shadow passwords
- HTML check may not work on all systems
Short-term Plans
Following are just a few things that will be done before release 1.0:
- bilingual (English/French) support
- further work on autoconf script to allow consolidation of Linux,
SunOS and Solaris source
- more documentation
- upgrade Lynx from late version 2.6 to 2.7
- upgrade pine from 3.91 to 3.95
Robots.txt
A robots.txt file is included in the distribution. This file provides
some measure of control over what parts of your site will be indexed by
visiting WEB spiders and robots.
We acknowledge that you may want to amend or remove this file from your
site -- we have included this file because it is our wish to have the
most current CSuite documents indexed and we would prefer to allow
indexing of CSuite documents at chebucto.ns.ca.
The distributed version of robots.txt does not attempt to exclude the
Help/ tree which may include documents which you have developed.
Changes
changes since Beta-1.0 will be found at The CSuite Changes Page.
alpha5.0 -> 1.0-beta-1:
- full changes are to be found at The CSuite Changes Page (Beta 1.0).
- installation is more complete and more automated
- hooks for bilingual support in many places, although this functionality is not yet exposed
- support for remote services, linking CSuite communities together (see the
link at the top of the "who" listing)
- new privilege editor to tie together /etc/group, htgroup, htpasswd, sudoers
and bookmarks to privileged operations
- new bash included for internationalization support
- zmailer included and integrated
- majordomo included and integrated
- a very late version of lynx2.6 included (2.7 in release 1.0)
- httpd is now Apache1.2b4
alpha4.2 -> alpha5.0:
- Too many minor bug fixes to list here
- pidentd added to distribution
- Make some consideration for future upgrading
- Use autoconf script for build process
alpha4.1 -> alpha4.2:
- HTTPd: added new version (1.5.2) of NCSA HTTPd
- FTPd: fixed compiling problem on Linux 2.0
- ncurses: changed Makefiles to use -lncurses instead of -ltermcap
- yacc: changed makefiles to use byacc instead of yacc
- skel: added src-skel.tar.gz
- RCS: changed conf.sh to allow it to be run by superuser
- src-info-adm: Added missing files for administrative functions
- lq-text: fixed erroneous include and lib paths
added '#include "ndbm.h"' to smalldb.c
- tar: corrected syntax error in Makefile.in
alpha4 -> alpha4.1:
- README: run "sh csbuild" rather than "./csbuild"
- mkmdml: rewrote to use getopts rather than getopt
removed getopt from system-progs
- vars: added several directories to SUPER_PATH for Solaris 2.5
remove ci and co and added rcs
changed lqrank and lqaddfile to lq-text
added CS_ROOT/bin to USERPATH
- progress: improve PROCESS COMPLETE message
- lq-text: corrected syntax error in Makefile; set PATH to find mkdep
- Makefile.build: corrected failure to find ./mksub
corrected ln of index.html to Home.html
corrected installation of .htaccess files
- csbuild: changed zcat to gunzip and "echo -n" to "print -n"
- sh-funcs: in conditional_unpack() report whether unpacking or
skipping and unpack if destination directory does not exist
- mkdef: use SUPER_PATH and awk rather than gawk
escape substitution delimiters
- ftpd: supply ftpcmd.c built by bison to avoid compilation problems
- cs_install: substitute local version of CS_ROOT
- getdate: changed getdate() to CS_getdate to avoid conflict with
getdate(3c) on Solaris 2.5
- src/Makefile.sub: add $$DISTDIR to calls to cs_install
- lynx/src/LYMain.c: commented out _res.retry = 2; which requires
a recent bind distribution of -lresolv -- it was
just an attempt to speed up name lookup timeouts
- many scripts: changed /csuite to @@@CS_ROOT@@@ so that mksub would
be run on them; renamed them with -csuite suffix in
/src tree
- src/Makefile*: made targets silent to reduce verbosity of output
- site-conf: prompt for mailing address and record in vars file
- system-conf: find and record paths for a non-crippled tar and vipw
- passwd_edit: changed to cope with three different passwd file formats
(BSD4.4, SysV shadow and V7 styles)
- ar-make: determine passwd file format dynamically
- rtelnet: included
- private: included files to start account name generation
- many files: hard-coded paths removed and some old files deleted;
there are still some obsolete functions that will go away
in a future release