Installing the Jamroom Core Files
- Using a program like 7-zip, uncompress the downloaded Jamroom zip file into a temporary directory on your hard drive (i.e. C:temp). You will notice that Jamroom has created a sub directory that contains the version number of the Jamroom release you downloaded - i.e. “jamroom-4.1.6”. The files and directories you will want to upload to your web server are INSIDE of that directory - i.e.:
C:tempjamroom-4.1.6
-
Using FileZilla (or another quality FTP client), log into your server.
-
Change directories until you are in the place you put your HTML pages for them to be viewed on the Internet, the “public area” (called the “Document Root”). This is usually called "public_html" or "httpdocs".
-
Using Filezilla (or your FTP client), transfer the contents of the Jamroom ip file (which has already been decompressed into a temp directory on your local hard drive) over to your website.
- Now, start up your Web Browser, and load the "install.php" script:
http://www.example.com/install.php
- You will need to replace "www.example.com" with your actual domain name. Follow the on screen instructions to complete the Jamroom Installation.
- Once Jamroom has been installed, it is recommended to do the following to finish the Jamroom setup:
- Log in to your Jamroom as the Master Admin, using the username and password created during the install
- Once logged in go to the Control Panel (if not there already) and click on the "Admin Menu" option
- Click on the "Server Check" link.
- The Jamroom Server Check will show you any issues or items that are not setup properly in your Jamroom, along with links and information on fixing the issues.
- If you are using the Nova skin, you will want to setup your .htaccess file properly to reference the "www" in your domain if you are using it, as covered in this guide.
Troubleshooting
Following are some issues you may run into during your installation, along with a solution to help you overcome the issue.
- During the install process, I am seeing the following error: "Jamroom is not able to write to the "members" directory"
- In order for Jamroom to be able to store artist and member information, it must have a location where it can store the actual media files for your members. This is (by default) in the jamroom/members directory. Jamroom must be able to write to that directory. This means that the following Jamroom directories need to have their permissions set properly in order to allow the web user write access to the directories:
- jamroom/compile
- jamroom/config (at least during the installation process)
- jamroom/logs
- jamroom/media
- jamroom/members
- jamroom/uploads
The "proper" permission will either be 755, or 777, depending on how your server is running PHP. For details on how to tell the mode your PHP is running in, check out this entry in the Jamroom FAQ.
- After I have finished the Install process, Jamroom is still telling me that Jamroom is not installed - what's wrong?
- The Jamroom installer requires that PHP "Session" support be active on your server. On most web hosting servers, this is activated by default, but if you are seeing this error it could indicate that Session Support is not active. The way you can tell is that as you "move through" the Jamroom install process, you will see that Jamroom updates small graphic images at the bottom of the install screen to indicate what step of the install process you are on. If you find that as you move through the install process the "previous steps" icon does not update to indicate a check mark (that the step has been completed), then this indicates that PHP Session Support is not working properly on your server. You will want to contact your Hosting Provider and have them check your PHP Install.
|
