Artikel-Schlagworte: „Installation“

Urchin Version 7.x – Installation unter Linux – Ergänzungen für Debian-basierte Systeme

Installation und KonfigurationIn meinem Artikel Urchin Version 7.0.00 – Installation unter Linux habe ich am Beispiel eines CentOS-Systems beschrieben, wie Sie Urchin installieren. Die Beschreibungen sind aber nur auf RedHat-basierte Systeme ohne Modifikationen übertragbar. Für Debian und Debian-basierte Systeme sind einige wenige Besonderheiten zu beachten.

Wichtig: An dieser Stelle möchte ich noch einmal explizit darauf hinweisen, dass bei der Ausführung des Urchin-Installationsskriptes die englische Sprache zu wählen ist.

Linux ist von Haus aus ein System, das für den Kernel monarchisch geführt ist, ansonsten aber völlig anarchisch ist. Daher darf niemand erwarten, dass ein mehrsprachiges Installations-Skript auch tatsächlich unter jeder x-beliebigen Randbedingung funktioniert. Der Kernel unterstützt garantiert ASCII-Zeichen. Die Unterstützung der anderen Zeichensätze obliegt den Distributionen und da kocht jede ihr eigenes Süppchen. Die einzige Sprache, die nur mit ASCII-Zeichen auskommt und somit die Installation reibungslos ermöglicht, ist nun einmal Englisch. Alle anderen Sprachen können funktionieren, müssen aber nicht.

Im Installationsskript von Urchin wird bei der Frage nach der Gruppe ein anderer Default angezeigt, nämlich nogroup statt nobody. Dieser Default ist ebenfalls zu übernehmen. Und es existiert im Installationsskript noch eine zweite Abweichung: unter Debian-basierten Systemen lautet der MySQL-Socketpfad in der Regel /var/run/mysqld/mysqld.sock.

Nach der Installation von Urchin verhält sich Urchin unter den Debian-basierten Systemen völlig anders, als unter RedHat-basierten Systemen. Auf RedHat-basierten Systemen läßt sich Urchin problemlos über den Befehl /usr/local/urchin/bin/urchinctl start starten und die Installation als Autostartservice ist eher optional. Auf Debian-basierten Systemen muss Urchin zwingend als Autostartservice installiert werden, bevor alle Urchin-Services gestartet werden können. Die Urchin-Webseite ist zwar funktional, aber Urchin verarbeitet nichts! Um dies zu ändern, muss zunächst die Datei /usr/local/urchin/util/urchin_daemons geändert werden. Dazu verwenden Sie unter Linux den Editor “vi” und geben auf der Kommandozeile den Befehl

vi /usr/local/urchin/util/urchin_daemons

ein. Damit wird der Editor gestartet und der Dateiinhalt angezeigt. Bewegen Sie den Cursor in die erste Leerzeile, fügen Sie den “INIT INFO”-Block, wie nachfolgend abgebildet ein und speichern Sie die Änderungen:

#!/bin/sh
# chkconfig: 2345 95 15
# description: Starts and stops the Urchin daemons

### BEGIN INIT INFO
# Provides:          urchin_daemons
# Required-Start:    $all
# Required-Stop:     $all
# Default-Start:     2 3 4 5
# Default-Stop:      0 1 6
# Short-Description: Starts and stops the Urchin daemons
# Description:       Controls the Urchin daemons "urchind", .urchincpcd
#                    and multiple "urchinwebd".
### END INIT INFO

# INSTALLDIR should be automatically set in this script when Urchin is

Nachdem Sie die Datei modifiziert haben, müssen Sie diese noch nach /etc/init.d/ kopieren und ausführbar machen, bevor sie als Service installiert werden kann. Für diese letzten Schritte verwenden Sie ab Debian 6 folgende Befehle, die Sie als root oder mit root-Rechten ausführen müssen:

cp /usr/local/urchin/util/urchin_daemons /etc/init.d/
chmod +x /etc/init.d/urchin_daemons
insserv /etc/init.d/urchin_daemons

Bei älteren Debian-Versionen oder anderen Distributionen müssen Sie den letzten Befehl möglicherweise gegen einen anderen austauschen. Den entsprechenden Befehl finden Sie in der Dokumentation der jeweiligen Distribution oder über die Google-Suche heraus.

Nun müssen Sie Ihr System nur noch neu starten und Urchin wird automatisch mit allen erforderlichen Diensten (Services oder Daemons) gestartet.

Viel Erfolg bei der Installation!
Ihr webalytics-Technikteam

Urchin Version 7.0.00 – Installation unter Linux

Wenn Sie die aktuelle Urchin-Version 7.0 testen wollen, stellt sich sicherlich die Frage, auf welcher Plattform und unter welchem Betriebssystem das passieren soll. Als Plattform eignen sich ausrangierte Server, virtuelle Maschinen, oder zur Not sogar Ihre Workstation. Letzteres kann sinnvoll sein, wenn Sie lediglich das Look & Feel ausprobieren möchten. Meistens will man aber mehr ausprobieren und sollte dann von vornherein eine der anderen Möglichkeiten einsetzen.

Wer eine geeignete Windows-Lizenz übrig hat, darf sie gerne ver(sch)wenden. Wir empfehlen für Testinstallationen von Urchin, sich eine aktuelle kostenfreie Linux-Server-Distribution herunterzuladen, z.B. Ubuntu oder CentOS (zu RedHat binärkompatibel) und zu installieren.

CentOS bietet zwar keine Serverversion zum Download an, aber während der Installation kann diese auf Server und/oder Server-GUI reduziert werden. Ubuntu-Server bringt dagegen keine GUI mit. Wer auf (Linux-) Kommandozeilenebene nicht so fit ist, sollte sich eine GUI (Gnome oder KDE) installieren.

Systemvoraussetzungen für eine Installation

Entscheidungsworkflow für eine Installation von Urchin 7.000Geeignete Windows-Systeme sind Windows 2003 Server, Windows XP, Windows 2000, Windows Vista, Windows 2008 Server, ab Urchin 7.0 auch in den 64-bit Versionen unterstützt. Von den Unix-basierten-Systemen werden Linux-Kernel 2.6 (32-bit und 64-bit), sowie FreeBSD 6.2+ (nur 32-bit) unterstützt. Für Urchin geeignete Datenbanken sind MySQL 5.03+ oder PostgreSQL 8.2.5+. Um die im Installationspaket von Urchin 7.0.00 mitgelieferte PostgreSQL 8.4.1.1 unter Linux(Kernel 2.6) zu installieren, wird die glibc 2.3.3+ benötigt.

