<p class="lead" align="left">War Chest Builder Installation</p>
<p>This section will cover doing an installation, yourself. First obtain the .zip package from your member account at: <a href="http://www.warchestbuilder.com/clients" target="_blank">http://www.warchestbuilder.com/clients</a>. </p>
<p>Once  you have it, unzip it on your hard drive. You should have a folder  similar to \wcbv2k3_php with a subdirectory named \wcbv2k3 or similar.  Change to that directory. There should be 4 subdirectories inside that  named: docs, install, wcb and wcbemp.</p>
<p>You will need to upload the  install, wcb and wcbemp directories completely to your production  server (where you want the War Chest Builder). It is recommended that  you use a good FTP program such as WS_FTP. When using WS_FTP make sure  you turn off 'force lowercase', as many files are case sensitive. Also  checkmark the Auto mode (for ASCII/BINARY). Although php files are  normally uploaded as ASCII, you must upload the War Chest Builder php  files as BINARY due to encoding. If you have the .php extension listed  in the ASCII extensions list, then remove it before uploading. (See the  Options -&gt; Extensions tab in WS_FTP).</p>
<p>You need to upload the  install, wcb and wcbemp directories to your web site home directory.  You need to be able to access from a web browser as <a href="http://yourdomain.com/wcb" target="_blank">http://yourdomain.com/wcb</a> <a href="http://yourdomain.com/install" target="_blank">http://yourdomain.com/install</a> and <a href="http://yourdomain.com/wcbemp" target="_blank">http://yourdomain.com/wcbemp</a> . The wcbemp directory is for employees only. This is where they  perform keyword checking operations and is separate from the main  builder.</p>
<p>Before proceeding you should setup the MySQL database to  be used by the War Chest Builder. If you are using cPanel for a control  panel you can do it from there fairly easily. Login to your site's  cPanel interface, typically <a href="http://yourdomain.com:2083" target="_blank">http://yourdomain.com:2083</a> or <a href="https://yourdomain.com:2083" target="_blank">https://yourdomain.com:2083</a> </p>
<p>Click  on the MySQL icon. At the top of the page you can enter a name for the  new database. Click 'Create Database'. Once it is created you need to  add a user to it. If there are no usernames already listed you can add  a new user and password to use. Look for the Current Users section.  Enter a username and password and click 'Create User'. Once created you  will need to add that user to the new database you created. Scroll down  to 'Add Users To Your Databases'. Select the username from the list box  on the left side and select the database name from the list box on the  right side. Checkmark All for privileges and click 'Add User To  Database'.</p>
<p>It is important that you note the username and  database name, as they will not be as entered. They begin with the site  username followed by an underscore _ then the name you chose. Long  names are chopped off by cPanel. It is extremely important you use the  correct ones in the installer configuration because your license may  only allow 1 install, and reloading the page in the event of an error  may exceed your install count. If that happens to you, let us know  immediately.</p>
<p>Before running the install, you will need to set  permissions on several directories and files. The list is in the  /install/perms.txt file. All of the directories and files in that list  need to be set to chmod 777 or rwxrwxrwx. After successful installation  the install dir can be set to chmod 400 or r-------- and the wcb and  wcbemp can be set to chmod 755 or rwxr-xr-x.</p>
<p>If you are  comfortable using SSH (secure shell) you can optionally run the first  step of the install from shell and the permissions will be  automatically set. If you run the first step from a web browser it will  attempt to set them, but in most cases php does not have permission to  change permissions when run from a web browser. Setting the permissions  manually via FTP is the best way, although somewhat tedious.</p>
<p>To  run the first step from SSH, login to your web site using the web site  username and password (not as root). If SSH is not enabled for the  site, enable it first. If you are not running cPanel, you can manually  enable it by editing /etc/passwd and finding the username, then  changing the shell at the end of the line. It will look similar to  this:  username:x:597:597:username:/home/username/:/sbin/nologin  or  username:x:597:597:username:/home/username/:/bin/false</p>
<p>Change it to:  username:x:597:597:username:/home/username/:/bin/bash</p>
<p>Make sure you change username with the real username. If you're not comfortable with doing this ask your server administrator.</p>
<p>Once  SSH is enabled for the site user, login using that username and  password. Then change to the install directory. When you login you  should be in /home/username. To verify that, type pwd and press enter.  Your home directory should be either www or public_html. If you do a  directory listing you may see both, one is the real directory and one  is a symlink that simply points to the other. So, essentially www and  public_html are the same. To get a directory list type:  ls -l and press enter. (i.e. lowercase Ls  dash lowercase L).</p>
<p>So  type cd www/install or cd public_html/install and press enter. You  should not get an error. If you get an error, it may be you're in the  wrong dir or the install dir does not exist.</p>
<p>Once in the install  dir, type php index.php and press enter to execute it. After it  finishes you can go to step 2 from your web browser by going to: <a href="http://yourdomain.com/install/step2.php" target="_blank">http://yourdomain.com/install/step2.php</a></p>
<p>From there on, follow the instructions that are displayed in each step.</p>
<p>See  the Getting Started section for information about where to get your  accounts for the Reseller Club domain registrar, WordZe keyword search  tool and Flickr photos. The account data for these will be asked for  during the installation. You can complete the installation without this  data. However, you will need to manually edit the configuration files  to add them later. You should not attempt to re-run the installer.</p>
<p>Near  the last step of the installation, the installer will attempt to setup  the cron jobs for the War Chest Builder. In many cases, the server will  not allow php to execute the command. If you do not see a list of cron  jobs on that page, then it did not work. In that case you will need to  set them up from SSH. Login to your site using the site's username and  password (not root). Then cd www/wcb/temp and then type: crontab  cronjobs.txt and press enter.</p>
<p>It should not return any output. To  verify they were setup, type crontab -l and press enter. (i.e.  lowercase L). It should list all of the cron jobs. Please note the  builder will not function without all of the cronjobs running.</p>
<p>See the section on 'Setting up the cronjobs for the War Chest Builder' for more details.</p>
