The InfoGlue platform is build on top of standard components and are therefore both easy to maintain and easy to upgrade. This reference will take you through the process of installing it for the first time. This reference is written for Windows and Linux-based systems. If you run a different OS the steps should be the same but some minor details may differ.
As the platform is written purely in Java we need the Java SDK installed. The correct version lies bundled with some distributions and should be version 1.4.1_02 or later. The software is collected on www.java.sun.com if you wish to do it yourself. When you got it just install the software according to Sun's installations instructions. After installation complete it by adding the following environment variables to the system:
SET JAVA_HOME={InstallationPath} (for example c:\Program Files\Java\jdk1.5.0_09 ) PATH=%PATH%;{InstallationPath}\bin (for example c:\Program Files\Java\jdk1.5.0_09\bin )
On windows, this is done by right-clicking on the My Computer-icon and selecting Properties. Then choose the tab Advanced and then Environment variables. In that dialog these settings are made. If you know how you can also make them at the command-prompt. To verify that the installation worked, start a new command prompt and type "java -version". The result should be something like this:
We also strongly recommend that you set up some environment parameters:
SET CATALINA_OPTS=-XX:MaxPermSize=256m -Xms256M -Xmx1024M
In addition to those variables we suggest you think about setting up a different network ttl as by default Java caches successful dns lookups. This means that if you move a server InfoGlue relies on to a different IP you can end up with network problems until the tomcat is restarted. Read more on how this works here
http://java.sun.com/j2se/1.5.0/docs/guide/net/properties.html. We usually use the Sun JVM so we use their command property.
The same environment-variables should be set up on Linux but you know how to do it if you have some experience with the OS.
The application has to have a servlet 2.3 compatible environment to run in and today we support only Apache Tomcat 5.x or above. This software is of course free and can be found at http://tomcat.apache.org but it is also included in some distributions. To check that the installation was successful you might want to start tomcat from the start-menu and then browse to http://localhost:8080. There you should see a tomcat information screen. After this check please stop tomcat and proceed to step 3.
All information in the InfoGlue platform is stored in a database. This database could in theory be any JDBC-2 compliant database like MySQL, Sybase, Progress, SQL-Server, DB2, Oracle just to mention a few. This tutorial will instruct how to install the fast, competent and free MySQL database. You can fetch it from www.mysql.com. We require version 3.23 or later but strongly suggests using version 4 or higher as a number of limitations has been removed in that version. Install the database as instructed by the MySQL documentation. If you want to use large attachments on your sites like very large images or movies you must follow the instructions on http://dev.mysql.com/doc/refman/5.0/en/packet-too-large.html. The standard limit is about 1Mb so you will probably want to do that.
A user contributed on the subject of mysql and unicode:
Do the following to make it work with MySQL 5.0 and UTF-8 before installing InfoGlue / creating it's database:
Add the following to the [mysqld] section of /etc/mysql/my.cnf:
default-character-set=utf8
Time has come to install the InfoGlue platform itself. The installer comes in a zip-file which you just unpack with your favourite unzip-program. In the installation directory there is a visual installer you start by running the install.bat(windows) / install.sh (Linux) file. If you prefer a command based installation run installcmd.bat (Windows) / installcmd.sh (Linux) instead. The installer will try to guide you as much as possible and if you move the mouse over the labels in the visual installer more help will be shown as tooltips. If you want to run it from Unix/Linux-systems you have to set the rights on the new directory so it can be executed. This is done by �chmod 777 * -Rf� in the newly unzipped directory. Below is a small sequence for linux-users and it assumes you are located in the directory where you downloaded InfoGlue 1.1.zip:
unzip "InfoGlue 1.1.zip"
chmod 777 "InfoGlue 1.1" -R
cd "InfoGlue 1.1"
./installcmd.sh
Here are detailed descriptions of the fields:
Database dialog:
Database type: The database brand you wish to install InfoGlue on. Valid are "MySQL" and "SQL Server".
Database name: The name of the infoglue database. Not editable.
Database suffix: This field gives you the option to add a suffix to the database name so you can have more than one InfoGlue installation in the same database. Used primarily in hosting services.
Database server: The hostname of the database server on which the database is located. Can be an IP or a hostname.
InfoGlue password: The password InfoGlue is to use for connecting to the database internally. This password is not related to users CMS-logins.
Create database: Do you wish to install a new InfoGlue database? If you already have an infoglue installation and wish to keep the data you probably don't want to.
Admin name: The root username to the database. InfoGlue needs it to be able to create the database.
Admin password: The root password to the database. InfoGlue needs it to be able to create the database.
Converting an existing database: If you have an existing database and have non western characters (outside the ISO-8859-1 area) you would want to convert the contents during the upgrade. Make sure you have a backup of the database before you continue. This option should only be selected once for your database. So if you previously have run an upgrade from 1.0 you should not do this again as that can corrupt your data.
Server dialog:
Host Name: The hostname or IP-address of the application server you are installing InfoGlue on. If you want people to access your site from other computers this is important to set correctly.
Port number: The port number tomcat operates on.
Application suffix: The suffix will be added to the name of the InfoGlue applications. This feature is mostly used in shared environments like hosting services. You can leave it out if this is a one-client installation.
Tomcat HOME: Point out the home directory of your tomcat installation. Often something like c:\Program Files\Apache Group\Tomcat 4.1
InfoGlue HOME:Point out the home directory of your InfoGlue directory. As InfoGlue will create a couple of applications/subdirectories you are wise to create a common InfoGlue directory somewhere on the disc which you then supply.
Applications to install:InfoGlue consists of several applications and two are mandatory. You are also able to select if you wish to install a preview-deliver and a live-deliver. The preview-deliver is used for preview at publication and the live site shows only published data and are aimed to be the deliver used for the public. Both options are recommended.
SMTP Host: Your email server used for outgoing mail.
After installation you should start Tomcat again and open the address stated by the installation program. The default login name is �administrator� and you should leave the password blank. If images does not show and you are running Linux you probably have to chmod the directory digitalAssets and logs under each installer application so the applications are allowed to create files there.
Now you are ready to go!! Good luck in building you websites.