Für die Analyse einzelner kleiner bis mittelgroßer Websites sollte das System wie folgt ausgestattet sein:

  • 2 GHz-Prozessor oder schneller
  • 2 GB RAM
  • 250 GB Festplattenlaufwerk (IDE oder SATA)
  • 00 MBit/s-Ethernet-Schnittstelle

Bei Installationen für Provider oder größerer Unternehmen sollte das System folgendermaßen ausgestattet sein:

  • 2,5-GHz Pentium Dual-Core / 2-GHz UltraSPARC / PPC, MIPS oder anderem mit ähnlichem CPU Geschwindigkeitsbereich
  • 3 GB RAM
  • Ultra2/Wide SCSI-Festplattenlaufwerk (z. B. Seagate Cheetah), Kapazität nach Protokollaufkommen
  • 100 MBit/s-Ethernet-Schnittstelle
  • Backupsystem.

Als Plattenplatzbedarf muss mit ca. 10% der der Originalprotokollgröße gerechnet werden. Für die Anzeige der Urchin-Benutzeroberfläche sind die Browser Internet Explorer 6.x+, Firefox 2.x+ oder Chrome 1.x+ geeignet. Weitere Informationen finden Sie im Urchin-Helpcenter.

Warum beschreiben wir die Installation unter Linux mit Kernel 2.6?

Die Installation von Urchin unter Windows gestaltet sich eher trivial. Die benötigten Informationen sind sowohl für Windows, als auch für Linux identisch. Da unter beiden Systemen die gleichen Fragen gestellt werden, es unter Linux – je nach System – aber die eine oder andere kleine Hürde zu nehmen gilt, beschreiben wir hier die Installation unter Linux. Dadurch wird die Installation unter Linux hoffentlich so einfach, wie die unter Windows. Für den Kernel 2.6 haben wir uns entschieden, da dieser Kernel der aktuellste und wohl der verbreitetste ist.

Vorbereitungen

Sollten Sie die Installation in einer virtuellen Maschine auf Ihrer Workstation vornehmen wollen, so achten Sie bitte darauf, dass Sie die Netzwerkschnittstelle im Bridging-Modus betreiben. Erst dann ist gewährleistet, dass Sie selbst und andere darauf zugreifen können.

In dem Fall, dass Sie eine Neuinstallation des Betriebssystems vornehmen, sollten Sie alle nicht benötigten Server und Dienste abwählen. Sie brauchen in der Regel lediglich den OpenSSH-Server und evtl. eine Datenbank, sowie Samba. Einen Webserver bringt Urchin mit.

Die mit den aktuellen Linux-Systemen ausgelieferten MySQL-Datenbanken sollten von der Version passen. Bei PostgreSQL ist hier noch die Version 8.1.6 üblich, daher sollte dann lieber die mit Urchin gelieferte Version verwendet werden. Urchin empfiehlt grundsätzlich die Verwendung von MySQL, liefert aber aus lizenzrechtlichen Gründen PostgreSQL im Installationspaket mit aus. Für welche Datenbank Sie sich entscheiden, ist letztendlich egal – Urchin funktioniert mit beiden.

Weiterhin sollten Sie darauf achten, dass die Firewall SSH, HTTP, HTTPS und ggf. noch FTP und Samba erlaubt.
Unter FreeBSD sollten Sie vor der Installation von Urchin sicherstellen, dass in der Datei “/boot/loader.conf” die folgenden Zeilen stehen:

# Increase max process data segment size to 1GB
kern.maxdsiz="1073741824"
# Wait for full HTTP request accept filter
accf_http_load="YES"

Sollten Sie sich für die MySQL-Datenbank entschlossen haben, müssen Sie noch mit den folgenden Befehlen eine leere Datenbank für Urchin anlegen:

[root@yourserver ~]# mysql -u root -p

mysql> create database urchin character set utf8;

mysql> GRANT ALL ON urchin.* TO 'urchin'@'localhost' IDENTIFIED BY 'urchinpassword';

Selbstverständlich dürfen Sie statt urchinpassword ein eigenes Passwort verwenden. Sollten Sie eine vorhandene PostgreSQL verwenden wollen, finden Sie die entsprechenden Befehle in der im gezippten Installationspaket enthaltenen Anleitung. Um die mit Urchin mitgelieferte PostgreSQL zu nutzen, sind diese Schritte nicht nötig.

Bevor Sie aber mit der Installation von Urchin beginnen, müssen Sie sich zunächst die aktuelle Urchin-Version 7.0.00 herunterladen. Sie finden den Download für alle unterstützten Betriebssysteme hier auf unserer Website. Es empfiehlt sich die Datei auf die eigene Workstation herunterzuladen und dort zu entpacken, da in der .ZIP-Datei einige .PDF-Dokumente und der für die Installation benötigte Tarball (.tar.gz) enthalten sind. Diesen Tarball kopieren Sie dann z.B. mit WinSCP auf das System, auf dem Sie Urchin installieren wollen. Das dafür benötigte temporäre Verzeichnis erstellen Sie entweder in WinSCP oder mit den folgenden Befehlen in einem Terminalfenster oder auf der Konsole:

mkdir /var/tmp/urchintemp
cd /var/tmp/urchintemp

Sollten Sie ausversehen das .ZIP-File hierher kopiert haben, können Sie es in einem Terminalfenster oder auf der Konsole so entpacken:

unzip urchin7000_linux2.6_kernel_x32.zip

oder

unzip urchin7000_linux2.6_kernel_x64.zip

Installation – jetzt geht’s los!

Die Installation nehmen wir am besten als Benutzer mit Root-Rechten auf einer Konsole oder in einem Terminal-Fenster vor. Unter CentOS wäre das „root“ und unter Ubuntu der bei der Installation angelegte Benutzer. Als erstes entpacken wir den Tarball in dem temporären Verzeichnis:

tar xzvf urchin7000_linux26_x32_kernel.tar.gz

oder

tar xzvf urchin7000_linux26_x64_kernel.tar.gz

Und starten danach das Installationsskript. Der Befehl lautet unter CentOS „./install.sh“ und unter Ubuntu „sudo ./install.sh“.
Die meisten Fragen brauchen Sie lediglich mit der Enter-Taste bestätigen, da die Vorschläge für eine Testinstallation optimal sind. Bitte führen Sie die Installation in englischer Sprache durch, da sonst sämtliche nicht ASCII-Zeichen, wie z. B. Umlaute wahrscheinlich falsch dargestellt werden, Nachstehend sehen Sie den Ablauf des Installationsskripts bis zur Frage nach der Datenbank:

[root@yourserver urchintemp]# ./install.sh
Choose Language: [Default: 1]
1. English
2. Chinese (Simplified) / 中æï¼ç®ä½ï¼
3. Chinese (Traditional) / 中æ (ç¹é«)
4. Dutch / Nederlands
5. French / Français
6. German / Deutsch
7. Italian / Italiano
8. Japanese / æ¥æ¬èª
9. Korean / íêµ­ì´
10. Portuguese (Brazil) / Português (Brasil)
11. Spanish / Español
-> <ENTER>

------------------------------------------------------------------------
-- Welcome to the Urchin Installation and Upgrade Utility
-- Version 7.0.00
------------------------------------------------------------------------

Please read the install.txt file before continuing. Urchin installs and
uses a lightweight Apache webserver for web-based administration and
report delivery. The installer may ask for the following information
during installation:
1. A port number for the Urchin webserver. Port numbers below 1024
require superuser privileges.
2. A valid user and group for ownership and operation.
3. SQL information: SQL server type, server hostname and port/socket,
database name for Urchin, and SQL username/password used to access
the database.

SECURITY NOTE: The web-based Urchin administration and reporting
interfaces use unencrypted HTTP by default. Use of HTTPS requires
installation of your site-specific SSL certificate and key files into
the Urchin distribution and configuring Urchin to enable SSL when the
web service starts. Please see the online product documentation for
specific details.

Please select the installation type [Default: 1]
1. New
2. Upgrade
-> <ENTER>

Specify the installation directory  [Default: /usr/local/urchin]:
-> <ENTER>

The specified directory does not exist: /usr/local/urchin

Do you want the script to create it? [Default: 1]
1. Yes
2. No
-> <ENTER>

Choose a port number for the webserver [Default: 9999]
-> <ENTER>

Choose a user for the webserver and file ownership [Default: nobody]
-> <ENTER>

Choose a group for the webserver and file ownership [Default: nobody]
-> <ENTER>

SQL Server Type [Default: 1]
1. Use existing MySQL db
2. Use existing PostgreSQL db
3. Install & Use PostgreSQL db (requires root privileges)
->

Nun kommt ein Block, der sich abhängig von Ihrer Datenbankauswahl etwas unterschiedlich verhält. Wir zeigen hier alle drei Varianten, bzw. den entsprechenden Installationsablauf für eine Datenbank, die auf demselben Rechner wie die Urchin-Installation liegt (was aus Performancegründen auch anzuraten ist).

MySQL

Standardmäßig schlägt die Urchin-Installationsroutine als SQL-Servertyp die Option 1, also ein bereits installiertes MySQL vor. Sie müssen bei den Fragen nach dem SQL-Socketpfad, nach dem SQL-User und dem SQL-Passwort eine Antwort eingeben. Der Socketpfad steht für MySQL bei den meisten Distributionen in der Datei /etc/my.cnf und lautet in der Regel: /var/lib/mysql/mysql.sock. Der Pfad und der Dateiname der Konfigurationsdatei können von Distribution zu Distribution und von Paketquelle zu Paketquelle variieren. Unter Ubuntu steht die Information in /etc/mysql/my.cnf und lautet in der Regel /var/run/mysqld/mysqld.sock. Wurde die Datenbank mit den von Urchin empfohlenen Befehlen (siehe weiter oben) angelegt, so ist der Standardvorschlag bei der Frage nach dem SQL-User falsch und muss mit „urchin“ beantwortet werden. Im Anschluss geben Sie das Passwort für den Zugriff auf die Urchin-Datenbank ein. Das Passwort wird dabei nicht angezeigt, auch keine Ersatzzeichen.

-> <ENTER>

SQL Server [Default: localhost]
-> <ENTER>

SQL Socket path
-> /var/lib/mysql/mysql.sock

SQL Database [Default: urchin]
-> <ENTER>

SQL User [Default: nobody]
-> urchin <ENTER>

SQL Password
-> urchinpassword <ENTER>

PostgreSQL

Die zweite Option steht für eine bereits installierte PostgreSQL-Datenbank. Sie müssen bei den Fragen nach dem SQL-Socketpfad, nach dem SQL-User und dem SQL-Passwort eine Antwort eingeben. Der Socketpfad steht bei der Verwendung von PostgreSQL – sofern diese vorhanden ist – in der Datei data/postgresql.conf hinter unix_socket_directory und ist standardmäßig nicht gesetzt. Daher ist die Frage danach mit „null“ zu beantworten. Wurde die Datenbank mit den von Urchin empfohlenen Befehlen angelegt, so ist der Standardvorschlag bei der Frage nach dem SQL-User falsch und muss mit „urchin“ beantwortet werden. Im Anschluss geben Sie das Passwort für den Zugriff auf die Urchin-Datenbank ein. Das Passwort wird dabei nicht angezeigt, auch keine Ersatzzeichen.

-> 2<ENTER>

SQL Server [Default: localhost]
-> <ENTER>

SQL Socket path
-> null <ENTER>

SQL Port [Default: 5432]
-> <ENTER>

SQL Database [Default: urchin]
-> <ENTER>

SQL User [Default: nobody]
-> urchin <ENTER>

SQL Password
-> urchinpassword <ENTER>

Mitgeliefertes PostgreSQL installieren

Bei der dritten Option ist der Installationsteil kürzer; hier müssen Sie lediglich den Port bestätigen und das SQL-Passwort eingeben. Das Passwort wird dabei nicht angezeigt, auch keine Ersatzzeichen. Danach startet die PostgreSQL-Installation. Der Vorgang kann mehrere Minuten dauern. In einer X11-Session (GUI) informiert ein PopUp-Fenster über die gerade kopierten Dateien. In einer Konsolensitzung erhalten Sie keinerlei Informationen über den Installationsfortschritt, bis die nächste Frage auftaucht.

