CentreSIS Configuration Guide

Main Configuration
Ok guys, this is the configuration guide with things that I‘ve noted during my config. For all you
experts out there, please be kind, as I’m from the Marine Corps and we believe in KISS (Keep It
Simple Stupid). This is what worked for me, so I merely pointed out some things to watch out
for.

Also, this is for a Windows installation of CentreSIS.

Now, in the directory where you have installed Centre, you will need to rename the
config.dist.php file to config.inc.php and change the following variables to match
your installation. Edit the config.inc.php file with the windows program Notepad:

Database variables:

$DatabaseServer is the host name or ip for the database server

$DatabaseUsername is the username used for authenticating the database
$DatabasePassword is the password used for authenticating the database
$DatabaseName is the database name
$DatabasePort is the socket port number for accessing the database
server
Don’t be concerned with
Exmaple from actual config.inc.php: what’s in red below. The lines
of text in red that you see with
$DatabaseType = 'postgres'; // oracle, postgres the // slashes has been
NULLED OUT.
$DatabaseANSI = true; // ANSI compliant flag.
$DatabaseServer = 'localhost'; // postgres = host, oracle=SID The example that you see
$DatabaseUsername = 'postgres'; before you is from an actual
$DatabasePassword = '********'; config.inc.php file. The
$DatabaseName = 'centre'; password has been removed
$DatabasePort = '5432'; for obvious reasons. But, for a
Windows Installation I have
found these to be the default
variable settings for
CentreSIS.

Also, be aware about port

number 5432 if you have
Windows Firewall running on
your system. You may have to
make an exception for this
port in order to connect to the
database.
NOTE: When HTMLDoc is installed several .dll files are required in order for HTMLDoc to
function properly under windows. These files are msvcrtd.dll, msvcr71.dll, libeay32.dll, and
ssleay32.dll. These files must be placed within the same directory where HTMLDOC is installed
too. The default installation path for HTMLDoc is ‘C:\Program Files\HTMLDOC’.

Now, I tried installing HTMLDoc to the Program Files directory, but it didn’t work for me. So I
installed it to ‘C:\HTMLDOC’ and placed the .dll files there as well. I made the changes to my
config.inc.php file to reflect the htmldoc path. This should be as follows: Don’t be concerned
with what’s in red
$htmldocPath = 'C:/HTMLDOC/htmldoc'; below. The lines of
text in red that you see
with the // slashes has
Or if HTMLDoc has been installed to ‘C:\Program Files\HTMLDOC’ then it is this. been NULLED OUT.

$htmldocPath = 'C:/Program Files/HTMLDOC/htmldoc'; If you look at the

installation paths to the
left, it is very self
Installation paths: explanatory. Just make
sure that your
config.inc.php matches
$CentrePath is full path to Centre installation
your system’s settings.
$htmldocPath full path to htmldoc for pdf 'printing'
$htmldocAssetsPath (new in 2.9) is path where htmldoc will access the Also be aware of
assets/directory your HTMLDoc
$StudentPicturesPath relative path to student pictures installation. Here is
$UserPicturesPath relative path to user pictures where you will set
your config file to
match your install.
Example from actual config.inc.php:
Just use the example
// Server Names and Paths
of config.inc.php as
$CentrePath ='C:/Program Files/BitNami WAPPStack/apps/centresis';
your guide.
$htmldocPath = 'C:/HTMLDOC/htmldoc'; // empty string means htmldoc
will not be called and reports will be rendered in htlm instead of pdf
$htmldocAssetsPath = 'C:/Program Files/BitNami
WAPPStack/apps/centresis/assets'; // way
htmldoc accesses the assets/ directory, possibly different than user
// empty string means no translation, reasonable examples follow
//$htmldocAssetsPath = $CentrePath.'assets/';
//$htmldocAssetsPath =
"http://$_SERVER[HTTP_HOST]".substr($_SERVER['SCR
IPT_NAME'],0,strrpos($_SERVER['SCRIPT_NAME'],'/')).'/assets/';
$htmldocAssetsPath = 'http://127.0.0.1/centresis/assets/';
$StudentPicturesPath = 'assets/StudentPhotos/';
$UserPicturesPath = 'assets/UserPhotos/';
$FS_IconsPath = 'assets/FS_icons/';
Centre program options:

$CentreTitle is the program title

$CentreAdmins is a comma separated list of admin's which have special
login privileges
$CentreNotifyAddress is email address to send error notifications
$DefaultSyear is current school year. It should be set to 2009 for a
new install.
$CentreModules controls which Centre SIS modules are activated in the
menu Don’t be concerned
with what’s in red
Example from actual config.inc.php: below. The lines of
text in red that you
$CentreTitle = 'Centre School Information System'; see with the //
$CentreAdmins = '4,5,6'; // can be list such as '1,23,50' - note, these slashes has been
should be id's in the DefaultSyear, NULLED OUT.
// otherwise they can't login anyway
$CentreNotifyAddress = 'root@localhost'; Just use the
$DefaultSyear = '2009'; example of
$CentreInstallKey = 'STDF5-PBA98-9569J-APUT8'; // You get a config.inc.php as
CentreInstallKey when registering you installation on the centresis.org your guide.
website in the Centre Directory
// This will enable access to online resources (documentation,
newsgroup, translations, etc.) directly from within Centre

$CentreModules = array(
'School_Setup'=>true,
'Students'=>true,
'Users'=>true,
'Scheduling'=>true,
'Grades'=>true,
'Attendance'=>true,
'Eligibility'=>true,
'Food_Service'=>true,
'Resources'=>true,
'Discipline'=>false,
'Student_Billing'=>false,
'State_Reports'=>false,
'Custom'=>false
);
Centre localization (new in 3.0):

$CentreLocales is the list of languages which Centre SIS should make Don’t be
available to users concerned with
$LocalePath indicates the directory where corresponding language packs what’s in red
are stored below. The lines
of text in red that
Example from actual config.inc.php: you see with the
// slashes has
$CentreLocales = array('en_US'); // Add other languages you want to been NULLED
OUT.
support here, ex: 'fr_FR', 'es_ES', 'it_IT', ...
// Language packs can be obtained by sending an email to
Just use the
info@centresis.org
example of
$LocalePath = $staticpath.'locale'; // Path were the language packs are
config.inc.php
stored. You need to restart Apache at each change in this directory
as your guide.

First login
You can now open a web browser and log into Centre SIS as 'admin' with the password
'admin'. You can login in several ways, if you are logging in locally to the system where
Centre SIS is installed then you can use the system’s Loopback address. The address in
your browser should read as follows:

http://127.0.0.1/centresis

If a Static IP Address has been assigned to the Centre SIS system like 192.168.10.23, and you are
logging in remotely from another computer, then the address in your browser should read as
follows:

http://192.168.10.23/centresis

Finally, if you know the Centre SIS’s Hostname you can use this also. For example, we
are going to use the Hostname centreserver. Then the address in your browser should read
as follows:

http://centreserver.schoolnetwork.lan/centresis

On your first login, the software will ask you if you want to send us an email about your
installation - please do so, as this helps us improve Centre SIS.

Once logged-in, you can create new users, and change and delete the three template
users. Since students can not be deleted, the template student should be changed to a
proper student and the template photo deleted.
Additional configuration
In addition to the main config.inc.php file there are optional module configuration
files, also named config.inc.php but located in the modules directories. See the module
specific documentation for details.