Knowledgebase:Manuelle Installation

Manuelle Installation

Falls die Webbasierte Installation nicht funktioniert, können Sie Contrexx auch manuell installieren. Entpacken Sie dazu die Dateien, wie um vorherigen Schritt Webbasierte Installation beschrieben, und folgen Sie den nachfolgenden Punkten um Contrexx manuell zu Installieren:

Konfigurationsdatei config/configuration.php anpassen

Als erstes muss die Konfigurationsdatei angepasst werden. Diese wird üblicherweise vom Installer selbständig erstellt. Da Sie allerdings eine manuelle Installation machen müssen Sie die Vorlage von installer/data/configuration.tpl nach config/configuration.php kopieren (Dateiendung beachten!) und die mit %-Zeichen markierten Platzhalter ersetzen. Innerhalb der Konfigurationsdatei finden Sie die nachfolgend genannten Abschnitte:

Sektion: Set installation status

Hier müssen Sie die Installationskonstante CONTREXX_INSTALLED auf true setzen, damit das System weiss, dass das System installiert wurde:

<HIGHLIGHTSYNTAX>define('CONTEXX_INSTALLED', true);</HIGHLIGHTSYNTAX>

Sektion: Database configuration section

In diesem Abschnitt werden jegliche Angaben zur Ihrer Datenbankverbindung festgelegt. Bei den meisten Serveranbieter können Sie selber Datenbanken und die zugehörigen Datenbankbenutzer festlegen. Falls Sie Ihre Zugangsdaten für die Datenbank nicht wissen konsultieren Sie bitte Ihren Hostinganbieter.

<HIGHLIGHTSYNTAX>$_DBCONFIG['host'] = "localhost"; // This is normally set to localhost $_DBCONFIG['database'] = "DATENBANK"; // Database name $_DBCONFIG['tablePrefix'] = "contrexx_"; // Database table prefix $_DBCONFIG['user'] = "BENUTZER"; // Database username $_DBCONFIG['password'] = "KENNWORT"; // Database password $_DBCONFIG['dbType'] = "mysql"; // Database type (e.g. mysql,postgres ..) $_DBCONFIG['charset'] = 'utf8'; // Charset (default, latin1, utf8, ..)</HIGHLIGHTSYNTAX>

Ersetzen Sie die Variablen DATENBANK, BENUTZER, KENNWORT mit Ihren entsprechenden Daten. Die anderen Konfigurationsvariablen können Sie im Normalfall mit den oben angegebenen Werten füllen.

Sektion: Site path specific configuration

In diesem Bereich legen Sie das Ablageverzeichnis Ihrer Contrexx-Dateien fest.

• ascms_root: Dies ist das Verzeichnis von dem Ihr Webserver die Dateien ausliefert, das sogenannte Document Root.
• ascms_root_offset: Dies ist der Pfad zum Verzeichnis, in welchem Sie das Contrexx CMS entpackt haben, relativ zum DocumentRoot.

<HIGHLIGHTSYNTAX>$_PATHCONFIG['ascms_root'] = "DOCUMENT_ROOT"; $_PATHCONFIG['ascms_root_offset'] = "OFFSET_PATH";</HIGHLIGHTSYNTAX>

Ersetzen Sie die Variablen DOCUMENT_ROOT und OFFSET_PATH mit den entsprechenden Pfadangaben Ihres Servers. Falls Sie diese nicht wissen, folgen Sie der Anleitung im nächsten Schritt, um diese automatisiert herausfinden.

ascms_root und ascms_root_offset automatisch ermitteln

Erstellen Sie eine neue PHP-Datei (z.B. pfad.php) mit dem folgenden Inhalt:

<highlightsyntax><?php $offsetPath = ; $documentRoot = ;

$arrDirectories = explode('/', $_SERVER['SCRIPT_NAME']); for ($i = 0;$i < count($arrDirectories)-2;$i++) { if (!empty($arrDirectories[$i])) { $offsetPath .= '/'.$arrDirectories[$i]; } }

$scriptPath = str_replace('\\', '/', __FILE__); if (preg_match("/(.*)(\/[\d\D]*){2}$/", $scriptPath, $arrMatches) == 1) { $scriptPath = $arrMatches[1]; }

if (preg_match("=(.*)".$offsetPath."=", $scriptPath, $arrMatches) == 1) { $documentRoot = $arrMatches[1]; }

print '$_PATHCONFIG[\'ascms_root\'] = \.$documentRoot.'\';
'; print '$_PATHCONFIG[\'ascms_root_offset\'] = \.$offsetPath.'\';'; ?> </highlightsyntax>

Platzieren Sie die Datei nun ins Verzeichnis /installer des Contrexx Verzeichnisbaums auf Ihrem Webserver und rufen Sie die Datei anschliessend über Ihren Webbrowser auf. Falls Sie unsere Vorgabe für den Dateinamen (pfad.php) befolgt haben, sieht die komplette URL wie folgt aus http://www.ihre-domain.ch/installer/pfad.php. Sie sollten nun die entsprechenden Pfadangaben in Ihrem Browser dargestellt bekommen und können diese direkt in Ihre Konfigurationsdatei kopieren.

Sektion: Ftp specific configuration

Je nach Systemkonfiguration Ihres Webservers können gewisse Dateioperationen nur per FTP durchgeführt werden. Dies ist meistens bei Unix (und Unix-änlichen) Systemen der Fall. Wenn Sie also FTP-Support benötigen dann setzen Sie die Konfigurationsvariable $_FTPCONFIG['is_activated'] auf true und ersetzen Sie die Variablen BENUTZER, KENNWORT und FTP_PFAD mit den Werten Ihres FTP-Benutzers. Um möglichst wenig Probleme mit Ihrer Installation zu haben empfehlen wir Ihnen die Verwendung der FTP-Unterstützung.

<HIGHLIGHTSYNTAX>$_FTPCONFIG['is_activated'] = true; // Ftp support true or false $_FTPCONFIG['use_passive'] = false; // Use passive ftp mode $_FTPCONFIG['host'] = 'localhost';// This is normally set to localhost $_FTPCONFIG['port'] = 21; // Ftp remote port $_FTPCONFIG['username'] = 'BENUTZER'; // Ftp login username $_FTPCONFIG['password'] = 'KENNWORT'; // Ftp login password $_FTPCONFIG['path'] = 'FTP_PFAD'; // Ftp path to cms</HIGHLIGHTSYNTAX>

Den FTP_PFAD finden Sie foldendermassen heraus: Verbinden Sie sich mit einem FTP-Client (Beispiel: FileZilla) auf Ihren Webserver. Der FTP_PFAD ist nun der Pfad, den Sie durchgehen müssen, bis Sie im Verzeichnis gelandet sind, aus welchem Ihr Webserver die Dateien ausliefert. In vielen Fällen entspricht dies dem Verzeichnis /httpdocs oder /www.

Sektion: Optional customizing exceptions

Die folgenden zwei Eigenschaften beziehen sich auf das Shop-Modul. Die erste Eigenschaft definiert, ob die Shop-Navigation auf jeder Seite angezeigt werden soll, die zweite Eigenschaft ob der JavaScript-Warenkorb verwendet werden soll. <HIGHLIGHTSYNTAX>$_CONFIGURATION['custom']['shopnavbar'] = false; // ture|false $_CONFIGURATION['custom']['shopJsCart'] = false; // true|false</HIGHLIGHTSYNTAX>

Sektion: Set character encoding

In diesem Abschnitt wird der zu verwendende Zeichensatz festgelegt. Da Contrexx ab Version 2.0 ohnehin nur noch UTF-8 unterstützt können Sie die beiden nachfolgenden Zeilen ohne Anpassungen übernehmen.

<HIGHLIGHTSYNTAX>$_CONFIG['coreCharacterEncoding'] = 'UTF-8'; // example 'UTF-8' @header('content-type: text/html; charset='.$_CONFIG['coreCharacterEncoding']);</HIGHLIGHTSYNTAX>

Versionsdatei anpassen

Damit das System weiss, um welche Version es sich handelt, existiert eine Versionsdatei. Diese wird üblicherweise vom Installer selbständig mit Inhalten gefüllt. Da Sie allerdings eine manuelle Installation machen müssen Sie die Vorlage von installer/data/version.tpl nach config/version.php kopieren (Dateiendung beachten!). Die Werte für die bestehenden Platzhalter können Sie der Datei installer/config/config.php entnehmen. In der Version 2.0 lauten diese:

<HIGHLIGHTSYNTAX>$_CONFIG['coreCmsName'] = 'Contrexx Web Content Management System'; $_CONFIG['coreCmsVersion'] = '2.0.0'; $_CONFIG['coreCmsStatus'] = 'Stable'; $_CONFIG['coreCmsEdition'] = 'OpenSource'; $_CONFIG['coreCmsCodeName'] = 'Calling Elvis'; $_CONFIG['coreCmsReleaseDate'] = '18.06.2008'; </HIGHLIGHTSYNTAX>

Systemeinstellungen anpassen

Neben der Konfigurationsdatei (config/config.php) und der Versionsdatei (config/version.php) existiert noch eine dritte Datei: config/settings.php. Diese wird üblicherweise vom Installer selbständig mit Inhalten gefüllt und enthält verschiedene Systemeinstellungen. Da diese Systemeinstellungen anschliessend auch direkt über den Adminbereich angepasst werden können reicht es die Datei mit folgenden Inhalten zu Erstellen (stand Version 2.0). Nach Abschluss der Installation können über die Grundeinstellungen des Adminbereichs sämtliche hier gelisteten Werte angepasst werden. Falls Sie zu den fortgeschrittenen Benutzern gehören, so können Sie diese Werte auch gleich jetzt anpassen.

<HIGHLIGHTSYNTAX><?php /**

• This file is generated by the "settings"-menu in your CMS.
• Do not try to edit it manually!
• /

/**

• -------------------------------------------------------------------------
• Core
• -------------------------------------------------------------------------
• /

$_CONFIG['cacheEnabled'] = "off"; $_CONFIG['cacheExpiration'] = 86400; $_CONFIG['contentHistoryStatus'] = "on"; $_CONFIG['coreAdminEmail'] = "Ihre.Email@ihre-domain.ch"; $_CONFIG['coreAdminName'] = "Ihr Name"; $_CONFIG['coreGlobalPageTitle'] = "Seitentitel"; $_CONFIG['coreIdsStatus'] = "on"; $_CONFIG['corePagingLimit'] = 30; $_CONFIG['coreSmtpServer'] = 0; $_CONFIG['dnsServer'] = "ns1.contrexxhosting.com"; $_CONFIG['domainUrl'] = "www.ihre-domain.ch"; $_CONFIG['frontendEditingStatus'] = "on"; $_CONFIG['googleMapsAPIKey'] = ""; $_CONFIG['googleSitemapStatus'] = "on"; $_CONFIG['languageDetection'] = "on"; $_CONFIG['lastAccessId'] = 8; $_CONFIG['searchVisibleContentOnly'] = "on"; $_CONFIG['sessionLifeTime'] = 3600; $_CONFIG['spamKeywords'] = "sex, viagra"; $_CONFIG['systemStatus'] = "on"; $_CONFIG['useVirtualLanguagePath'] = "off";

/**

• -------------------------------------------------------------------------
• Search
• -------------------------------------------------------------------------
• /

$_CONFIG['searchDescriptionLength'] = 150;

/**

• -------------------------------------------------------------------------
• Contact
• -------------------------------------------------------------------------
• /

$_CONFIG['contactFormEmail'] = "Ihre.Email@ihre-domain.ch";

/**

• -------------------------------------------------------------------------
• Block
• -------------------------------------------------------------------------
• /

$_CONFIG['blockRandom'] = 1; $_CONFIG['blockStatus'] = 1;

/**

• -------------------------------------------------------------------------
• News
• -------------------------------------------------------------------------
• /

$_CONFIG['newsTeasersStatus'] = 1;

/**

• -------------------------------------------------------------------------
• Directory
• -------------------------------------------------------------------------
• /

$_CONFIG['directoryHomeContent'] = 0;

/**

• -------------------------------------------------------------------------
• Forum
• -------------------------------------------------------------------------
• /

$_CONFIG['forumHomeContent'] = 1; $_CONFIG['forumTagContent'] = 0;

/**

• -------------------------------------------------------------------------
• Calendar
• -------------------------------------------------------------------------
• /

$_CONFIG['calendardefaultcount'] = 16; $_CONFIG['calendarheadlines'] = 1; $_CONFIG['calendarheadlinescat'] = 0; $_CONFIG['calendarheadlinescount'] = 5;

/**

• -------------------------------------------------------------------------
• Feed
• -------------------------------------------------------------------------
• /

$_CONFIG['feedNewsMLStatus'] = 0;

/**

• -------------------------------------------------------------------------
• -------------------------------------------------------------------------
• /

$_CONFIG['bannerStatus'] = 0;

/**

• -------------------------------------------------------------------------
• Podcast
• -------------------------------------------------------------------------
• /

$_CONFIG['podcastHomeContent'] = 1;

/**

• -------------------------------------------------------------------------
• Alias
• -------------------------------------------------------------------------
• /

$_CONFIG['aliasStatus'] = 1;

/**

• -------------------------------------------------------------------------
• Data
• -------------------------------------------------------------------------
• /

$_CONFIG['dataUseModule'] = 1;

?></HIGHLIGHTSYNTAX>

Schreibrechte setzen

Contrexx benötigt für den ordnungsgemässen Einsatz Schreibrechte auf verschiedene Verzeichnisse. Um welche Verzeichnisse es sich dabei handelt, können Sie der Datei installer/config/config.php entnehmen:

$arrFiles = array(
    '/cache' => array(),
    '/config' => array(),
    '/feed' => array(
        'sub_dirs'  => true,
    ),
    '/images' => array(
        'sub_dirs'  => true,
    ),
    '/media' => array(
        'sub_dirs'  => true,
    ),
    '/themes' => array(
        'sub_dirs'  => true,
    ),
    '/tmp' => array(
        'sub_dirs'  => true,
    ),
);

Im obigen Fall (entnommen aus der Version 3.0) benötigen also die folgenden Verzeichnisse Schreibrechte:

/cache/*
/config/*
/feed/*
/images/*
/media/*
/themes/*
/tmp/*

Steht bei einem Eintrag die Option sub_dirs auf dem Wert true, so müssen auch alle Unterverzeichnisse Schreibrechte erhalten.

Schreibrechte anpassen

Schreibrechte lassen sich z.B. mit dem Freeware FTP-Programm Filezilla wie folgt anpassen:

1. Verzeichnisname anwählen
2. Mittels rechter Maustaste Kontextmenu Dateiattribute anwählen
3. Die gewünschte Berechtigung anwählen oder als Wert eingeben

Bei Filezilla version 3.x muss darauf geachtet werden, das der Hacken "Unterverzeichnisse mit einbeziehen" angehackt und der Radiobutton auf alle Dateien und Verzeichnisse anwenden gesetzt ist.

Datenbank erstellen

Nun müssen Sie die Datenbanktabellen in der im Konfigurationsfile angegebenen Datenbank (Sektion: Database configuration section) erstellen. Dazu müssen Sie mit einem MySQL-Client, beispielsweise phpMyAdmin, folgende SQL-Dateien in der angegebenen Reihenfolge einspielen:

1. installer/data/contrexx_dump_structure.sql: Enthält die Grundstruktur der Datenbanktabellen
2. installer/data/contrexx_dump_data.sql: Enthält die Daten für die Tabellen.

Meist erhalten Sie direkt von Ihrem Hostinganbieter die Zugangsdaten für den Administrationsbereich von phpMyAdmin. Sind Sie sich nicht sicher, ob Sie Zugriff auf dieses Verwaltungsprogramm haben, so wenden Sie sich bitte an Ihren Hostinganbieter.

Im Adminbereich einloggen

Wenn Sie bis jetzt alles richtig gemacht haben, so sollten Sie beim Aufruf Ihrer Webseite (http://www.ihre-domain.ch) nun die Standardinhalte des Contrexx CMS sehen. Über die Adresse http://www.ihre-domain.ch/cadmin) können Sie nun mit folgenden Zugansdaten in die Administrationskonsole:

• Benutzername: system
• Passwort: 123456

Diese Zugangsdaten können Sie innerhalb des Adminbereichs selbstverständlich problemlos anpassen.