Bitrix Site Manager Installation Guide
  1. Extract files from the Bitrix Site Manager distribution package to the root directory of your site.
  2. Prepare your system for installation. If you install Bitrix Site Manager on a public hosting service, please ensure that it satisfies the following minimum requirements.
    • Install the Apache web server (or IIS) if it is not installed yet. Configure it so that it can work with PHP. Bitrix Site Manager requires Apache web server version 1.3 or higher (or IIS), and PHP version 4.1.2 or higher.
    • Install the desired database engine (MySQL version 4.0.18 or higher; or Oracle 9.0 or higher; or MSSQL 2000 or higher).
    • If you install the trial or encoded product version, please install and configure free Zend Optimizer (version 2.6.x or higher).
    • If you install the Oracle edition of the product, please ensure the client part of Oracle 9 or higher is installed. Create a new user there (you can do that during installation later).
    • If you install a MSSQL version, ensure the ODBC is supported.
    • If you re-install the system, remember to delete all tables from the database.
    • Ensure the disk has extra 10 Mb of free space for the update system to function properly.
  3. Open a page: http://<your site>/index.php in your browser (replace your site with the real address of your site).
  4. Follow the installation wizard instructions.

    Step 1 (the start):

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

    Step 2 (license agreement):

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

    Step 3 (database type selection):

    • License key: If you have already purchased a license, enter the received key here. If you install the product for evaluation purposes, leave the default field value (DEMO).
    • Choose database: You must select the database type for which your license were issued. Selecting any database type other than the one stipulated by the license violates the license agreement and can cause partial or full malfunction of your site.

    Note! The MSSQL database type will be available if only ODBC is supported by your system. Oracle databases require the OCI8 library (the file php_oci8.dll) to be installed. If your system do not meet all or one of these conditions, the MSSQL and/or Oracle database types will not be available.

    Here you can also choose additional installation options.
    You can:

    • Install demo data. If the option is not selected, the setup will install:
      • a site;
      • the "Administrators" user group;
      • only the Kernel module.

      Note! This option does not install site templates, you will have to add them manually.
      All modules available for the current edition can be installed on demand on the page: Settings -> System settings -> Modules.
      This option is for experienced users only!
    • Install Help files. The help section requires additional 12 Mb of disk space.

    Installation step 4 (preliminary verification):

    The installation wizard checks your system for minimum requirements and displays advices on how to tune your system for optimal performance of your site.

    If your system does not match minimum requirements, the problem description in red will display on the top of the screen.
    The detailed description of the incompatibility can be found in the page body. You cannot continue installation until you fix the problem.

    If your system does not match the recommended settings, the problem description in brown will display on the top of the screen. You will find the detailed description of the incompatibility in the page body. You can still continue installation with such incompatibilities, but it is strongly recommended to tune the system configuration after the installation in such a way that they satisfy the recommended settings. You can check the settings later using the Site check form of the administration section. For example, the folder in which the session parameters will be stored may be missing from the PHP settings. But, if the folder /tmp exists on the server, it will be used by default. In this case, the warning bear the informational meaning.

    Installation step 5 (database creation):

    Here the license file and the database connection configuration file are created, and the data is loaded in the database.

    • MySQL:
      • Server: Server that hosts the database engine. Usually "localhost" for local servers.
      • Database user: If checked, a new database user will be created. Otherwise, the currently existing user will be used.
      • User name: User name (login) of the database user to access the database.
      • Password: User password to access the database.
      • Database: if checked, a new database will be created. Otherwise, the existing database will be used.
      • Database name: Name of the database to which the product will be installed.

        Note! If you choose to create a new database or database user, you will have to provide the database administrator login and password.

        Note! the database administrator user name and password are used only at the installation and database creation time. These data are not stored in the system.

      • Login: administrator login to be used for connection to the database.
      • Password: administrator password to be used for connection to the database.
      • Type of database tables: Select here the required type of tables. MySQL implements custom table types starting from version 4.0

    • Oracle:
      • 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))).
      • Database user: If checked, a new database user will be created. Otherwise, the currently existing user will be used.
      • User: User name (login) of the database user used to access the database.
      • Password: User password to access the database.

        Note! If you choose to create a new database or database user, you will have to provide the database administrator login and password.

        Note! the database administrator user name and password are used only at the installation and database creation time. These data are not stored in the system.

      • Login: administrator login to be used for connection to the database.
      • Password: administrator password to be used for connection to the database.

    • MSSQL:
      • DSN: string used to connect to the server on which the database management system runs. The string should contain, at least, the connection driver parameters and the server name. Optionally, you can include the user name, password or other parameters in the string.

        Note! Sometimes it is recommended to specify a user DSN name here (a connection must be created in advance).
        For local servers (if the product is installed on the same server as the database), this parameters has a value localhost;
      • User: User name (login) of the database user used to access the database.
      • Password: User password to access the database.
      • Create database: Check this option to create a new database.
      • Database name: type the name of the database to which the system will be installed

        Note! If you choose to create a new database or database user, you will have to provide the database administrator login and password.

        Note! the database administrator user name and password are used only at the installation and database creation time. These data are not stored in the system.

      • Login: administrator login to be used for connection to the database.
      • Password: administrator password to be used for connection to the database.
    • Additional parameters:

      • Access permission for site files: Permissions that will be applied to all 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 the file /bitrix/php_interface/dbconn.php.

    Installation step 6 (configuration):

    Here you can set up the site and create the site administrator account. This account gives its user exclusive access to the site management and allows to alter all the site settings. You can create additional users with less rights after the system is installed.
    • First name: The first name of the site administrator.
    • Last name: The last name of the site administrator.
    • E-Mail: The e-mail address of the site administrator.
    • Login: The site administrator login string used to access the site control panel. Login should contain at least 3 symbols. Login can contain Roman letters and digits only.
    • Password: The site administrator password to access the site control panel. Login should contain at least 6 symbols. You can use here Roman letters and digits only.
    • Confirm password: Type in the password again to ensure its correctness.


    Installation step 7 (finish):

    The system installation and initial customisation is complete. Now you can:
    - switch to the administration section to adjust more web server settings, add news etc. Further, you can access the administration section using the link in the top toolbar (the toolbar becomes visible after authorization) or directly by typing http://<your site>/bitrix/admin in your browser;
    - go to the site template selection form. You can use this page to install or delete the site design layouts.
    - go to the site public section, which is the very section 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. 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, select Statistics in the drop-down menu).
    • Add the following directive to the .htaccess file in the site root folder:

      php_flag session.use_trans_sid off

      to disable adding session identifier to the site links. Remember that your version of the Apache web server may not support this.
    • Add the following directives to the .htaccess file 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-2007 Bitrix   www.bitrixsoft.com | Support