After downloading Intrexx, unzip the downloaded package. Then start the
file "setup.sh". Select "Complete installation" and follow the instructions
in the dialog. Then open the Portal Manager, select "New portal", and,
using the following dialog, create a new portal.
While creating a portal, you can use the PostgreSQL database, and the newly
created "intrexx" user. Please enter the following connection data:
Database server
localhost
Port number
5432
Login
intrexx
Password
PASSWORD (the password previously assigned to the user)
The services "upixsupervisor", "upixp_Portalname" and "upixsolr" are already configured in such a way that they will automatically
be launched at system start.
Please note: If you selected an instance name during the installation, this is
part of the service name. The service names then appear as follows, for example:
upixsupervisor_instname, upixsolr_instname, upixp_instname_portalname
You can view all Intrexx services that are configured on the system with systemctl list-units 'upix*'.
If necessary, you can manually stop or start
the services. Please use the following syntax in the terminal to do that:
SuSE, Feodora / RedHat, Debian, Ubuntu
systemctl start / stop / restart / status upixsupervisor
systemctl start / stop / restart / status upixp_Portalname
systemctl start / stop / restart / status upixsolr
2. PostgreSQL installation
To use PostgreSQL as the database for Intrexx, it needs to be installed - together
with the relevant system tools - as a component of the current Linux distribution
afterwards. You can find out more about which
Versions of PostgreSQL databases are supported by Intrexx here.
SuSE
With SuSE Linux, use (for example) the system program "yast" or "yast2".
There you will additionally need to install the packages "postgresql"
(Clients and Utilities) and "postgresql-server" (Server). It is also
recommended that "pgadmin3" is installed to manage the databases,
provided a desktop environment is available on the server. If you only
have the command line available, you can install PostgreSQL as the root
user in the following manner:
zypper install postgresql postgresql-server
Fedora/Red Hat
Open the terminal as the root user and enter the following command:
yum install postgresql postgresql-server
Ubuntu/Debian
Use the Software Center and Linux, or the Synaptic Package Manager, in Debian. Alternatively, open the terminal and enter:
sudo apt-get install postgresql
After successful installation, the database needs to be configured. To be able to utilize the PostgreSQL DB, it must first be initialized.
service postgresql start
The PostgreSQL DB will thereby be initialized. Subsequently, the two
configuration files "postgresql.conf" and "pg_hba.conf" must be amended as
follows (Ubuntu users do not need to make this adjustment). To do this, a
suitable editor will be required – for example, Nano. If Nano is not already
available, you can install it as follows:
SuSE
zypper install nano
Fedora/RedHat
yum install nano
Debian/Ubuntu
apt-get install nano
3. PostgreSQL configuration
postgresql.conf
So that you can edit it, open the file
nano /etc/postgresql/9.1/main/postgresql.conf
in an editor and scroll down to the point "Connections and Authentication".
You can change the two entries
#listen_addresses ='localhost'
to
listen_addresses = 'localhost'
and (should the entry be commented out)
#port = 5432
to
port = 5432
In some older versions of SuSE
tcpip_socket = true
must also be set. Afterwards, save the configuration file with CTRL+O
and leave the editor with CTRL+X.
pg_hba.conf
So that you can edit it, open the file
nano /etc/postgresql/9.1/main/pg_hba.conf
in an editor and scroll down to the end of the file and find the line
host all 127.0.0.1/32...
Replace "ident", which comes after this line, with "md5", if "md5" is not
already defined as the default value. Then save the file and close the
editor. To activate the changes made, you will need to restart the
"postgresql" service.
service postgresql restart
Afterwards, a further user must be added. This user will be used later by Intrexx to create the database. To do this, login to the PostgreSQL database with the following commands:
su
su postgres
Now call up the PostgreSQL terminal with the user "postgres" and the
default database template "template1".
psql -U postgres template1
The following message should now be displayed:
This is psql <VERSION>, the interactive PostgreSQL terminal.
Enter:
\copyright for distribution terms
\h for help with SQL commands
\? for help on internal slash commands
\g or terminate with semicolon to execute query
\q to quit
template1=#
The user (and a freely selectable password) for Intrexx can now be created with the following command:
CREATE USER intrexx PASSWORD 'password' createdb;
If the password for the user "postgres" should be changed, please use the following command:
ALTER USER postgres PASSWORD 'password';
Following a successful update, exit the psql Terminal (not the terminal
window!) using the commands "\q" and "exit". If the method described
above does not work, please try making the change in the terminal with the
commands
sudo -u postgres psql
\password postgres
Set the administrator password
Set a password for the administrator as soon as the installation is complete.
Proceed as follows to do so:
Start the Portal Manager.
Click on "Extras > Administration logins...".
Select the "administrator" user in the dialog that opens.
Click on "Edit".
The dialog for changing the password will open.
Leave the "Old password" field blank. (The administrator will be given a blank password during the installation process.)
Set a new password and repeat it.
Click on "OK".
You will need to enter this password the next time you log in to the Portal Manager.
4. Parallel installations
If you would like to install multiple instances of Intrexx, please
consider the following points:
Installation path
Use a different installation directory.
Otherwise the new setup will replace the existing Intrexx installation.
Ports
Make sure the ports
for the new Intrexx services
and the existing ones are different.
Database
Use a different portal database.
It is especially important for test and development systems
that you do not use the same database as the productive system.