-> 3<ENTER>

SQL Port [Default: 5432]
-> <ENTER>

SQL Password

-> urchinpassword <ENTER>

Installing PostgreSQL server

Die Installation abschließen

Ab hier ist der Ablauf wieder für alle Installationsvarianten gleich. Für den Download der Geodatenbank von den Google-Servern müssen Sie mit einem Volumen von ca. 200 MB (möglicherweise auch mehr) rechnen. In dem nachstehenden Abschnitt zeigen wir diesmal den Mitschnitt für den Fall einer Neuinstallation unter Verwendung einer MySQL-Datenbank.

Would you like to initialize the configuration database during
install? [Default: 2]
   1. Yes
   2. No
-> 1<ENTER>

Would you like to enable automatic monthly updates of the geodata used
by Urchin? [Default: 1]
   1. Yes
   2. No
-> <ENTER>

Would you like the installer to start the Urchin webserver and scheduler
at the end of the installation? [Default: 1]
   1. Yes
   2. No
-> <ENTER>

------------------------------------------------------------------------
-- Summary Information
-- Installing Urchin 7.000
------------------------------------------------------------------------

Installation Directory: /usr/local/urchin
Webserver Port: 9999
Webserver User: nobody
Webserver Group: nobody
SQL Server Type: mysql
SQL Server: localhost
SQL Socket path: /var/lib/mysql/mysql.sock
SQL Database: urchin
SQL User: urchin
SQL Password: (set but not displayed)
Initialize configuration database during install: Yes
Automatic monthly geodata updates: Yes
Start Webserver and Scheduler: Yes

Please select continue or exit [Default: 1]
1. Continue
2. Exit
-> <ENTER>

Installing Urchin

Configuring Urchin to use existing SQL server
-- Initializing SQL database for Urchin
-- Configuring SQL parameters in urchin.conf

Creating webserver configuration

Setting file ownership and permission

Starting the Urchin webserver and scheduler daemon
Urchin webserver started on port 9999
Urchin SLAVE scheduler started
Urchin MASTER scheduler started
Urchin CPC scheduler started

------------------------------------------------------------------------
-- Installation Complete
------------------------------------------------------------------------

The Urchin administrative interface should be ready to use at

http://yourserver:9999/

To start or stop the Urchin webserver or scheduler, run 'urchinctl start'
or 'urchinctl stop' from the installation bin directory.

The administrative interface default username is admin and the password
is urchin. A wizard will direct you through the process of licensing
the product and changing the default password. We strongly recommend
that you change the default value to something more secure.

[root@yourserver urchintemp]#

Urchin aktivieren

Die erfolgreiche Installation verifizieren Sie durch die Eingabe von „http://yourserver:9999/“ (wobei „yourserver“ für die IP-Adresse oder den Namen Ihres Servers steht) in Ihrem Webbrowser. Sie sollten dann folgendes Bild sehen:

Anmelde-Seite der Urchin-Version 7.000Melden Sie sich mit Username „admin“ und Password „urchin“ an und klicken auf der folgenden Seite auf den Link „Obtain Demo License“.
Schritt 1 der Lizensierung von Urchin 7.000
Lesen Sie sich die Lizenzbedingungen durch und klicken Sie dann unten auf den Button „Accept and Install“.
Schritt 2 der Lizensierung von Urchin 7.000
Und schon haben Sie eine Demo-Lizenz, die Sie unten über den Link „Install licence“ aktivieren.
Schritt 3 der Lizensierung von Urchin 7.000
Nun wird ein Setup-Wizard gestartet, der Sie durch die Basis-Konfiguration führt. Dabei handelt sich um insgesamt 4 Screens, mit denen in zwei Schritten einige Grundkonfigurationen vorgenommen werden. Die Angaben im ersten Schritt sollten Sie genau so stehen lassen, während Sie im zweiten Schritt durchaus ein neues Passwort für den User „admin“ vergeben sollten, insbesondere, wenn Sie anderen Leuten Zugriff auf das System gewähren wollen. Nach Abschluss dieser Basis-Konfiguration erscheint dann das normale Bild, welches nach dem Anmelden für den Superuser „admin“ angezeigt wird.

Viel Erfolg bei der Installation!
Ihr webalytics-Technikteam

Lernvideo: Urchin Software Version 6 – Teil 1

Installation und Konfiguration von MySQL Server unter Windows XP

Dieses Video zeigt Ihnen, wie Sie einen MySQL Server auf einem Microsoft Windows Betriebssystem installieren, anschließend konfigurieren und wie Sie dann eine Datenbank für die Verwendung mit Urchin Software Version 6 erstellen.

Einspielen und Aktivieren einer Lizenz in Urchin Software

Verschiedene Lizenzierungsszenarien sind bei der Installation von Urchin Software in der Version 6 und 7 denkbar. Dabei spielt es zunächst einmal keine Rolle, ob Sie eine Demo-Lizenz aktivieren, eine erworbene Lizenz einspielen oder eine bestehende Lizenz reaktivieren wollen. Betrachten wir uns einmal gemeinsam die Situationen, die beim Betrieb von Urchin vorkommen können. So könnte sich der Verlauf wie folgt darstellen:

  • Sie laden sich die Urchin Software von unserer Website herunter und installieren eine Demo-Lizenz.
  • Nach 30 Tagen ist die Demo-Lizenz abgelaufen und Sie erwerben die Voll-Lizenz und müssen diese über die vorhandene Demo-Lizenz einspielen.
  • Weitere 60 Tage später stellen Sie fest, dass die Urchin-Installation samt Datenbestand auf einen anderen Server migriert und die bestehende Lizenz reaktiviert werden muss.

In den nachfolgenden Abschnitten widme ich mich den beschriebenen Situationen und stelle Ihnen die entsprechende Lösung vor. Sie können die Vorgehensweisen somit Schritt für Schritt nachvollziehen.

Installieren der Demo-Lizenz

Im ersten Abschnitt zeige ich Ihnen, wie Sie für Ihre frisch installierte Urchin Software eine Demo-Lizenz einspielen. Melden Sie sich zunächst an Ihrer Urchin-Installation an. Sie werden danach gleich aufgefordert, Urchin zu lizenzieren. Wählen Sie hier den Link “Obtain a Demo License” aus.

