Knowledgebase:Contrexx Manual:Contrexx Installation Guide

From Cloudrexx Development Wiki
Jump to: navigation, search

Web Based Installation

Upload the files in the folder CMS_DATEIEN of the "contrexx_xx.zip" software package to your "DocumentRoot" list (or other subdirectory) of your web server. Using a web browser type the file http://www.yoursite/index.php and follow the instructions.


As is usuall with this type of program you will be asked to complete a selection of questions regarding mysql database config, site name and admin passwords etc. Its all very simple and your site should be upand running very quickly.


Manual Installation

If the web-based installation does not function, you can also install Contrexx by hand. Upload the files as descibed above and then continue as described below:


Basic configuration

First the configuration file must be adapted which is usually provided by the installer independently. You must do a manual installation from the installer/data/configuration.tpl which is copied into config/configuration.php.


Set installation status

Here you must put the installation constant CONTREXX_INSTALLED on true, so that the system knows that the system was installed:


define('CONTEXX_INSTALLED', true);


Database configuration section

Configure here the connection with your database server.


  • $_DBCONFIG['host'] = "localhost"; // This is normally set to localhost
  • $_DBCONFIG['database'] = "DATENBASE"; // Database name
  • $_DBCONFIG['tablePrefix'] = "contrexx_"; // Database table prefix
  • $_DBCONFIG['user'] = "USER"; // Database username
  • $_DBCONFIG['password'] = "KENNWORT"; // Database password
  • $_DBCONFIG['dbType'] = "mysql"; // Database type (e.g. mysql,postgres ..)


Substitute for the variable DATABAASE, FOR USER, CODE-WORD with your suitable data. The other configuration variables can be left normally in such a way as they are given.

Site path specific configuration

Here the filing path must be defined by Contrexx on the Hostsystem.

ascms_root This is the list of him your web server the files delivers, the so called Document Root.

ascms_root_offset This is the path to the list in which you have the Contrexx CMS uploaded, relatively to the DocumentRoot.


  • $_PATHCONFIG['ascms_root'] = "DOCUMENT_ROOT";
  • $_PATHCONFIG['ascms_root_offset'] = "OFFSET_PATH";


Substitute for the variable DOCUMENT_ROOT and for OFFSET_PATH with the suitable path data of your server. If you do not know this, follow the instructions in the next step as you find out this.

ascms_root and ascms_root_offset automatic Check

Provide a new PHP file (e.g., pfad.php) with the following contents: 

<?php
$offsetPath = '';
$documentRoot = '';

$arrDirectories = explode('/', $_SERVER['SCRIPT_NAME']);
for ($i = 0;$i < count($arrDirectories)-2;$i++) {
        if (!empty($arrDirectories[$i])) {print 's';
                $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.'";<br>';
print '$_PATHCONFIG[\'ascms_root_offset\'] = "'.$offsetPath.'";';
?>


Upload this file to the installer directory and open using your web browser.

Now you should get the suitable path data in your browser.

Ftp configuration

According to system configuration of your web server this requires that certain file operations can be carried out only by FTP. This is mostly with Unix systems. If your server is FTP Supported then you put the configuration variable $ _FTPCONFIG ['is_activated] on true and you substitute for the variable USERS, FOR CODE-WORD and FTP_PFAD with the suitable data.


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

Optional customizing exceptions

The following two qualities refer to the shop module. The first quality defines whether the shop navigation on every side should be indicated which should be used the second quality whether the goods basket.


  • $_CONFIGURATION['custom']['shopnavbar'] = false; // ture|false
  • $_CONFIGURATION['custom']['shopJsCart'] = false; // true|false


File Permissions The following files must have permissions set to (chmod 777).


  • /cadmin/backup/
  • /cache/*
  • /config/*
  • /feed/*
  • /images/*
  • /media/*
  • /themes/*
  • /tmp/*

Activate Administrator's Account

Finally you must activate the administrator's account. In addition you must work on, again with a MySQL client, the first entry of the database table contrexx_access_users.

Change there the following data:

password Define here the code-word for the administrator. This must be given as a MD5-Hash. Give here, for example, e10adc3949ba59abbe56e057f20f883e to use the code-word 123456 (the code-word can to Abschl


email Give here your e-mail address.


active Put here 1, so that the administrator's account is freely switched.

Now you can announce yourselves about the administration console (www.example.com/admin) with the user name system and the code-word elective by you.

Retrieved from "https://wiki.cloudrexx.com/index.php?title=Knowledgebase:Contrexx_Manual:Contrexx_Installation_Guide&oldid=21151"