How to install dotProject 2.1.2 on FreeBSD 7.2 with Apache 2.2, PHP5, and MySQL 5.1 Server?
The basic overview.
- Install FreeBSD.
How do I install FreeBSD?
- Update FreeBSD and download the ports tree.
What are the first commands I run after installing FreeBSD
- Then install Apache + SSL.
Installing an Apache + SSL on FreeBSD using the ports tree
- Then install MySQL.
How to install MySQL on FreeBSD 7.2 or on Red Hat 5.4?
- Configure MySQL to be Unicode.
How to create a UTF-8 Unicode Database on MySQL and make UTF-8 Unicode the default?Note:
- Secure MySQL. I don’t have a post on this, but you can follow these MySQL pages.
Securing the Initial MySQL Accounts
General Security Guidelines
Note: If you know what you are doing, you can go with any database that dotProject supports, such as Postgresql.
- Install PHP5and PHP5-Extensions and make sure to include the MySQL extensions and the LDAP extension.
- Then install DotProject
I have previous documents about installing each of the steps above installing dotProject. Once you have gone though the above documents, you will be ready for this document. This document will only cover dotProject.
Installing dotProject 2.1.2 from Ports
- Install dotProject from ports using one of the following commands (I use the first one when doing virtual hosts and the second one when just using sub directories of the web root).
Note: If you Apache directory is /usr/local/www/apache22/data you may want to use this make command:
- Create a database in MySQL for dotProject. Name it whatever you want. For this example, I am going to name the database dotProjDB. If you have read the articles about MySQL that I referenced above, you should know how to log into to MySQL, but just in case you forgot, I will show you again.There are lots of ways to create a database in MySQL, and I am going to give you one example using the shell and the MySQL client.
Enter your password and you should be taken to a mysql prompt.
Yes it is that simple. And at the same time no it is not that simple. There is a lot more to know such as where to put the database files and how fast of drives you need, whether you need faster read speed or faster write speed or both, but this will suffice for now.
- Create a mysql user account for this database. We don’t want to user the root account.
See this page in the MySQL documentation for more information on this: Adding User Accounts
- Now open a web browser to your server’s site: http://yourserver/dotprojectYou will see the following page.
No need to do anything on this page because it should redirect you after 5 second to a dotProject configuration web page.
Now some of the items in red need to be taken care of. Not all of them, just some of them.
The first group of items are “Requirements” and anything not with a pretty green check mark under the “Requirements” section needs to be fixed.
However, under the “Database Connectors” section, there are lots of red Xs. We don’t need to fix these. We just need one database, so as long as the database you want to use (in this example it’s MySQL) has a pretty green check mark, you don’t need to do add more “Database Connectors”.
- Fix the first error: Session Save Path writable? X Fatal: session.save_path is not setTo do this, follow these steps:
- Change to the directory that contains the php.ini file. On FreeBSD that directory is here: /usr/local/etc
- Now by default the PHP5 port on FreeBSD doesn’t install a php.ini file, but instead provides two example php.ini files: php.ini-recommended and php.ini-dist. So copy one of them to php.ini.
- Edit the php.ini file and remove the comment from this line:
eewhich is the command to open Easy Editor. But you can use
- Save the file and exit.
- The other issue is this one: Session AutoStart = ON? X Failed Try setting to ON if you are experiencing a WhiteScreenOfDeathOk. So this issue is fixed is in that same php.ini file. So repeat the steps only this time we don’t remove a comment, we change a setting from 0 to 1. Find the following line and change it from 0 to 1, as shown.
- Restart apache. This is required and must be done before these settings will take effect.
- Now you are ready to click the “Start Installation” button. So go ahead and click it. The following page should appear.
- Enter the details as shown in the page. Hopefully you have your own database user and password to use.
- Should you click the “User persistent connection?” option? Well, read this. http://www.php.net/manual/en/features.persistent-connections.phpI am not going to check it.
- Click “Install db and write config”. It should succeed and you should see this new page.
- Now go back to the dotproject home page: http://yourserver/dotprojectLogin with the default user name and password and you are ready to go.
Check out my new update to this:
How to configure dotProject 2.1.2 to authenticate using Active Directory’s LDAP?
Copyright ® Rhyous.com – Linking to this article is allowed without permission and as many as ten lines of this article can be used along with this link. Any other use of this article is allowed only by permission of Rhyous.com.