Centrallix - It's Different than what you Think
Home   |   Technology   |   Screen Shots   |   Download   |   Documentation   |   History   |   For Developers

Search...


Search For:

Index...


Centrallix Documentation

1.1.3 Source Installation


Source Installation

If you want to build from source, you can either do so via the source RPM's, and just modify the .spec file to suit your needs, or via building directly from the tarball (.tgz) files.

Building from source will allow you to customize the Centrallix options to best suit your needs, including optimization and hardening options, as well as other experimental options such as the Centrallix NFS server.

To build from source, download the require packages (see above), and untar them into a directory, perhaps cxbuild. You should have at least the three main subdirectories for the three required packages. How you proceed from there depends on whether you are doing the build and install as root or as an unprivileged user.

Building and Installing as an Unprivileged User:

$ cd ~
$ mkdir cxbuild
$ mkdir cxinst
$ cd cxbuild
$ tar -xzvf ~/centrallix-0.9.0.tgz
$ tar -xzvf ~/centrallix-lib-0.9.0.tgz
$ tar -xzvf ~/centrallix-os-0.9.0.tgz
$ tar -xzvf ~/centrallix-doc-0.9.0.tgz
$ tar -xzvf ~/centrallix-sysdoc-0.9.0.tgz
$ cd centrallix-lib-0.9.0
$ ./configure --prefix=~/cxinst
$ make install
$ cd ../centrallix-0.9.0
$ ./configure --prefix=~/cxinst
$ make install
$ make modules_install
$ make config
$ vi ~/cxinst/etc/centrallix.conf
    (change the port to something non-privileged, like 8800)
    (switch to altpasswd auth and set altpasswd file)
$ htpasswd -c ~/cxinst/etc/centrallix/cxpasswd yourusername
    (enter a password to access centrallix with)
    (only use the -c flag the first time you do this)
$ vi ~/cxinst/etc/centrallix/rootnode
    (change the path to /home/yourusername/cxbuild/centrallix-os-0.9.0)
$ vi ~/.bashrc
    (add ~/cxinst/sbin to $PATH, ~/cxinst/lib to $LD_LIBRARY_PATH)
$ . ~/.bashrc
$ centrallix
    (now point your browser to http://localhost:8800/ )


Building and Installing as Root (be careful!):

Note: this procedure assumes you are installing the server under /usr/local, since most people will only put managed packages in /usr, leaving hand-installed stuff for /usr/local.

# cd /usr/local
# tar -xzvf /usr/local/archive/centrallix-0.9.0.tgz
# tar -xzvf /usr/local/archive/centrallix-lib-0.9.0.tgz
# tar -xzvf /usr/local/archive/centrallix-os-0.9.0.tgz
# tar -xzvf /usr/local/archive/centrallix-doc-0.9.0.tgz
# tar -xzvf /usr/local/archive/centrallix-sysdoc-0.9.0.tgz
# cd centrallix-lib-0.9.0
# ./configure --prefix=/usr/local
# make install
# cd ../centrallix-0.9.0
# ./configure --prefix=/usr/local
# make install
# make modules_install
# make config
# vi /usr/local/etc/centrallix.conf
    (customize the settings to your liking)
# vi /usr/local/etc/centrallix/rootnode
    (change the path to /usr/local/centrallix-os-0.9.0)
# centrallix
    (now point your browser to http://localhost:800/ )



Comments...


Dave on 2008-Dec-12 01:19
I had to run the following command to install the necessary packages before following the steps:
sudo apt-get install cvs makedepend libreadline5-dev libpng12-dev libssl-dev zlib1g-dev

all debian-based linux distros (e.g. uBuntu) need the following library depedency to be installed:
zlib1g-dev (thanks Seth)

I also needed to install the following dependencies (thanks Josiah Ritchie):
cvs makedepend libreadline5-dev libpng12-dev libssl-dev

It may not be required, but I ran './config.status' before I ran 'make config'

Seth Bird on 2008-Jun-26 16:21
It's not really mentioned anywhere else, but the zlib-dev (and maybe zlib) package is required. If you don't, then you get a very unhelpful linker error that's hard to figure out how to resolve.



Add a Comment...


Your Name:
Comment:


(c) 2001-2008 LightSys Technology Services, Inc. All trademarks are property of their respective owners.

Project Hosting Provided By:
Hosted by Sourceforge