New Installation System Requirements
Make sure your system meets the following requirements.
§ Unix/Linux Operating System
Windows Users: Please take a look at the Windows IIS Setup document.
§ SSL (HTTPS) Recommended
Using a SSL or Secure Certificate will show your customers that ordering from your website is safe and secure.
§ Database: MySQL >= 3.23
Most servers are already setup with the latest MySQL database. To learn more, visit http://www.mysql.com
§ PHP Version > 4.3.x
Most servers are already setup with the latest PHP version. To learn more, visit http://www.php.net
Every PHP install has a php.ini file. The php.ini file is the main configuration file for your PHP install. Remember to restart your web server every time you update your php.ini file. There are two ways to verify that you have the following set in your php.ini file. The first way is to locate the php.ini file on your server, open the file, and search on the following variables. Change accordingly. The second way is to create a phpinfo() file on your web server and view it via any web browser. The second method is for more advanced users. Make sure your php.ini file has the following variables set.
§ register_globals = On
§ register_argc_argv = On
§ open_basedir = no value
§ short_open_tag = On
§ safe_mode = Off
§ error_reporting = 2039
§ memory_limit = 32M
§ register_long_arrays = On
Zend vs. IonCube
Your ModernBill is available in two encoded versions, Zend and IonCube. The only difference between the two is that Zend must be installed on your server before you can use the Zend encoded version, whereas the IonCube version is pre-installed with your ModernBill system.
§ To learn more about Zend Optimizer™, visit the Zend website at http://www.zend.com
§ To learn more about IonCube Runtime Decoder (Included), visit the IonCube website at http://www.ioncube.com
§ cURL with SSL enabled either complied in PHP or available via the CLI (command line interface)
To learn more about cURL, please view the cURL Setup document.
New 4.3 Install
Step 1 - Create a new database for your billing system
You can create your database by using a MySQL GUI such as PHPMyAdmin or you can use the command line as follows:
Here is the MySQL command: mysqladmin -u USERNAME -h localhost -p create DBNAME
Replace the BOLD variables with your own variables.
More MySQL Command Line Help - Adding New Users to MySQL
Step 2 - Upload all files to your web server in BINARY format
The billing system files are encoded using either Zend Encoder or ionCube Encoder. Encoding PHP source files will create BINARY PHP files. This means that you will need to manually set your FTP client to transfer the PHP files in BINARY mode to your web server. Some FTP clients have an automatic setting that can detect if a file is ASCII or BINARY, however they are not always accurate. The following error is due to this exact issue: Fatal Error: Unable to read xxxx
WARNING: DO NOT use the automatic transfer detection setting in your FTP client, it will corrupt the encoded files.
Using WinZip To Install
1. Follow Steps 2 through 6 in the Upgrading instructions.
2. Continue on to Step 3 below.
Unzip Using The Command Line (This does not apply to the Demo version.)
In order for this to work you need shell access or a shell account and a FTP program.
1. Upload YOURFILE. tar.gz using your FTP client to your server.
2. On the shell command line, type the following command and press Enter.
gunzip -c NAMEOFYOURFILE.tar.gz | tar xvf -
3. Continue on to Step 3 below.
Step 3 - Edit the config.locale.php file with your database and URL settings
Replace with your database settings from Step 1:
$locale_db_host = 'localhost'; # <-- Your DB HOST $locale_db_login = 'USERNAME'; # <-- Your DB LOGIN NAME $locale_db_pass = 'PASSWORD'; # <-- Your DB LOGIN PASSWORD $locale_db_name = 'DBNAME';# <-- Your DB NAME
Replace with your installation URLs:
$standard_url = "www.domain.com/demo/"; # <-- ENTER YOURS HERE! $secure_url = "www.domain.com/demo/"; # <-- ENTER YOURS HERE!
Using a SSL Certificate? Enter "https" as shown below. If you are not using a SSL Certificate, enter http. $https = "https"; # <-- ENTER YOURS HERE!
Step 4 - Run the web based installer script from your browser
Point your browser to https://www.yourdomain.com/INSTALLDIR/install_v4/
and select new install.
INSTALLDIR = By default your ModernBill is extracted in a directory called /modernbill/. You can leave the default name /modernbill/ or change it according to your own personal preference.
Step 5 - Delete the /install_v4/ directory in its entirety after you have completed your ModernBill installation.
Step 6 - Login and configure your billing system
Read release notes
To read the release notes, go to http://forums.modernbill.com/showthread.php?p=120935