Front page | Download | Installation | Updating | Screenshots | FAQ | Author | License

Jump to: Server Installation | Agent Installation (Unix) | Agent Installation (Windows) | Skin Installation

Note: if you have previous Tellu version up and running and you want to upgrade it, please proceed to here.

It is recommended first to build and install the servers, then build the Agent, and finally install the Skin. Please follow this order, especially if you are a first timer with Tellu. Read this guide carefully and go through each step. You will need some knowledge about Unix basic usage, as well compiling software using GNU tools for it.

Easiest way to get Tellu installed is to install everything on same machine. So for easiest and simpliest installation model you need one server machine with:

and following are optional, you need them only if you want to build telmon (the graphical Tellu server monitoring tool):

SERVER INSTALLATION

Building the servers

These prerequisities are mandatory for succesfully building the servers:

and following are optional, you need them only if you want to build telmon (the graphical Tellu server monitoring tool):

Once you have all required libraries and headers reachable, you can build all server programs and telmon at once with following script seen below, here you need to tune paths to suit your environment. If you are using some common Linux distribution for example, setting `/usr' as a parameter for all those `--with-*' switches is probably enough.

 $ tar -zxvf tellu-server-X.Y.Z.tar.gz
 $ cd tellu-server-X.Y.Z

 for i in telinfo tellud telmon telmond telskind; do
	(cd $i && ./configure \
		--prefix=/usr/local \
		--with-mysql=/opt/mysql \
		--with-openldap=/opt/openldap \
		--with-motif=/opt/motif \
		--with-x11=/usr/X11R6 && \
		make clean && make && make install ) || exit 1 ;
 done

On BSD you might want to do this:

 $ tar -zxvf tellu-server-X.Y.Z.tar.gz
 $ cd tellu-server-X.Y.Z

 for i in telinfo tellud telmon telmond telskind; do
	(cd $i && ./configure \
		--prefix=/usr/local \
		--with-pthreads=/usr/local \
		--with-mysql=/usr/local \
		--with-openldap=/usr/local \
		--with-motif=/usr/local \
		--with-x11=/usr/local && \
		make clean && make && make install ) || exit 1 ;
 done

NetBSD users should set `/usr/pkg' instead of `/usr/local'.

If you don't want to use script above, remember that it is VERY important to run `make clean' before `make' and `make install', because there is some common source files shared between servers in `common' directory, and if some common file compiled for one server is linked to another it may cause fatal conflicts. So please always remember `make clean' before `make'.

After succesful build, you can copy `common/tellu.init.d' file to `/etc/init.d/' directory and use that for controlling the servers. tellu.init.d script obeys normal init-script style parameters, like start, stop, restart and status, whose behaviour should be self explainable.

If build fails because of missing dependencies (even when configure script succeeded), you need to tailor Makefile by hand. Makefiles are very simple (less than 40 lines), so editing them should not be too painful.

Configuring the servers

Before starting Tellu servers you need to check configuration files, they are located at `PREFIX/etc'. PREFIX is the place which you chose when you installed the servers. For now it is wise to go with default settings, except MySQL parameters, which may be necessary to change. So, open `tellud.conf', `telmond.conf' and `telskind.conf' and look for `mysql_' parameters from bottom of each file and change them to suit your environment. Leave `mysql_database', `mysql_username' and `mysql_password' as they are for now. You can also set `ldap_' parameters in `telskind.conf' at this point, if you want to use LDAP authentication in Tellu Skin. More of setting up Skin later.

The database

Now initialize Tellu database by cd'ing to the directory where you unpacked Tellu server package and tellu_db.sql file can be find, and by issuing command ($ denotes shell prompt, so don't type it):

 $ tar -zxvf tellu-server-X.Y.Z.tar.gz
 $ cd tellu-server-X.Y.Z
 $ mysql -h MYSQLHOST -u root -p < tellu_db.sql

and ofcourse replace MYSQLHOST with your MySQL host name, and if you like to use some other user for initializing than root, replace user also. If your user does not have a password, you can remove the `-p' switch.

If some reason you need to reinitialize the database, you need to drop Tellu database first before running `mysql' statement again. If you don't, you get all data duplicated in database because `tellu_db.sql' does not remove possibly already existing data.

Starting the servers

To fire up the servers, use `tellu.init.d' script which you hopefully copied to `/etc/init.d' directory or whichever is the place in your environment for init scripts:

  $ /etc/init.d/tellu.init.d start

should start all three servers, `tellud', `telmond' and `telskind'. If all went ok, you can proceed to installing Agent and Tellu Skin. In case of troubles, please consult the syslog.

AGENT INSTALLATION (UNIX)

Building the Unix Agent

These prerequisities are mandatory for succesfully building the Agent:

