Saturday, December 17, 2005

 

Installation

Installing BananaPanel is easy. Once you have fetched the 5 archives from Sourceforge (server.zip, cms.zip, demo.zip, demo_images.zip and sql.zip) you can begin following the directions below. We assume that you have already configured a web server with PHP scripting support and a MySQL database. If you have not done this, we recommend downloading an all-in-one installer like WAMP. Linux, UNIX, and Apple users can use the packages that come with their OSes to do this as well.

Note: It is important to set the REGISTER_GLOBALS command in your php.ini file to "on."

Procedure
  1. Connect to your MySQL database and run the SQL script contained in the sql.zip file. The default database name is "bananapanel" and should be changed in the SQL script if you would like something different.
  2. Create a new MySQL user that will be used by the CMS system. We assume one called "bananauser" with the password "bananapass" in the default installation, but if you care about security we highly recommend you change these. The user will only need to be able to connect from localhost, but if you debug remotely you can also add your IP address to the allowed list for that name.
  3. Create a directory within your web root to place the CMS. It is better to place it in its own directory rather than one with other files.
  4. Unzip the cms.zip file into that directory. At this point you will need to modify two files, "AdminLoginAction.php" and "includes/PageHeader.php" to make the database and hostnames match your configuration. If you've followed the defaults above you should be fine.
  5. Create a directory under your web root for the images and other uploaded files of your CMS users to go. Each user (subscriber) will have their own directory under this parent directory, and you must edit the "subscribers" table to include their unique path. It should be self explanitory from the demo account. This directory must be writable by the web server process.
  6. Create a directory for your server files to go. We suggest you use a subdomain, such as "http://rpc.yourdomain.com", but you can also just use any directory under your web root.
  7. Unzip the server.zip file into that folder.
  8. Open the index.php file in that folder. Near the top are assignments for $adminusername and $adminpassword in the ServerVars class. Change them to anything your would like, and it doesn't need to be the same as the database user information set up previously. Also, set up the database variables at the top of this page the same as you did for the two files in step 4. If you didn't change the defaults you should be fine.
  9. Create a directory under your web root to place your demo files. Due to BananaPanel's unique architecture you can place it anywhere you would like as long as it can access the web server your CMS system is running on. To keep it simple you can just put it on the same machine.
  10. Unzip demo.zip into this directory. Open "inc/cmsheader.php" and replace the $cmsservername variable with your server address listed in step 7. You must use the "http://" version, not the local dirctory.
  11. Unzip the demo_images.zip file into the directory created in step 5. Move the "circus5923" directory out of "userimages" and into the step 5 directory. You will need to go update the "subscribers" table and update it accordingly to indicate your new image path.
  12. If everything worked according to plan, you should be able to bring up the demo site in your web browser and see a charming music store. (It should look a lot like the one at demo.18thstretsoftware.com.) You should also be able to go to your CMS directory in another browser tab and go to AdminLogin.php and login using "demouser"/"demopass" (without the quotes).
You are now good to go! (hopefully)

Comments: Post a Comment



<< Home

This page is powered by Blogger. Isn't yours?