Note:Ensure your server has all of the system requirements before installation.
Note: This is new installation instructions, if you are upgrading, please follow the upgrade procedures and do not run the new installation.
Complete the following:
1. Create a new database and new user with full rights to the database.
2. Unzip with paths and upload all files from the downloaded zip file. Upload in binary mode. If your uploaded files are corrupt, use binary mode and reupload all files except the templates, docs, emails, ioncube, whois and js directories.
3. Using a text editor, edit your /includes/dbconfig.php file with the new database information, the path to your AWBS install location and your cookie domain. Be sure to read the remarks in the file for guidance and only edit where indicated. There will be a line to remove at the top.
Note: cPanel file editor is known to cause problems with the dbconfig.php file. Pico or wordpad are recommended.
To save upload time, you can edit before uploading as in Step 2.
4. Upload your personalized license.dat file to your installed directory. (The license is available for download in the 'view orders' area. Just click on the 'view' icon beside the correct order and you will find a download link)
Once you have the above information completed. Open your web browser and go to http://[yourawbsurl]/install/install.php
Important:
You must have read the AWBS license agreement and agree to abide by the terms to continue with the install.
Once you have read the license agreement, Check the box and click "Begin Install"
Welcome: (License Check)
The next step is to verify your license. You should see something like the following:
License Status: Active
Your licensing has been verified and your system is now activated.
Once the license has been verified click the box at the bottom of the page labeled "Continue With Install"
Note: Error 5 indicates the license.dat file is missing. Be sure you have uploaded the license.dat file to the same directory that you uploaded the AWBS files.
Error 3 indicates your server cannot reach our license database via port 80. Ensure your server has internet access via port 80.
Step 1:
The next step is to check your php.ini configuration settings and make sure everything is ready to go.
You should see something like the following:
Safe Mode: OK
Register Globals: OK
Session Cookies: OK
Compiled Curl: OK
Environment Tests appear OK. Let's continue.....
Once the above information has been tested, click the box at the bottom of the page labeled "Continue to step 2"
Step 2:
The next step is to check your database settings and make sure everything is ready to go.
You should see something like the following:
DB User/Pass: yourdbusername/yourdbpassword
Database Name: yourdbname
DB User/Pass: OK
DB Connect Test: OK
Database Exists: OK
Database Tests appear OK. Let's continue.....
Once the above information has been tested, click the box at the bottom of the page labeled "Continue to step 3"
Step 3:
The next step is to check your database structure and make sure the database is ready to go.
You should see something like the following:
Database Structure Creation appears OK. Let's continue....
Once the above information has been tested, click the box at the bottom of the page labeled "Continue to step 4"
Step 4:
The next step is to populate the database with your company's information. Fill in the following info and then continue.
You will need to fill out the information like shown below:
Company Information
Company Name:
Company Address1:
Company Address2:
Company City:
Company State:
Company Zip:
Company Country:
Company Phone:
Company Fax:
Admin Email:
Support Email:
Sales Email:
Server Settings
Edit the licensed urls if necessary. Add/Remove the WWW. as needed/desired, edit http and https as needed, and add any subdirectory information to the url. Do NOT add a trailing slash. If you do not wish to use https, make the bottom url the same as the top.
If you alter the domain name or subdomain, it will not match your license and you will have license errors.
Non-Secure URL: examples: http://[your_licensed_domain_name]/directory or http://[your_licensed_domain_name] or http://[your_licensed_subdomain]
Secure URL:
Note: The urls above should reflect the url you surf to to get to your awbs site.
Server Admin
This is where you will establish the 'super admin' account and login. The password can be changed later.
Remember this login!
Admin First Name:
Admin Last Name:
Admin Username:
Admin Password:
Once you have the above information filled out as needed, click the box at the bottom of the page labeled "Continue to step 5"
Step 5:
AWBS installation is complete!
At this point, the basic install is complete.
Click the box labeled "Finish Install"
Congratulations, Your copy of AWBS is now installed!
Now, login with the admin user account you created during install. Go through ALL settings and configure everything before attempting to place orders. TEST EVERYTHING BEFORE GOING LIVE!!
Please refer to the configuration section of this manual to help get configured properly.
CRON JOBS:
There are 4 cron jobs that need to be setup.
master_cron.php - schedule every 10 or 15 minutes as desired.
The master_cron.php will run the job queue.
invoice_cron.php - schedule every 24 hours at a low traffic time
The invoice_cron.php is responsible for generating invoices due, sending out invoices, late notices, etc to customers. It also charges the credit cards for recurring invoicing, if your processor is supported.
updateexp.php - schedule every 24 hours at a low traffic time
The updateexp.php cron checks for domains expiring in 60, 30, 7 and 0 days and sends out expire notices to customers.
updtransfers.php - schedule once per day
The updtransfers.php will check for completed transfers at the registrar and update the status in the AWBS database.
Example cron setup with cpanel:
php -q -f /home/userdir/public_html/tools/master_cron.php /home/userdir/public_html
Optional Cron Job:
lostpatrol.php - schedule as desired no more than once per day. This cron will remove all domain names in a lost status and move them to the domain archive table of the database. This tool can also be run manually in the system setup area of AWBS.
SECURITY:
Password protect (.htaccess) your tools, includes and admin directories. You can use the 'password protect directories' in cpanel to easily accomplish this.
Delete the entire 'install' directory when you are done installing.