Once you have all required libraries and headers reachable, you can build the agent with following commands seen below, here you need to tune paths to suit your environment ($ denotes shell prompt, so don't type it). If you are using some common Linux distribution for example, setting `/usr' as a parameter for all those `--with-*' switches is probably enough.

 $ ./configure --prefix=/usr/local --with-dbus=/opt/dbus --with-hal=/opt/hal
 $ make clean
 $ make
 $ make install

If build fails because of missing dependencies (even when configure script succeeded), you need to tailor Makefile by hand. Makefile is very simple (less than 40 lines), so editing it should not be too painful. For example, if you are on Solaris, you may need to define some additional libraries `-lsocket -lnsl', in line 16 where all other libraries are defined.

Configuring the Agent

Before starting Tellu Agent you need to check the configuration file, `tellu.conf', it is located in `PREFIX/etc'. PREFIX is the place which you chose when you installed the Agent. Parameters which needs modification are at least `tellud_server', `tellud_port' and possibly `domain_override'. Do not touch other parameters yet. Set `tellud_server' parameter to server name where tellud is running, and `tellud_port' to the port which tellud listens (by default this is 1700). If agent is unable to resolve the domain name, you need to set `domain_override' parameter as well. So check the domain name, for example:

 $ domainname

and if command above does not return anything related to domain name, hardcode domain in Agent's configuration. Otherwise you can comment out the whole `domain_override' parameter.

Starting the Agent

Now you can start up the Agent:

 $ cd PREFIX/bin
 $ ./tellu

which collects machine data and sends them to tellud which stores collected data in database. Please check the server's syslog, there should be note about Agent's connection, as well the database is populated with collected machine data. Run Agent on every machine whose data you want to collect, either once or periodically. You can inject Agent in either boot scripts, login scripts, crontab, or whichever is suitable place in your environment.

AGENT INSTALLATION (WINDOWS)

Building the Windows Agent

Ready to run executable Agent is located in `tellu-agent-windows-X.Y.Z/Release' directory after uncompressing the `tellu-agent-windows-X.Y.Z.tar.gz' package. There are some free tools to unpack .tar.gz packages, for example 7-Zip and PowerArchiver. Agent is compiled using Visual Studio 9, which only create executables for Windows 2000 and later. If you need to run Agent on Windows 95/98 and/or NT machines, you need to compile Agent by yourself. I will not provide detailed compiling instructions here, because I cannot possibly know which kind of compiler you use. Basically Agent should be compilable using some earlier Visual Studio version, which will produce executable binary for your needs.

Configuring the Agent

Before starting Tellu Agent you need to check the configuration file, `tellu.conf', it is located in `tellu-agent-windows-X.Y.Z/Release' directory. It is normal ASCII-text file, so you can use Notepad for example to modify it. Parameters which needs modification are at least `tellud_server', `tellud_port' and possibly `domain_override'. Do not touch other parameters yet. Set `tellud_server' parameter to server name where tellud is running, and `tellud_port' to the port which tellud listens (by default this is 1700). If agent is unable to resolve the domain name, you need to set `domain_override' parameter as well.

Starting the Agent

Now you can start up the Agent in `tellu-agent-windows-X.Y.Z/Release' directory by double clicking it. If you don't see any error dialogs after couple of seconds, Agent has successfully collected machine data and sent them to Tellu server. You can open Task Manager to ensure that Agent has vanished from the task list and terminated its operation. Run Agent on every machine whose data you want to collect, either once or periodically. You can inject Agent in login scripts, create scheduled at-job, or whatever is suitable mechanism to run Agent in your environment.

SKIN INSTALLATION

Installing the Skin

Please use supplied installer script, found in `tellu-skin-X.Y.Z.tar.gz' package after unpacking it.

 $ tar -zxvf tellu-skin-X.Y.Z.tar.gz
 $ cd tellu-skin-X.Y.Z
 $ ./install.sh

Script installs the Skin after couple of questions about how Skin should be installed in your environment. Here you probably need to be root for succesfully install the Skin. You should have CGI (Perl) capable Apache installed already in same machine where you are about to install Skin.

Configuring the Skin

Skin needs modifications in your Apache configuration in order Skin to work. Generally you need to set `PREFIX/html' as DocumentRoot, and `PREFIX/cgi-bin' as ScriptAlias. Take a look this example below, you can use this template to create new virtualhost for Tellu Skin. Replace those PREFIX'es to the path where you installed the Skin.

 <VirtualHost *:80>
	ServerName tellu
	ServerAlias tellu.some.org
	ServerAdmin serveradmin@some.org

	DocumentRoot PREFIX/html/

	<Directory />
		Options FollowSymLinks
		AllowOverride None
	</Directory>

	<Directory "PREFIX/html">
		Options Indexes FollowSymLinks MultiViews
		AllowOverride None
		Order allow,deny
		allow from all
	</Directory>

	ScriptAlias /cgi-bin/ PREFIX/cgi-bin/

	<Directory "PREFIX/cgi-bin">
		AllowOverride None
		Options +ExecCGI -MultiViews +SymLinksIfOwnerMatch
		Order allow,deny
		Allow from all
	</Directory>
 </VirtualHost>

Logging for first time in the Skin

First time you log into Skin, use credentials below:

 Username: admin
 Password: admin

After you have logged in, proceed to Personal -> Administrate page, and change admin's default password from My account tab. You can also add some users at this point from Users tab, if some other personnel must have an access to Tellu Skin. Please note that if you use LDAP authentication, you do not need to create Skin users by hand, authentication module creates them automatically at first login.

Finetuning the Skin

To finetune some of the Skin's variables, open up the `PREFIX/cgi-bin/variables.lib' file using some text editor. Safely modifeable variables are listed below. Do NOT touch any other variables, especially if you don't know what for they exists! If you do, you broke the Skin installation and Skin becomes in unusable state.