Bitrix Site Manager Installation Guide
  1. Extract files from the Bitrix Site Manager distribution package to the root directory of your site. The "Professional" edition requires approx. 30Mb of free disk space. The "Standard" edition requires approx. 24Mb of free disk space. The "Web Analytics" edition requires approx. 8Mb of free disk space.

  2. Prepare your system before you install the product. If you install Bitrix Site Manager on the public hosting service, please ensure it satisfies the following minimal  requirements.
    • Install the Apache web server if it is not installed yet. Configure it to work with PHP. Bitrix Site Manager requires Apache web server version 1.3 or higher and PHP version 4.1.2 or higher.
    • Install the desired database engine (either MySQL version 3.23 or higher, or Oracle 9.0 or higher).
    • If you install the trial or encoded product version, please install Zend Optimizer version 2.1.0 or higher.
    • If you install the Oracle edition of the product, please ensure the client part of Oracle 9 or higher is installed and create a new user.
    • If you re-install the system, please remember to clean up the database and delete all tables.
    • Please ensure the disk has extra 10 Mb of free disk space for the update system to function properly.


  3. Open URL http://<your site>/index.php in your browser (substitute your site with the real address of your site).
    If you install the "Web Analytics" edition, please open URL http://<your site>/install_bitrix.php.

  4. Follow the installation wizard instructions.

    Installation step 1 (Start of installation):

    Beginning of the installation process. The installation wizard displays information on the product setup.

    Installation step 2 (license agreement):

    The installation wizard displays the license agreement. You should read it carefully and accept it to install the product.

    Installation step 3 (advance checks):

    The installation wizard checks your system for the minimum requirements and displays advices on how to customize your system for optimal performance of your site.
    If your system does not match minimum requirements, a red text with the problem description will display on the top of the screen.
    Detailed description of the incompatibility can be found within the page body. You cannot continue installation until you fix the problem.
    If your system does not match the recommended settings, a brown text with the problem description will display on the top of the screen. You will find the detailed description of the incompatibility within the page body. You can still continue installation with such incompatibilities, but it is strongly recommended to adjust the system configuration to satisfy the recommended settings. You can check the settings later using the form "Site check" of the administrative section.

    Installation step 4 (database creation):

    Creating the license file, creating the database connection configuration file, loading data in the database.
    • License key: If you have purchased the system, please type in the license key that you should have received. If you install the trial version, this field should contain text DEMO.
    • MySQL:
      • Server: Server that hosts the database engine. Usually "localhost" for local servers.
      • User: User name (login) of the database user used to access the database.
      • Password: User password to access the database.
      • Database: Name of the database where the product will be installed.
      • Create database: Check this option to create database with the name provided in the previous field.
      • Type of tables for database: Select the required type of tables. MySQL implements custom table types starting from version 4.0
    • Oracle:
      • User: User name (login) of the database user used to access the database.
      • Password: User password to access the database.
      • Connection string: This field should contain either the name of the local Oracle instance, or the name of the record in file tnsnames.ora that you want to connect to. Example of the name of the local Oracle instance: (DESCRIPTION = (ADDRESS_LIST = (ADDRESS = (PROTOCOL = TCP)(HOST = 000.000.0.00)(PORT = 0000)))(CONNECT_DATA = (SERVICE_NAME = BX))).
    • Additional parameters:
      • Access permission for site files: Permissions that will be applied to the newly created files. Access permissions should allow the web server to write to files. The default value is 0777.
      • Access permission for site folders: Permissions that will be applied to the newly created folders. Access permissions should allow the web server to write to folders. The default value is 0777.
      • Memory limit: Maximum amount of memory available to site scripts (some hosting services ignore this value).

    You can alter the database connection parameters manually by editing file /bitrix/php_interface/dbconn.php.

    Installation step 5 (system customization):

    Site customization, creating the site administrator account. This account will allow exclusive access in respect to site management and changing its settings. You can create additional users with less rights after the system installation.
    • First name: First name of the site administrator.
    • Last name: Last name of the site administrator.
    • E-Mail: E-mail address of the site administrator.
    • Login: Login of the site administrator to access the site administrative section. Login should contain at least 3 symbols. Login can contain Roman letters and digits only.
    • Password: Password of the site administrator to access the site administrative section. Login should contain at least 6 symbols. You can use Roman letters and digits only.
    • Confirm password: Type in the password again to ensure its correctness.


    Installation step 6 (finish):

    The system installation and initial customization is now complete. Now you can:
    - go to the administrative section to adjust more web server settings, add news etc. Henceforth you can access the administrative section using the link in the top toolbar (the toolbar becomes visible after authorization) or directly by typing URL http://<your site>/bitrix/admin in your browser.
    - go to the site template page of the administrative section. You can use this page to install or delete site design layouts.
    - go to the public section of your site available to your visitors. To do so, simply refresh the page.
    - visit the Bitrix corporate web site (http://www.bitrixsoft.com) where you can ask questions on using Bitrix Site Manager: in the forum or automated technical support service, and read the late-breaking news on the product.

  5. To integrate the "Web Analytics" edition of Bitrix Site Manager in the existing site, simply add the following code in the beginning of each page of your site:

    At the beginning of file:
    <?require_once($_SERVER["DOCUMENT_ROOT"]."/bitrix/modules/main/include/include_statistics_before.php");?>

    At the end of file:
    <?require_once($_SERVER["DOCUMENT_ROOT"]."/bitrix/modules/main/include/include_statistics_after.php");?>


    This code activates the system for accumulation statistics of the site visitors. If you install any other product edition, you do not have to add anything to your files.

  6. If you want, you can adjust more system settings.
    • Upload a CSV file with IP-to-country information for use with the Statistics module. You can do so in the Statistics module settings page (menu "Settings", drop-down menu "Statistics").
    • Add the following directive to file .htaccess in the site root folder:

      php_flag session.use_trans_sid off

      to disable session identifier substitutes in site links. Remember that your version of the Apache web server may not support this.
    • Add the following directives to file .htaccess in the site root folder:

      ExpiresActive on
      ExpiresByType image/jpeg "access plus 3 day"
      ExpiresByType image/gif "access plus 3 day"

      to enable image caching. Your version of the Apache web server may not support this.
The latest version of documentation is available at http://www.bitrixsoft.com/help/


Copyright © 2001-2005 Bitrix   www.bitrixsoft.com | Support