Installing webJobs

Requirements

Before you begin the installation please make sure that the server you are using for hosting meets the system requirements. If you are hosting with Web Scribble Solutions all of the server requirements have been met, regardless of which plan you have. 

• PHP 5.0.x or higher with safe_mode disabled 
• Ioncube Loaders 3.0 or higher
• Unix/Linux or Windows Apache web server (Windows IIS is not compatible with webJobs)
• MySQL database
• FTP access to your web server 

Download and License

Before you begin the installation process you must create a license for your web site. A license activates the product so that you can use it without any interruptions. Each license is specific to a domain name (i.e. yoursite.com) and you can only assign one domain name per license.

Be sure to create a license and generate a new license key. Copy this key to your clipboard, or save it in a convenient place as it will be used shortly.

If you have not yet downloaded the software from Web Scribble Solution's members area, download it now by following these steps:

1. Log into the Members Area at http://secure.webscribble.com/cart/account.php.
2. Click the Downloads link.
3. After you have reached this page, you will be given the option to download a zip file. To download, click on the Download button to the right of webJobs.

Unzip the webjobs_4.1.0_standard.zip file onto your local hard drive. Make sure that the file structure is preserved when you unzip the file. It is extremely important that the files and folders contained within the zip file preserve their structure.       

If you do not know how to unzip a file read the sections below for specific instructions. Otherwise, skip to the Uploading the Files section. 

Uploading the Files

Once the files have been unzipped on your local hard drive you are ready to upload them to your web server. Make sure that the file structure is preserved when you unzip the file. It is extremely important the the files and folders contained within the zip file preserve their structure.

Begin by uploading all files and folders in BINARY mode. It is extremely important that all the files are uploaded in BINARY mode. If you do not know how to upload files or would like specific instructions read the sections below.

Warning Many FTP clients or editors such as Dreamweaver override your upload settings for certain files, causing .php files to be uploaded in ASCII rather than BINARY. If you receive an error similar to the one below, you have not successfully uploaded the files in BINARY: Fatal error: Incompatible file format: The encoded file has format ID 0, which is too old in /path/to/binary/file on line 0'

After you have finished uploading all of the files you will need to set the permissions on all files. Mostservers support 777 permissions. If you server does, apply permissions of 777 to the files/folders listed below, otherwise set the permissions to 755. If you get an Internal Server Error when you upload the files with 777 permissions it means your server does not support them.
This method should save you from most trouble during the installation. If security is a concern you can prioritize and keep 777 on the following areas

• smartway/conf/config
• all files under /templates
• rewrite.php

Installation Wizard

The Installation Wizardtakes you through the process of configuring your database information, executing the necessary MySQL data, and setting some basic administrative information. The purpose of the Installation Wizard is to eliminate any manual editing of configuration files or executing of MySQL queries.

To begin the Installation Wizard go to http://_www.yoursite.com_/install.php. Replace yoursite.com with your actual site address. 

If the previous sections of manual were followed properly and the permissions on all the files were set properly you should see a page with a form asking you to enter the Database information (shown below). If you did not set permissions on certain files an error will appear notifying you which files you need to set the permissions on. You must set the proper file permissions before continuing with the installation process. 

This first form will configure webJobs for your MySQL Database. The form consists of four fields and one checkbox: Database Host, Database Username, Database Password, Database Name, and Overwrite existing tables. You must enter a value for each of the 4 fields.  

• Database Host: Enter your database hostname/address. In most common server configuration the value you enter is "localhost". Some servers do require that you use another address. You can enter a domain name or IP address in this field. If you are unsure of what to enter contact your hosting company to request this information.
• Database Username: Enter the username of a user that has access to the database. If you are unsure of what to enter contact your hosting company to request this information.
• Database Password: Enter the password for the username entered above. If you are unsure of what to enter contact your hosting company to request this information.
• Database Name: Enter an existing database name or one you would like the installer to automatically create. Note that if the user does not have proper permissions to create a database the installer will output an error message stating so. You will then need to manually create the database yourself.
• Overwrite existing tables: Check this box if you would like the installer to overwrite any tables that may already exist in the Database you have entered above. Note that if this box isn't checked and there are tables in the database, the installer will return to this page when you attempt to continue.

After you have entered values for all the fields click the Proceed button. 

If there were no problems with the database creation/populating, you will see a link to the next step (shown below). Click the link ("Proceed to the Next Step") to continue.

You will now see another form asking for administrative information (shown below). Every field in the form below must be completed. 

• Base URL to this Installation: Enter the URL where webJobs is installed. The URL must end with a trailing slash .
  Example: *http://www.yoursite.com/*
• Your serial number: Enter your serial number for your copy of webJobs. The serial number was sent to you in your welcome e-mail (the same e-mail that contains download instructions for the software). If you do not know your serial number or have misplaced it, contact our staff to retrieve it.
• Administrative login name: Enter the username you wish to have to access your webJobs administrative area.
• Administrative password: Enter a password for the username you specified above.
• Confirm Administrative Password: Retype the password for confirmation.
• Administrative email: Enter the e-mail address you would like to be used as the administrative email throughout the site.

After you are finished, click the Proceed button.

If no errors occurred during the installation, you will be sent to the final installation page. Once you are here, the installation is complete. You are asked to delete the install.phpfile to prevent any malicious actions. It is recommended that you do this. Also, there is a link to the administrative area in which you can login to using the Administrative Username / Password that you set up in the second step.

A common error is that the install script cannot create the lock file. If this error occurs, you will be notified at this time. This is *not a fatal error, nor does it mean the installation failed. This just means that if the install file is run again, it will run as it did for you, and possibly reset the database tables. To prevent this (highly recommended), delete the install.php file.