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.

Step one

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.

Step two

Install some required packages.
$ su
# 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.

Step three

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.

Step four

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.

Step five

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: