Noosphere Install Here is a detailed account of installing Noosphere on your local machine. I will be using Ubuntu 5.04.
Step 1: Download NoosphereThere are 2 methods of getting Noosphere. The first is the normal public way through CVS. Simple instructions on this method is given
here . The second is if you have access to the subversion repository. If so you can retrieve the newest noosphere and lucene search engine with
svn checkout svn+ssh://pm@planetmath.org/var/lib/svn/noosphere/trunk noosphere
svn checkout svn+ssh://pm@planetmath.org/var/lib/svn/lucene_search_module/trunk lucene_search_module
Of course you will need the password which is not for me to give out. Ask
Aaron nicely!
I think there are differences between cvs and svn and I will go through the svn install for now. So once you have the two directories noosphere and lucene_search_module in a temporary folder you need to set it up in a web directory. The default config, which we will use here wants noosphere in the /var/www/pm directory, this can be viewed in the baseconf-example.pm file. We will not change this for now to keep it simple. Next copy the noosphere and lucene directories to this. You most likely will need root privileges so su to root or execute the following:
sudo mv noosphere /var/www/pm
sudo mv lucene_search_module /var/www
The privileges of these folders should stay the same as whoever downloaded them.
Step 2: Install Noosphere DependenciesThe reason this is step 2 is because a lot of details of the installation and dependencies can be found in the downloaded file in the noosphere directory under install/INSTALL. Take a deep breath and relax since this will take awhile. Ubuntu makes most of the installation straight forward. Just open up the Add/Remove Programs under the System Tools menu. From here you can search for packages and install with simple clicks. Below is a list of what I have installed, Note you may get some extra installs based on other required packages:
Mysql mysql-client 4.0.23-3
mysql-common 4.0.23-3
mysql-server 4.0.23-3
libdbd-mysql-perl 2.9003-3
libmysqlclient12 4.0.23-3
Apache apache2 2.053-5
apache2-common
apache2-mpm-worker
apache2-utils
openssl
ssl-cert
mod_perl libapache2-mod-perl2 1.99.14-4
* Important, do not use mod_perl 2 from their website
Perl perl 5.8.4-6
perl-base 5.8.4-6
perl-modules 5.8.4-6
libdbi-perl 1.46-4
libdbd-mysql-perl 2.9003-3
libxml2 2.6.17-0
libxml-parser-perl 2.34-4 (this is a maybe)
libxml-sax-perl 0.12-5
libxml-namespacessupport-perl 1.08-3
libxslt1.1 1.1.12-3
libunicode-string-perl 2.07-1
* NOTE, the following are not in Ubuntu but are asked for in the INSTALL file
libxml-perl (this maybe in parser and sax)
libxslt-perl
libxml-dom-perl
libdigest-sha1-perl
Data::Denter (Probably need to get this from CPAN)
Vim vim 6.3-046
vim-common 6.3-046
Misc ispell 3.1.20.0-4
iamerican
wget 1.9.1-10
tidy 20040811-2
livtidy0 20040811-2
gs 8.01-5
gs-gpl
gs-common
gs-esp
gsfonts
gsfonts-x11
libmagick6
libmagick6-dev (this has lots of dependencies)
netpbm 10.0-8
libnetpbm10
LaTeX tetex-base 2.0.2c-3
tetex-bin
tetex-doc
tetex-extra
texi2html 1.66-1.2
Now to install the packages that are not included in Ubuntu.
Data::Denter Go the
CPAN search webpage and do a search on Denter. Choose the 'deprecated' Denter package and download the tar file. Untar it and follow the normal perl install method of:
perl Makefile.PL
make
make test
sudo make install
*Note you may fail some prerequisites so go back to CPAN and install the needed packages.
In my case I did not have YAML so download it and execute
perl Makefile.PL
make
make test
sudo make install
Yet another prerequisite is needed, Test::More, so go again to CPAN and download it and install. It seems there no longer is a Test::More and it has been rolled into Test::Simple so just install this one. Once this is done go back into the other directories in install YAML and then Denter. Phew, all should be well with Denter now.
libxml-perl (libxml-libxml-perl) You need to add more repositories so in the Synaptic Package Manager go to Settings->Repositories and add all possible (universe and multiverse for each drop down box. Once this is done libxml-libxml-perl package will show up so install it. It will need the prereq. libxml-libxml-common-perl.
libxslt-perl (libxml-libxslt-perl) This package shows up in the manager after the above repositories are added.
libxml-dom-perl This package shows up in the manager after the above repositories are added. It will need the prereqs. libxml-perl and libxml-regexp-perl.
libdigest-sha1-perl This package shows up in the manager after the above repositories are added.
Allright, the only thing left is the correct latex2html, but we will wait on this one until it shows up in the INSTALL instructions.
Step 3: Create and setup database A mysql database will be set up here. You will need root access to mysql to do the following. Since, I have not configured mysql yet I can connect as root without a password.
mysql -u root
Set the password for root, if there was none
mysql> SET PASSWORD FOR 'root'@'localhost' = PASSWORD('******');
Next create a database
mysql> CREATE DATABASE PlanetTest
Setup a user account for PlanetTest with the following 2 commands
mysql> use PlanetTest;
mysql> GRANT ALL PRIVILEGES ON *.* TO 'bloftin'@'localhost' IDENTIFIED BY 'password' WITH GRANT OPTION;
Exit mysql and now it is time to initialize the database. Hold your breath, as we are in uncharted territory with the new schema file. Errors are expected, but do not worry. The svn schema file is broken so use this
one . Note that this will only work with mysql version greater than 4.
cd /var/www/pm/db
mysql -u bloftin -p PlanetTest < pm_schema.sql
Next you need to edit the init.sql file to put in your own values. Changes I made include
administrator user:
username - bloftin
email - bloftin@phys-x.org
password - *******
Then input into database with
mysql -u bloftin -p PlanetTest < init.sql
Next comes your classification. For now we will load the default MSC.
mysql -u bloftin -p PlanetTest < msc.sql
Step 4: Install and configure latex2html Download the latex2html from www,latex2html.org. Right now their website is down so install it for Ubuntu from the package manager
latex2html 2002-2-1-8
Next edit the script in /usr/bin
sudo vi /usr/bin/pstoimg
Around line 261 change the location of gs to
my $GS = '/var/www/pm/bin/gs
For now we will forgo the latex2html patch as it causes some problems until we need it. Now copy the latex2html file to noosphere directory.
cp /usr/bin/latex2html /var/www/pm/bin
Step 5:Build the page image hyperlink mapper cd /var/www/pm/bin/map
make
*Note: if gcc is not found, install a version (I've install gcc 3.3) and then create a symlink to gcc
sudo ln -s /usr/bin/gcc-3.3 /usr/bin/gcc
Step 6: Permissions Make the data working directories writable to the user noosphere is running as so
sudo chgrp -R bloftin /var/www/pm/data/cache
sudo chmod -R g+sw /var/www/pm/data/cache
Step 6: Install vim color sudo cp /var/www/pm/stemplates/pm.vim /usr/share/vim/vim63/colors
More to come, writing this and doing the install at the same time has taken about 4 hours. More to come tomorrow night on the configuration.