This guide is for installing it-core from RPMs. These instructions
are based on Fedora, but should work on any Redhat-ish distro.
This mostly command-line references. Be not afraid. It's just more
concise and accurate than verbally describing graphic interfaces.
Install your OS. If your chosen distribution doesn't have good
documentation for this step, choose a new distribution.
If your distro includes SELinux (Fedora, CentOS, and Red Hat Enterprise
all do), disable it. There's no GUI for this. Edit /etc/sysconfig/selinux
and change the line:
This will fix a lot of permission headaches. You have to reboot
for the change to take effect.
Install some required packages.
# yum -y install httpd mysql-server php php-mysql php-xml php-pear php-ldap php-process
The first command, su, changes to the root user. You will be prompted for
root's password. The second command install a bunch of packages via
Red Hat package manager, yum.
Download and install it-core. Your filenames may differ slightly, depending on
the version number.
# rpm -Uvh it-core-0.1.0-1.noarch.rpm
# rpm -Uvh it-core-doc-0.1.0-1.noarch.rpm
# rpm -Uvh it-core-fannie-0.1.0-1.noarch.rpm
# rpm -Uvh it-core-is4c-nf-0.1.0-1.noarch.rpm
These commands should be run as root. The base it-core package is always
required. The it-core-doc package is just documentation and thus always
optional. The it-core-fannie package contains the backend server; it-core-is4c-nf
contains the lane point of sale system. Neither is strictly required, but
omitting both wouldn't make much sense.
Start required services
# /etc/init.d/mysqld start
# mysqladmin password
# /etc/init.d/mysqld restart
# /sbin/chkconfig mysqld on
The first command starts the mysql database. The second sets a root password. The
third command just restarts the database so the password change takes affect.
The fourth sets the database to automatically run on boot. Next is apache:
# /etc/init.d/httpd start
# /sbin/chkconfig httpd on
This one's simpler. Start the service, configure it to start on boot.
Open a browser and go to http://localhost/it-core/. You should see at least a
license as well as documentation, fannie, and/or is4c-nf folders depending
on what you installed.
Further ideas (Production environment)
An unsorted collection of gotchas as I discover them: