Ubuntu install process

In the 'no luck' thread I ended up documenting the installation of Netdoc on an Ubuntu system. Here is that documentation - it's pretty terse but it works!

I started with a fresh clean install of Ubuntu 5.04 (Hoary Hedgehog). This was a minimal install, which can be done by typing 'CUSTOM' after booting the Ubuntu CD. Most people will use the default install, which has many more packages. For me the point of the custom install is a) have only the exact things I need, and b) during a software install process like this, we are sure to capture all the dependencies. So to make a long story short, the following should work on any Ubuntu Hoary system.

I created a mysql user called 'netdoc' with password 'ndpass' in the steps below. You should use a different password at least!

{uncomment the warty 'universe' repository in /etc/apt/sources.list}
sudo apt-get update
sudo apt-get install apache2 php4 mysql-server-4.1 php4-mysql
{the following command enables Apache2's mod_rewrite}
sudo ln -s /etc/apache2/mods-available/rewrite.load /etc/apache2/mods-enabled/rewrite.load
mysqladmin -u root password "password"
mysql -uroot -ppassword -e "create database netdoc"
{below, change 'ndpass' to something else - it is the password netdoc uses for mysql access}
mysql -uroot -ppassword -e "grant all privileges on netdoc.* to netdoc@localhost identified by 'ndpass';"

cd /var/www
sudo wget http://www.visiomode.com/dl/Netdoc-1_5.tar.gz
sudo tar -zxvf Netdoc-1_5.tar.gz
sudo chown www-data /var/www/netdoc/groups
sudo chown www-data /var/www/netdoc/db/dbconfig.php
sudo chown www-data /var/www/netdoc/admin/visiomode.license

:-:START eAccelerator part of install:-:
sudo apt-get install php4-cli php4-dev g++ make
{above are needed only during the install process, they could be
removed if you want, but you might need during later updates!}

cd /var/www/netdoc/eAccelerator
tar -zxvf eaccelerator-0.9.2a.tar.gz
cd /var/www/netdoc/eAccelerator/eaccelerator
export PHP_PREFIX="/usr/bin"
sudo $PHP_PREFIX/phpize4
sudo ./configure --enable-eaccelerator=shared --with-php-config=$PHP_PREFIX/php-config
sudo make
sudo make install
{EDIT /etc/php4/apache2/php.ini}
{add all the stuff found at STEP 3 of http://yourserver/netdoc/eAccelerator/linux.php}
{then, edit this in:}
; *** MAKE SURE THE PATH IS CORRECT ***
zend_extension="/usr/lib/php4/20020429/eaccelerator.so"
:-:END eAccelerator part of install:-:

{add the following to /etc/apache2/sites-available/default:}
## --ADDITIONS FOR NETDOC--
<Directory "/var/www/netdoc">
AllowOverride All
Options FollowSymLinks
</Directory>
## --END NETDOC ADDITIONS--

sudo mkdir /tmp/eaccelerator
sudo chmod 0777 /tmp/eaccelerator
sudo apache2 -k restart

{@ another system} http://yourserver/netdoc

{During the web part of the install:}
Netdoc asks for two mySQL users. Since we created a special 'Netdoc' mySQL
account, we can use that both times. I didn't document all of the screens here, just the ones about users.

Database Name: netdoc
Database Creation: 'Let the install script create only tables'
(Continue)
Database User: netdoc
Database User Password: ndpass {or whatever you used}
(check database connection - if "good the database netdoc is there", continue)
Database User (2): netdoc
Databse User Password (2): ndpass {or whatever you used}
'no, I will create myself'

Also if you look back at the mysql commands above, the mysql root user was given the world's easiest password. You will probably want to change secure this better. See http://dev.mysql.com/doc/mysql/en/default-privileges.html for the canonical security precations you should take.

-Bryan

Thank you! Will add this to the site & docs.

Oh, gotta fix those docs some day anyway, seems that people are reading them :-)

Ok, updated!
http://www.visiomode.com/dl/

1) In the third line ('sudo apt-get install ...') put 'php4-gd2' (without quotes) at the end.
2) Everywhere it says Netdoc-1_5.tar.gz, use Netdoc-1_501.tar.gz instead.

This fixes the FCKeditor image upload problem noted in a different thread.

-Bryan

Dang. I meant to add that to the 'Ubuntu install' thread!

(Now finishing my morning coffee as I should have done before!)

Moved the thread and updated docs.

I used Netdoc-latest.zip/tar.gz, which are symbolic links to actual files so don't have to worry about the version numbers in the docs for now.