Demo-Lizenz für Urchin auswählen

Klicken Sie im zweiten Fenster auf die Schaltfläche “Accept and Install”, um die Demo-Lizenz einzuspielen.

Urchin Demo-Lizenz einspielen

Um die Lizenz nun final zu aktivieren, klicken Sie im letzten Fenster auf die Schaltfläche “Install license”. Beachten Sie auch die Limitierungen der Demo-Lizenz. Eine vollständige Aufstellung der Features finden Sie auf unserer Webseite Urchin Features“.

Urchin Demo-Lizenz installieren

Nachdem die Lizenz eingespielt ist, können Sie Ihre Urchin-Installation nach Ihren Vorstellungen/Anforderungen konfigurieren.

Installieren der Voll-Lizenz (Regular License)

Früher oder später stellt sich Ihnen die Aufgabe, in Ihre Urchin-Installation mit einer Voll-Lizenz (auch Regular License genannt) auszustatten. Das kann entweder direkt nach der Installation oder aber auch nach Ablauf des Testzeitraums von 30 Tagen geschehen. In diesem Abschnitt schildere ich Ihnen, wie Sie in Urchin Software eine Voll-Lizenz einspielen. Melden Sie sich zunächst an Ihrer Urchin-Installation an.

Sie werden gleich danach aufgefordert, Urchin zu lizenzieren; entweder, weil Sie Urchin gerade eben installiert haben, oder der Testzeitraum abgelaufen ist. Ebenfalls denkbar wäre die Aktualisierung einer Demo-Lizenz auf die Vollversion während des Testzeitraums (zu erreichen über Konfiguration –> Einstellungen –> Lizenz). Wählen Sie in jedem Fall den Link “Activate License”.

Voll-Lizenz für Urchin auswählen

Geben Sie im zweiten Fenster Ihren bei uns erworbenen Serial Code (Lizenzcode für Urchin) in das entsprechende Feld ein und klicken Sie auf die Schaltfläche “Accept and Install”, um die Voll-Lizenz einzuspielen.

Urchin Voll-Lizenz einspielen

Achten Sie bitte darauf, dass der Lizenzumfang der nachfolgenden Abbildung entspricht.  Um die Lizenz nun final zu aktivieren, klicken Sie im letzten Fenster auf die Schaltfläche “Install license”. Achtung: Dieser Schritt kann nicht mehr rückgängig gemacht werden! Ist Die Lizenz dem System einmal zugewiesen bedarf es einer Reaktivierung des Serial Code, um Urchin beispielsweise auf ein anderes System “umzuziehen”.

Urchin Voll-Lizenz installieren

Nachdem die Lizenz eingespielt ist, können Sie entweder Ihre Urchin-Installation nach Ihren Vorstellungen/Anforderungen konfigurieren oder aber mit der zeitlich unlimitierten Nutzung in vollem Umfang fortfahren.

Reaktivieren einer bestehenden Lizenz

Oftmals liegt bei diesem Szenario die Tatsache zugrunde, dass Sie vorhandene Hardware austauschen oder von einem Betriebssystem auf ein anderes wechseln wollen, bzw. müssen. Da sich der Lizenzschlüssel (License Key, nicht zu verwechseln mit dem Serial Code!) von Urchin anhand verschiedener Faktoren zur Laufzeit errechnet, führt das Austauschen von Hardware bzw. das Kopieren von Dateien auf ein anderes System zur Deaktivierung von Urchin. Daraus folgt, dass Ihre Lizenz im Anschluss erneut aktiviert werden muss. In diesem Fall gehen Sie wie folgt vor:

  1. Besuchen Sie auf unserer Website den Bereich zur Reaktivierung der Urchin Lizenz.
  2. Wählen Sie eine passende Priorisierung aus (Hinweis: es können Kosten entstehen!)
  3. Durchlaufen Sie die Schritte in unserem Shop-System zum Absenden Ihrer Anfrage
  4. Nachdem Sie von unserem Support-Team die Meldung über die Reaktivierung Ihres Serial Codes erhalten haben, verfahren Sie zum Einspielen der Lizenz wie oben beschrieben.

Danach ist Ihre Urchin-Installation wieder in vollem Umfang nutzbar.


Quickstart Guide für Google Analytics, 2. Auflage veröffentlicht

2. Auflage - Quickstat Guide für Google Analytics v4

Seit Google die Version 4 von Google Analytics veröffentlicht hat,  sind nun fast zwei Monate vergangen. Wir haben diese Zeit genutzt, um unseren Google Analyitcs Quickstart Guide komplett zu überarbeiten und and die neuen Features anzupassen.

Für wen wurde der Quickstart Guide für Google Analytics erstellt?

Unser kostenfreies 44-seitiges Booklet richtet sich an den ambitionierten Webanalyse-Neuling genauso wie an den fortgeschrittenen Webadmin, der einen logisch aufgebauten Leitfaden bzw. eine Art Schritt-für-Schritt-Anleitung für die Implementierung von Google Analytics sucht.

Welche Inhalte bietet der Quickstart Guide für Google Analytics?

In dem Booklet finden Sie eine logisch aufgebaute Reihenfolge der durchzuführenden Aufgaben, wenn Sie Ihre Website mit Google Analytics auswerten wollen. Dabei fangen wir mit der Einrichtung des Analytics Kontos an und beschreiben die Erstellung von Profilen, Filtern und Zielen bis hin zur Auswertung von Kampagnen und E-Commerce. Abschließend geben wir noch Tipps zur Verwendung von Google Analytics und weisen auf Features und Hilfsmittel hin. Nachfolgend finden Sie einen Auszug aus dem Inhaltsverzeichnis des Quickstart Guide:

  1. Einleitung
  2. Erstellen Sie Ihr Google Analytics Konto
  3. Prüfen Sie den Aufbau Ihrer Website
  4. Erstellen Sie ein Profil
    • Was ist ein Profil?
    • Wie erstelle ich ein Profil?
    • Erstellen Sie Filter
    • Wie werden Filter eingesetzt?
    • Definieren Sie Ziele und Trichter
  5. Fügen Sie den Tracking Code in Ihre Website ein
  6. Verlinken Sie Google Analytics mit Google AdWords (optional)
  7. Konfigurieren Sie das E-Commerce Tracking (optional)
  8. Kennzeichnen Sie Ihre Kampagnen (optional)
    • Wie funktioniert die Kennzeichnung in Google Analytics?
    • Die fünf Dimensionen des Kampagnen-Tracking
    • Tool zur URL-Erstellung
    • Kampagnentracking in den Berichten
  9. Weitere interessante Features in Google Analytics
  10. Greifen Sie auf bewährte Methoden zurück
  11. Weitere Hilfsmittel
  12. Erweitern Sie Ihr Wissen – buchen Sie unser Training
  13. Impressum

