Prerequisites:

In order to run Ideabox on your computer, you will need the following software components on your unit:
  • MySql database server
  • Php4 script module
Notes:
  • mysql server may be downloaded from http://www.mysql.com/
  • php4 script module may be downloaded from zend.com.
  • We do not provide additional support for the installation of the above components. These web sites contain sufficient information for you to accomplish the task.

Installation process:

Quick installation:

  1. Unpack the distribution under your webroot directory;
  2. Locate install.php in your browser;
  3. Follow the instructions.

Detailed installation:

  1. Unpack the distribution and copy the files under a directory where the web server may accesses them. (Unpack: tar xvzf ideabox.<versionnumber>.tgz)
  2. The Ideabox installation will need a web interface. Start your browser and open install.php (of course, not as a file but through the apache web server, e.g. http://your.server.com/ideabox_1_0/install.php)
  3. Follow the instructions in your browser.
  4. During the installation, a mysql database will be created among the database tables and the necessary data will be written into the tables. The program will attempt to write the Ideabox configuration file (config.php). If the given server configuration doesn't allow this (the apache web server doesn't have write permission in the ideabox directory), you have to write the config data yourself in config.php. Of course, the browser displays all the information you need to do this.
  5. If the root permission needs a password, an input form will appear. Type the user name and password there (this user name is not necessarily the root, but it must till have written permission to an existing database, or permission to create a database if it doesn't yet exist).
  6. The install program now displays the parameters it needs to continue the process of creating the database and the new tables. If you accept these settings, click "Ok". If you want to change the settings, click "Edit parameters". One reason to change these may be, if you don't want the install program to create a new database called "Ideabox", but you have your own existing db and want to put the Ideabox tables in it. In this case, you can specify the name of your db under "Edit parameters".

Uninstall

If for any reason, you want to remove Ideabox from your system, you must delete the ideabox mysql database and the program files with .php extension.

Update

  1. It is recommended that you make a rescue copy from the php files of the installed Ideabox version and a database dump of the current state of Ideabox db before the update process.
  2. Unpack the new version and copy the unpacked files in your Ideabox directory. Important: don't delete the files of the old version in the Ideabox directory, only overwrite them with the new version!
  3. Open the update.php file in your browser and follow the instructions. The update script recognizes which Ideabox version is installed on your server and will make the necessary database modifications. You can use the new version immediately after this.
  4. There is an i directory beside your php files containing the images Ideabox uses. Copy these images, or the whole directory where your already installed Ideabox instance has its own images (if you have not modified it, it is also in an i directory).