Written Installation Instructions>>
Here are installation instructions. These are for people already comfortable with performing database installations on LAPP (or LAMP) ISPs.
Note: Different ISPs use different configurations which may require variations from these installation instructions.
- Set up the Postgres database on your ISP
- Login to cPanel with your cPanel user (ie
linuxusr
) at your Linux based web host with Postgres. - Create a Postgres database on your web server using cPanel, for example named
linuxusr_sampledb
. - Create a Postgres user (ie
linuxusr_dbuser
) and assign this user to your database. - Login to phpPgAdmin using your cPanel login (ie
linuxusr
). - Issue this SQL statement in the query window to install the plpgsql language in your database (
linuxusr_sampledb
).CREATE LANGUAGE plpgsql;
Note: This statement must be issued by the owner of the database which is the cPanel user by default for most ISPs. However, for security reasons you do not want to run Brimbox under your cPanel login so you need to create a database user.
- Install Brimbox in your web folder
- Unzip
brimbox_core_vX.X.X.zip
on your desktop. It should unzip to the foldercore
. Change this folder name if desired toyourfolder
. - Open
bb_config.php
in subfolderbb-config
using a text editor and fill in your database detailsDB_HOST
is usually localhost
DB_NAME
is your postgres database name (ielinuxusr_sampledb
)
DB_USER
is your postgres database user name (ielinuxusr_dbuser
)
DB_OWNER
is your postgres database owner name (ielinuxusr
)
DB_PASSWORD
is your postgres database user password (not your cPanel login)
- DO NOT change the EMAIL settings as these take a little configuring and can be done later.
- Open
.htaccess
in the root folder using a text editor and substitute your folder name if desired for the default foldercore
in these lines. You can install to directorycore
without making changes to the.htaccess
file.RewriteBase /yourfolder/
RewriteRule . /yourfolder/index.php [L]Or if you are installing in a root domain.
RewriteBase /
RewriteRule . /index.php [L]
Since Brimbox should be running overhttps
this is a SSL.htaccess
file for the subdirectorycore
.RewriteEngine On
RewriteCond %{SERVER_PORT} !=443
RewriteRule ^(.*)$ https://www.yourdomain.com/core/$1 [R,L]
RewriteBase /core/
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /core/index.php [L] - Upload the Brimbox files to the desired location on your web server (make sure this is a binary upload, an ascii upload will alter the images):
- If you want to have your Brimbox installation in its own subdirectory on your web site (e.g.
http:// www.yourdomain.com/yourfolder
/) move or upload all contents of the unzipped Brimbox directory (excluding the directory itself) to the subdirectoryyourfolder
. Your database home will behttp://www.yourdomain.com/yourfolder/
- If you want to integrate Brimbox into the root of your domain (e.g.
http:// www.yourdomain.com/
), move or upload all contents of the unzipped Brimbox directory (excluding the directory itself) into the root directory of your web server. Your database home will behttp://www.yourdomain.com/
. - You could also set up a subdomain.
- If you want to have your Brimbox installation in its own subdirectory on your web site (e.g.
- Run the Brimbox installation script by accessing
dbinstall.php
in a web browser.- If you installed Brimbox in its own subdirectory called
yourfolder
, for example, you should visit:http://www.yourdomain.com/yourfolder/dbinstall.php
. - If you installed Brimbox in the root directory, you should visit:
http://www. yourdomain.com/dbinstall.php
- If you installed Brimbox in its own subdirectory called
- WAIT!!! You need to change the Brimbox admin password immediately.
- You should login and promptly change the password for the generic Brimbox “admin” user on the “Admin” tab of Brimbox interface. Go to
http://www.yourdomain.com/
orhttp://www.yourdomain.com/yourfolder/
if you installed under a folder, and login under user “admin” and password “password”. When you install a Brimbox database on your server a generic username “admin” and password “password” is issued so you can get into your database. You should go to the “Admin” tab and change that password in the module “Manage Users”, and add any users you want to the database. - Then delete the database install file in your web folder (
dbinstall.php
). It is not needed anymore. You have successfully installed Brimbox.
- Login to cPanel with your cPanel user (ie
Updated: 2016-07-25