Wo ist der Quickstart Guide für Google Analytics erhältlich?

Sie können sich das Booklet kostenfrei auf unserer Website als PDF-Datei herunterladen. Klicken Sie dazu einfach auf die nachfolgende Schaltfläche.

Klicken Sie hier, um den kostenlosen Google Analytics Quickstart Guide herunterzuladen

Urchin 6.6.02 installieren

Wenn Sie die aktuelle Urchin-Version testen wollen, stellt sich sicherlich die Frage, auf welcher Plattform und unter welchem Betriebssystem das passieren soll. Als Plattform eignen sich ausrangierte Server, virtuelle Maschinen, oder zur Not sogar Ihre Workstation. Letzteres kann sinnvoll sein, wenn Sie lediglich das Look & Feel ausprobieren möchten. Meistens will man aber mehr ausprobieren und sollte dann von vornherein eine der anderen Möglichkeiten einsetzen.

Wer eine geeignete Windows-Lizenz übrig hat, darf sie gerne ver(sch)wenden. Wir empfehlen für Testinstal-lationen von Urchin, sich eine aktuelle kostenfreie Linux-Server-Distribution herunterzuladen, z.B. Ubuntu oder CentOS (zu RedHat binärkompatibel) und zu installieren.

CentOS bietet zwar keine Serverversion zum Download an, aber während der Installation kann diese auf Server und/oder Server-GUI reduziert werden. Ubuntu-Server bringt dagegen keine GUI mit. Wer auf (Linux-) Kommando-zeilenebene nicht so fit ist, sollte sich eine GUI (Gnome oder KDE) installieren.

Systemvoraussetzungen für eine Installation

Geeignete Windows-Systeme sind Windows 2003 Server, Windows XP, Windows 2000, Windows Vista, Windows 2008 Server. Von den Unix-basierten-Systemen werden die Linux-Kernel 2.4 und 2.6, sowie FreeBSD 6.2+ unterstützt. Für Urchin geeignete Datenbanken sind MySQL 5.03+ oder PostgreSQL 8.2.5+. Um die im Installationspaket von Urchin 6.6.02 mitgelieferte PostgreSQL 8.4.01 unter Linux(Kernel 2.4 oder 2.6) zu installieren, wird die glibc 2.3.3+ benötigt.

Für die Analyse einzelner kleiner bis mittelgroßer Websites sollte das System wie folgt ausgestattet sein:

  • 2‑GHz-Prozessor oder schneller
  • 2 GB RAM
  • 250 GB Festplattenlaufwerk (IDE oder SATA)
  • 100 MBit/s-Ethernet-Schnittstelle

Bei Installationen für Provider oder größerer Unternehmen sollte das System folgendermaßen ausgestattet sein:

  • 2,5-GHz Pentium Dual-Core / 2-GHz UltraSPARC / PPC, MIPS oder anderem mit ähnlichem CPU‑Geschwindigkeitsbereich
  • 3 GB RAM
  • Ultra2/Wide SCSI-Festplattenlaufwerk (z. B. Seagate Cheetah), Kapazität nach Protokollaufkommen
  • 100 MBit/s-Ethernet-Schnittstelle
  • Backupsystem.

Als Plattenplatzbedarf muss mit ca. 10% der der Originalprotokollgröße gerechnet werden. Für die Anzeige der Urchin-Benutzeroberfläche sind die  Browser Internet Explorer 6.x+, Firefox 2.x+ oder Chrome 1.x+ geeignet. Weitere Informationen finden Sie im Urchin-Helpcenter.

Warum beschreiben wir hier eine Installation unter Linux mit Kernel 2.6?

Die Installation von Urchin unter Windows gestaltet sich eher trivial. Die benötigten Informationen sind sowohl für Windows, als auch für Linux identisch. Da unter beiden Systemen die gleichen Fragen gestellt werden, es unter Linux – je nach System – aber die eine oder andere kleine Hürde zu nehmen gilt, beschreiben wir hier die Installation unter Linux. Dadurch wird die Installation unter Linux hoffenlicht so einfach, wie die unter Windows. Für den Kernel 2.6 haben wir uns entschieden, da dieser Kernel der aktuellste und wohl der verbreitetste ist.

Vorbereitungen

Sollten Sie die Installation in einer virtuellen Maschine auf Ihrer Workstation vornehmen wollen, so achten Sie bitte darauf, dass Sie die Netzwerkschnittstelle im Bridging-Modus betreiben. Erst dann ist gewährleistet, dass Sie selbst und andere darauf zugreifen können.

In dem Fall, dass Sie eine Neuinstallation des Betriebssystems vornehmen, sollten Sie alle nicht benötigten Server und Dienste abwählen. Sie brauchen in der Regel lediglich den OpenSSH-Server und evtl. eine Datenbank, sowie Samba. Einen Webserver bringt Urchin mit.

Die mit den aktuellen Linux-Systemen ausgelieferten MySQL-Datenbanken sollten von der Version passen. Bei PostgreSQL ist hier noch die Version 8.1.6 üblich, daher sollte dann lieber die mit Urchin gelieferte Version verwendet werden. Urchin empfiehlt grundsätzlich die Verwendung von MySQL, liefert aber aus lizenzrechtlichen Gründen PostgreSQL im Installationspaket mit aus. Für welche Datenbank Sie sich entscheiden, ist letztendlich egal – Urchin funktioniert mit beiden.

Weiterhin sollten Sie darauf achten, dass die Firewall SSH, HTTP, HTTPS und ggf. noch FTP und Samba erlaubt.

Unter FreeBSD sollten Sie vor der Installation von Urchin sicherstellen, dass in der Datei “/boot/loader.conf” die folgenden Zeilen stehen:

