These instructions are for those who wish to set up BCOE&M on their own web server. Hosted installations follow a different procedure outlined in a setup email subscribers receive after paying for the service.
BCOE&M has been tested with PHP version 5.6.X and MySQL version 5.5.X. If you plan on installing on a local server, we recommend downloading and installing Xampp 5.6.23 for your operating system. Xampp, a PHP development environment from Apache Friends, contains the correct versions of PHP and MySQL (via MariaDB) for use with BCOE&M.
$databasevariables. You may need to alter the
$hostnamevariable depending upon your server setup. Check your hosting company’s documentation.
$prefixvariable on or around line 109. This is useful if you wish to have separate BCOE&M installations or other applications share the same mySQL database.
$setup_free_accessvariable on or around line 125 is set to TRUE.
$sub_directoryvariable empty if you are not installing in a subfolder –
$sub_directory = "";.
<?php // Configuration for an installation housed in a sub-folder $hostname = "localhost"; $username = "mycleverusername"; $password = "mysecurepassword"; $database = "bcoem"; $connection = new mysqli($hostname, $username, $password, $database); $brewing = $connection; $images_dir = dirname( __FILE__ ); $prefix = "bcoem_"; $setup_free_access = TRUE; $sub_directory = "/comp"; $base_url = "http://".$_SERVER['SERVER_NAME'].$sub_directory."/"; $server_root = $_SERVER['DOCUMENT_ROOT']; ?>
There are various reasons why the browser-based setup may not be successful. Below are some troubleshooting steps to take.
BCOE&M 2.1.9 has been tested with PHP version 5.4.43+ and MySQL 5.5.42. Make sure you have these versions installed on your webserver.
How do you check your server’s PHP and MySQL version? Simple, use phpinfo()...
<?php echo phpinfo(); ?>
If you encounter a blank screen during the setup process, first, make sure that you have the correct PHP version installed on your webserver. Previous versions do not handle session instantiation effectively for BCOE&M.
If you have verified that your PHP version is correct, the next step would be to perform a “Fallback Installation” - see below.
It is possible to install an instance of BCOE&M without using the browser-based installation process.
Included in the package download is a subfolder called “sql” that contains an SQL file called bcoem_baseline_2.1.X.sql. This file contains the complete database structure and dummy data to get you up and running. Complete instructions are at the top of the file.
To install the baseline database and dummy data, you will need access to your database via phpMyAdmin or shell access.