Myco::Admin - myco System Administration Guide.
This guide is intended for the system administrator in charge of installing, configuring, or tuning a myco system.
Follow these instructions to install myco without having to think about anything.
tieand should be avoided.
perl -MCPAN -e 'install Myco'
If you run into problems then read below for the details.
The myco framework requires a lot of other components to be installed; here's a list of them:
Follow these instructions to prepare your system for myco.
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:
sh Configure make make test make install
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 or
find / -name postgresql.conf -print to find it) and turn on the tcpip_socket option:
tcpip_socket = true
Otherwise, here are the installation details:
./configure make make install
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
su - pgsql -c "initdb -D /var/db/pgsql/data"
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"
su - pgsql -c "createuser someuser"
Be sure to enter the postrges username, password and database name into
myco.conf. The Makefile.PL script included with myco will do this for you.
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.
There are quite a few 3rd-party Perl modules required by the myco framework (see "PACKAGES" above for a list). The easiest way to install them all, together with all myco framework modules (Myco.pm et al), is to let CPAN.pm take care of the process:
perl -MCPAN -e 'install Myco'
If you have never before used the CPAN module then you will be prompted to go through configuration process. If your computer sits behind a firewall, setting the environment variable FTP_PASSIVE beforehand can be helpful:
export FTP_PASSIVE=yes # sh, bash setenv FTP_PASSIVE yes # csh
See CPAN for more information.
Alternatively, the process may be performed "by hand." Manual installation of each of the required modules follows the usual perl module installation process:
perl Makefile.PL make make test make install
Now you should myco-deploy the database, assuming you were successful in installing PostgreSQL. The CPAN installation method will have already done this for you, if you answered "yes" to the "Do you plan to run the test suite?" question.
cd bin perl myco-deploy
or, in csh:
env MYCO_ROOT=~/myco perl myco-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 firstname.lastname@example.org
Charles Owens <email@example.com> and Ben Sommer <firstname.lastname@example.org>; based on Bric::Admin by David Wheeler