# Increase max process data segment size to 1GB
kern.maxdsiz="1073741824"
# Wait for full HTTP request accept filter
accf_http_load="YES"

Sollten Sie sich für die MySQL-Datenbank entschlossen haben, müssen Sie noch mit den folgenden Befehlen eine leere Datenbank für Urchin anlegen:

root@yourserver# mysql -u root -p 

mysql> create database urchin character set utf8; 

mysql> GRANT ALL ON urchin.* to 'urchin'@'localhost' IDENTIFIED BY 'urchinpassword'; 

Selbstverständlich dürfen Sie statt urchinpassword ein eigenes Passwort verwenden. Sollten Sie eine vorhandene PostgreSQL verwenden wollen, finden Sie die entsprechenden Befehle in der im gezippten Installationspaket enthaltenen Anleitung. Um die mit Urchin mitgelieferte PostgreSQL zu nutzen, sinde diese Schritte nicht nötig.

Bevor Sie aber mit der Installation von Urchin beginnen, müssen Sie sich zunächst die aktuelle Urchin-Version 6.6.02 herunterladen. Sie finden den Download für alle unterstützten Betriebssysteme hier auf unserer Website. Es empfiehlt sich die Datei auf die eigene Workstation herunterzuladen und dort zu entpacken, da in der .ZIP-Datei einige .PDF-Dokumente und der für die Installation benötigte Tarball (.tar.gz) enthalten sind. Diesen Tarball kopieren Sie dann z.B. mit WinSCP auf das System, auf dem Sie Urchin installieren wollen. Das dafür benötigte temporäre Verzeichnis erstellen Sie entweder in WinSCP oder mit den folgenden Befehlen in einem Terminalfenster oder auf der Konsole:

mkdir /var/tmp/urchintemp
cd /var/tmp/urchintemp

Sollten Sie ausversehen das .ZIP-File hierher kopiert haben, können Sie es in einem Terminalfenster oder auf der Konsole so entpacken:

unzip urchin6602_linux2.6_kernel.zip

Installation – jetzt geht’s los!

Die Installation nehmen wir am besten als Benutzer mit Root-Rechten auf einer Konsole oder in einem Terminal-Fenster vor. Unter CentOS wäre das „root“ und unter Ubuntu der bei der Installation angelegte Benutzer. Als erstes entpacken wir den Tarball in dem temporären Verzeichnis:

tar xzvf urchin6602_linux2.6_kernel.tar.gz

Und starten danach das Installationsskript. Der Befehl lautet unter CentOS „./install.sh“ und unter Ubuntu „sudo ./install.sh“.

Die meisten Fragen brauchen Sie lediglich mit der Enter-Taste bestätigen, da die Vorschläge für eine Testinstallation optimal sind. Nachstehend sehen Sie den Ablauf des Installationsskripts bis zur Frage nach der Datenbank:

root@yourserver:/var/tmp/urchintemp # ./install.sh
Choose Language: [Default: 1]
1. English
2. Japanese / 日本語
3. Spanish / Español
-> <ENTER>

------------------------------------------------------------------------
-- Welcome to the Urchin Installation and Upgrade Utility
-- Version 6.602
------------------------------------------------------------------------

Please read the install.txt file before continuing. Urchin installs and
uses a lightweight Apache webserver for web-based administration and
report delivery. The installer may ask for the following information
during installation:
1. A port number for the Urchin webserver. Port numbers below 1024
require superuser privileges.
2. A valid user and group for ownership and operation.
3. SQL information: SQL server type, server hostname and port/socket,
database name for Urchin, and SQL username/password used to access
the database.

SECURITY NOTE: The web-based Urchin administration and reporting
interfaces use unencrypted HTTP by default. Use of HTTPS requires
installation of your site-specific SSL certificate and key files into
the Urchin distribution and configuring Urchin to enable SSL when the
web service starts. Please see the online product documentation for
specific details.

Please select the installation type [Default: 1]
   1. New
   2. Upgrade
-> <ENTER>

Specify the installation directory  [Default: /usr/local/urchin]:
-> <ENTER>

The specified directory does not exist: /usr/local/urchin

Do you want the script to create it? [Default: 1]
   1. Yes
   2. No
-> <ENTER>

Choose a port number for the webserver [Default: 9999]
-> <ENTER>

Choose a user for the webserver and file ownership [Default: nobody]
-> <ENTER>

Choose a group for the webserver and file ownership [Default: nobody]
-> <ENTER>

SQL Server Type [Default: 1]
   1. mysql
   2. postgresql
   3. install postgresql
->

Nun kommt ein Block, der sich abhängig von Ihrer Datenbankauswahl etwas unterschiedlich verhält. Wir zeigen hier alle drei Varianten, bzw. den entsprechenden Installationsablauf für eine Datenbank, die auf demselben Rechner wie die Urchin-Installation liegt (was aus Performancegründen auch anzuraten ist).

MySQL

Standardmäßig schlägt die Urchin-Installationsroutine als SQL-Servertyp die Option 1, also ein bereits installiertes MySQL vor. Sie müssen bei den Fragen nach dem SQL-Socketpfad, nach dem SQL-User und dem SQL-Passwort eine Antwort eingeben. Der Socketpfad steht für MySQL bei den meisten Distributionen in der Datei /etc/my.cnf und lautet in der Regel: /var/lib/mysql/mysql.sock. Der Pfad und der Dateiname der Konfigurationsdatei können von Distribution zu Distribution und von Paketquelle zu Paketquelle variieren. Unter Ubuntu steht die Information in /etc/mysql/my.cnf und lautet in der Regel /var/run/mysqld/mysqld.sock. Wurde die Datenbank mit den von Urchin empfohlenen Befehlen (siehe weiter oben) angelegt, so ist der Standardvorschlag bei der Frage nach dem SQL-User falsch und muss mit „urchin“ beantwortet werden. Im Anschluss geben Sie das Passwort für den Zugriff auf die Urchin-Datenbank ein. Das Passwort wird dabei nicht angezeigt, auch keine Ersatzzeichen.

-> <ENTER>

SQL Server [Default: localhost]
-> <ENTER>

SQL Socket path
-> /var/lib/mysql/mysql.sock

SQL Database [Default: urchin]
-> <ENTER>

SQL User [Default: nobody]
-> urchin <ENTER>
SQL Password
-> urchinpassword <ENTER>

