New Installation System Requirements

Make sure your system meets the following requirements.

Operating System


§ Unix/Linux Operating System


Windows Users: Please take a look at the Windows IIS Setup document.


Secure Certificate


§ SSL (HTTPS) Recommended


Using a SSL or Secure Certificate will show your customers that ordering from your website is safe and secure.


Database System


§ Database: MySQL >= 3.23


Most servers are already setup with the latest MySQL database. To learn more, visit http://www.mysql.com.


PHP


§ PHP Version > 4.3.x


Most servers are already setup with the latest PHP version. To learn more, visit http://www.php.net.


php.ini Settings


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


§ 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

File: include/config/config.locale.php

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.