NAME

Myco::Admin - Myco System Administration Guide.

VERSION

$Revision: 1.4 $

DATE

$Date: 2003/12/19 21:43:40 $

DESCRIPTION

This guide is intended for the system administrator in charge of installing, configuring, or tuning a Myco system.

QUICK INSTALLATION

Follow these instructions to install Myco without having to think about anything.

1. Install Perl 5.6.1 or greater (5.8.2 or later strongly recommended - 5.8.0 has known issues with tie and should be avoided.

2. Install PostgreSQL 7.1 or greater.

3. In the Myco source directory:

   perl Makefile.PL
   make

   And then as root:

   make install

If you run into problems then read below for the details.

PACKAGES

Myco requires a lot of other components to be installed; here's a list of them:

• Perl 5.6.1 (5.8.2 or later recommended)

• Perl Modules:

  Bit::Vector

  Class::Data::Inheritable

  Class::Inner

  Class::Tangram 1.15

  DBD::Pg

  DBI

  Date::Calc

  Date::Manip

  Devel::StackTrace

  Devel::Symdump

  Error

  Exception::Class

  Locale::SubCountry

  Pod::Constants

  Set::Object 1.04

  Tangram

  Test::Unit

  WeakRef

  * PostgreSQL 7.1.3

INSTALLATION

Follow these instructions to prepare your system for Myco.

Perl

The standard Perl installation should apply with no problems. If your system comes with a package manager (ex. Redhat Linux RPM, FreeBSD ports, etc.) then you can use that to install Perl.

Here is how to install Perl from source:

• Download the Perl source tarball from www.perl.com.

• Gunzip and untar the sources.

• Change to the source directory and execute these commands:

  sh Configure
  make
  make test
  make install

PostgreSQL

PostgreSQL is an integral part of Myco: it's where all of your objects are stored! Its installation is pretty straight-forward and typical, but it requires a number of extra steps that one might not expect.

If you're using Redhat Linux you may already have Postgres installed. If so, all you need to do to get it ready for use with Myco is edit your postgresql.conf file (run locate postgresql.conf to find it) and turn on the tcpip_socket option:

tcpip_socket = true

Otherwise, here are the installation details:

• Download the PostgreSQL source tarball from www.postgresql.org.

• Gunzip and untar the sources.

• Change into the source directory and read the INSTALL file to see if you need to use any Configure commands.

• Install PostgreSQL:

  ./configure
  make
  make install

• If the PostgreSQL installation did not create a user named "pgsql" for you, create it now. This is the user that will start the PostgreSQL server and own the log and data files.

• Now make a directory in which you want to keep your PostgreSQL databases, including the Myco database. Make the "pgsql" user the owner of that directory.

  mkdir /var/db/pgsql
  mkdir /var/db/pgsql/data
  chown pgsql /var/db/pgsql/data

  and set the right permissions:

  chmod -R 0700 /var/db/pgsql/data

• Initialize the PostgreSQL database. Be sure to pass the directory you just created to the -D command.

  su - pgsql -c "/usr/local/pgsql/bin/initdb -D /var/db/pgsql/data"

• Start the PostgreSQL "postmaster".

  /usr/local/etc/rc.d/pgsql.sh start

  If you start postgres this way, you'll need to set the PGDATA environment variable first:

  su - pgsql -c "export PGDATA=/var/db/pgsql/data"

• Now create a postgres user for yourself. Using your login username is best, since the Myco deploy and testrun scripts depend on this. The other option is to set the PGDATABASE, PGUSER, PGPASSWORD environment variables.

  su - pgsql -c "createuser someuser"

And now PostgreSQL is ready to go!

Note that only a little work is required to make myco compatible with MySQL and other Tangram-supported RDBMSs - notably changing PostreSQL-specific SQL directives passed to Tangram in various Entity attribute specifications. Formal myco releases may depend on the transaction support embedded in postgres and will not provide this support by default.

Perl Modules

There are quite a few Perl modules required by Myco (see "PACKAGES" above for a list). The easiest way to install them all is to let Myco's installation system handle it using the CPAN.pm module (see below for details).

Another option is to use CPAN.pm yourself to download the latest Bundle::Myco package and use it to install all the required packages:

perl -MCPAN -e 'install Bundle::Myco'

Finally, manual installation of each of the required modules follows the usual perl module installation process:

• Download the package sources.

• Gunzip and untar the sources.

• Change to the source directory and execute these commands:

  perl Makefile.PL
  make
  make test
  make install

Myco

Myco and its Perl prerequisites can be installed in an automated way.

• Download the latest Myco sources from http://myco.ws/.

• Decompress the Myco sources into a directory of your choice and change into that directory.

• Build Myco:

  make

  This step will check your system for all required packages. It will also ask you questions regarding your installation. In most cases the default answer will be correct and you can just press return.

• Install Myco (as root):

  make install

Deploying the Database

Now you should deploy the database, assuming you were successful in installing PostgreSQL.

• Set the MYCO_ROOT environment variable to point to the directory (usually 'myco' or 'myco/framework') that contains the 'classes', 'test', 'bin', and 'conf' directories. Alternatively you can set it temporarily on the command line if you don't plan to be runnin the myco web application.

• Change to the 'bin' directory, in the source directory, and run the 'deploy' script:

  cd bin
  perl deploy

  or

  env MYCO_ROOT=~/myco/framework perl deploy

Your database should now be populated. Try running 'psql' or your favourite PostgreSQL client to inspect that its OK.

If you run into problems, send a note with as much information as possible to myco-users@lists.sourceforge.net

AUTHOR

Ben Sommer <Ben.Sommer@enc.edu>, based on Bric::Admin by David Wheeler

SEE ALSO

Myco

cpanm Myco

perl -MCPAN -e shell
install Myco