PostgreSQL

Die zweite Option steht für eine bereits installierte PostgreSQL-Datenbank. Sie müssen bei den Fragen nach dem SQL-Socketpfad, nach dem SQL-User und dem SQL-Passwort eine Antwort eingeben. Der Socketpfad steht bei der Verwendung von PostgreSQL – sofern diese vorhanden ist – in der Datei data/postgresql.conf hinter unix_socket_directory und ist standardmäßig nicht gesetzt. Daher ist die Frage danach mit „null“ zu beantworten. Wurde die Datenbank mit den von Urchin empfohlenen Befehlen angelegt, so ist der Standardvorschlag bei der Frage nach dem SQL-User falsch und muss mit „urchin“ beantwortet werden. Im Anschluss geben Sie das Passwort für den Zugriff auf die Urchin-Datenbank ein. Das Passwort wird dabei nicht angezeigt, auch keine Ersatzzeichen.

-> 2<ENTER>

SQL Server [Default: localhost]
-> <ENTER>

SQL Socket path
-> null <ENTER>

SQL Port [Default: 5432]
-> <ENTER>

SQL Database [Default: urchin]
-> <ENTER>

SQL User [Default: nobody]
-> urchin <ENTER>

SQL Password
-> urchinpassword <ENTER>

Mitgeliefertes PostgreSQL installieren

Bei der dritten Option ist der Installationsteil kürzer; hier müssen Sie lediglich den Port bestätigen und das SQL-Passwort eingeben. Das Passwort wird dabei nicht angezeigt, auch keine Ersatzzeichen. Danach startet die PostgreSQL-Installation. Der Vorgang kann mehrere Minuten dauern. In einer X11-Session (GUI) informiert ein PopUp-Fenster über die gerade kopierten Dateien. In einer Konsolensitzung  erhalten Sie keinerlei Informationen über den Installationsfortschritt, bis die nächste Frage auftaucht.

-> 3<ENTER>

SQL Port [Default: 5432]
-> <ENTER>

SQL Password

-> urchinpassword <ENTER>

Installing PostgreSQL server

Die Installation abschließen

Ab hier ist der Ablauf wieder für alle Installationsvarianten gleich. Für den Download der Geodatenbank von den Google-Servern müssen Sie mit einem Volumen von ca. 200 MB (möglicherweise auch mehr) rechnen. In dem nachstehenden Abschnitt zeigen wir den Mitschnitt für den Fall einer Neuinstallation mit Installation der mitgelieferten PostgreSQL-Datenbank.

Would you like to initialize the configuration database during
install? [Default: 1]
   1. Yes
   2. No
-> <ENTER>

Would you like to enable automatic monthly updates of the geodata used
by Urchin? [Default: 1]
   1. Yes
   2. No
-> <ENTER>

Would you like the installer to start the Urchin webserver and scheduler
at the end of the installation? [Default: 1]
   1. Yes
   2. No
-> <ENTER>

------------------------------------------------------------------------
-- Summary Information

-- Installing Urchin 6.602

------------------------------------------------------------------------

Installation Directory: /usr/local/urchin
Webserver Port: 9999
Webserver User: nobody
Webserver Group: nobody
SQL Server Type: postgresql
SQL Server: localhost
SQL Socket path: null
SQL Database: postgres
SQL User: postgres
SQL Password: (set but not displayed)
Initialize configuration database during install: Yes
Automatic monthly geodata updates: Yes
Start Webserver and Scheduler: Yes

Please select continue or exit [Default: 1]
   1. Continue
   2. Exit
-> <ENTER>

Installing Urchin

Configuring Urchin to use existing SQL server
-- Initializing SQL database for Urchin
-- Configuring SQL parameters in urchin.conf

Creating webserver configuration

Setting file ownership and permission

Starting the Urchin webserver and scheduler daemon
Urchin webserver started on port 9999
Urchin SLAVE scheduler started
Urchin MASTER scheduler started
Urchin CPC scheduler started

------------------------------------------------------------------------
-- Installation Complete
------------------------------------------------------------------------

The Urchin administrative interface should be ready to use at

   http://yourserver:9999/

To start or stop the Urchin webserver or scheduler, run 'urchinctl start'
or 'urchinctl stop' from the installation bin directory.

The administrative interface default username is admin and the password
is urchin. A wizard will direct you through the process of licensing
the product and changing the default password. We strongly recommend
that you change the default value to something more secure.

root@yourserver:/var/tmp/urchintemp #

Urchin aktivieren

Die erfolgreiche Installation verifizieren Sie durch die Eingabe von „http://yourserver:9999/“ (wobei „yourserver“ für die IP-Adresse oder den Namen Ihres Servers steht) in Ihrem Webbrowser. Sie sollten dann folgendes Bild sehen:

Anmeldemaske der Urchin-Version 6.602

Melden Sie sich mit Username „admin“ und Password „urchin“ an und klicken auf der folgenden Seite auf den Link „Obtain Demo License“.

Lesen Sie sich die Lizenzbedingungen durch und klicken Sie dann unten auf den Button „Accept and Install“.

Und schon haben Sie eine Demo-Lizenz, die Sie unten über den Link „Install licence“ aktivieren.

Nun wird ein Setup-Wizard gestartet, der Sie durch die Basis-Konfiguration führt. Dabei handelt sich um insgesamt 4 Screens, mit denen in zwei Schritten einige Grundkonfigurationen vorgenommen werden. Die Angaben im ersten Schritt sollten Sie genau so stehen lassen, während Sie im zweiten Schritt durchaus ein neues Passwort für den User „admin“ vergeben sollten, insbesondere, wenn Sie anderen Leuten Zugriff auf das System gewähren wollen. Nach Abschluss dieser Basis-Konfiguration erscheint dann das normale Bild, welches nach dem Anmelden für den Superuser „admin“ angezeigt wird.

Viel Erfolg bei der Installation!

Ihr Detlef

Technikteam

Follow us:
Abonnieren Sie unseren Blog!
Folgen Sie uns auf Twitter!
Folgen Sie uns auf Facebook!
Folgen Sie uns auf LinkedIn!
Feedburner-Abo
RSS Feed für Reader abonnieren

oder geben Sie Ihre E-Mail-Adresse an:

Kategorien
Archive