Documentation

Features

Differences

This shows you the differences between the selected revision and the current version of the page.

installation:instructions 2008/08/25 07:14 installation:instructions 2011/02/24 15:29 current
Line 1: Line 1:
====== Installation Instructions ====== ====== Installation Instructions ======
-Instructions for setting up and installing 68 Classifieds. +==== Instructions for setting up and installing 68 Classifieds.  ====  
 + 
 +**Please read through all of these instructions before starting your installation!!!**  
 +If you do not understand ANY of these instructions or you are not comfortable in performing all of these steps, please consider hiring a professional to install 68 Classifieds for you. 68 Classifieds offers this service as well as many of our listed Professionals in our third party offerings [[http://classifiedmods.com|Classified Mods]].
===== Creating your database ===== ===== Creating your database =====
Line 9: Line 12:
Some notes regarding database creation: Some notes regarding database creation:
-  * You will need to make up three things when creating your database - the database name, a database username and a password. Each of these three items can be pretty much anything you like - just remember to write them down! You will need them later.+  * You will need to make up three things when creating your database - the database name, a database username and a password. Each of these three items can be pretty much anything you like - just remember to **write them down!** You will need them later.
  * Some hosts append your account name to your database name. For example, if you name your database 'classifieds' (without the quotes!), your host may refer to this database as 'youraccountname_classifieds'. The same thing may occur with the database username you create ('youraccountname_username'). Typically, the only thing that remains exactly the same is the password you assign.   * Some hosts append your account name to your database name. For example, if you name your database 'classifieds' (without the quotes!), your host may refer to this database as 'youraccountname_classifieds'. The same thing may occur with the database username you create ('youraccountname_username'). Typically, the only thing that remains exactly the same is the password you assign.
  * Most control panels will review the values to use (such as 'youraccountname_classifieds') on the main database page after the database is created.   * Most control panels will review the values to use (such as 'youraccountname_classifieds') on the main database page after the database is created.
-  * On a vast majority of hosts, the location of the database will be 'localhost'. You can verify this on the main database page after the database is created.+  * On a vast majority of hosts, the location of the database will be 'localhost'. You can verify this on the main database page after the database is created. If your host does not use 'localhost' for the location of their database, they will provide a location you should use instead. It may look like 'mysql723.yourhost.com'
===== Upload your files ===== ===== Upload your files =====
 +
 +You will need to upload all of the files that are inside the "upload" directory (folder), but not the upload folder itself.
We'll use a method called 'ftp' (FTP = File Transfer Protocol) to transfer files from your computer to your host's server. You'll need an FTP application in order to complete this process. Some popular FTP programs are: We'll use a method called 'ftp' (FTP = File Transfer Protocol) to transfer files from your computer to your host's server. You'll need an FTP application in order to complete this process. Some popular FTP programs are:
Line 21: Line 26:
  * SmartFTP (http://www.smartftp.com)   * SmartFTP (http://www.smartftp.com)
  * CuteFTP (http://www.cuteftp.com)   * CuteFTP (http://www.cuteftp.com)
-  * FileZilla (http://filezilla.sourceforge.net/).+  * FileZilla (http://filezilla.sourceforge.net/)
-If you don't have an FTP program installed, you can use Windows Explorer to transfer files.+If you don't have an FTP program installed, you can use Windows Explorer to transfer files. In addition, many hosting services also offer a web based method to upload your files as well within their control panel. It is typically called something similar to disk manager or file manager.
-**Please note:** It's very important that ALL your files are uploaded to the server in order for your site to work properly. Some 68 Classifieds customers have had problems using Windows Explorer for FTP'ing their files. More advanced FTP programs will actually report which files were not successfully uploaded. Each of the FTP programs mentioned above should be fine but of the three, we prefer FileZilla. We've included images from FileZilla and Windows Explorer in our example.+**Please note:** It's very important that ALL your files are uploaded to the server in order for your site to work properly. Some 68 Classifieds customers have had problems using Windows Explorer for FTP'ing their files. More advanced FTP programs will actually report which files were not successfully uploaded.
-=====  CHMOD your folders =====+=====  Change your folders' permissions =====
-CHMOD is a command that stands for 'CHange MODe' and is used on *nix computers (Linux, Unix, etc) to set the permissions of files and folders. These permissions include read, write and execute. We need to change the permissions on the following folders:+Whether you're installing 68 Classifieds on an Apache server or a Windows server, you need to change the following folders' permissions.  
 + 
 +Within the "server pane" of your ftp application, highlight the following folders:
    * catimages     * catimages
 +    * Connections
    * license     * license
    * photos     * photos
Line 37: Line 45:
    * thumbs     * thumbs
    * uploads     * uploads
-    * Connections+     
 +In most ftp applications, you can right-click and choose "Permissions" or "Get Info" or "CHMOD". Your selection will vary depending on the ftp application you're using. Most hosting services also allow you to do this in the previously mentioned disk manager or file manager in your control panel. 
 + 
 +You should modify all of the folders' permissions to "Read, Write, Execute All". Shorthand notation for the correct permissions on Linux machines is 777. 
 + 
 +Apply the changes by choosing "Apply" or "Save" or "Submit".
===== Run the installation ===== ===== Run the installation =====
-So far, we've downloaded the files from the 68 Classifieds site, unzipped the files, uploaded the files to the server, changed the permissions on 5 folders and 1 file and created our database. We're now ready to start the installation process.+So far, we've downloaded the files from the 68 Classifieds site, unzipped the files, uploaded the files to the server, changed the permissions and created our database. We're now ready to start the installation process. 
 + 
 +<nowiki> 
 +Open a browser window and visit www.yoursite.com/setup/index.php (replacing 'yoursite' with your Domain Name). Then follow the steps displayed in your browser's window.</nowiki>
-Open a browser window and visit www.yoursite.com/setup/index.php (replacing 'yoursite' with your Domain Name). Then follow the steps.+**NOTE: If you are installing your 68 classifieds into an existing database, you MUST use a prefix for your database tables which can be entered in the field during the installation process!!!**
The final step after installation will be to **COMPLETELY DELETE THE ENTIRE 'SETUP' DIRECTORY**. If this is not done, your site will not work correctly. The final step after installation will be to **COMPLETELY DELETE THE ENTIRE 'SETUP' DIRECTORY**. If this is not done, your site will not work correctly.

Have more questions? Visit our community forums.