• Install Apache web server (or IIS) if it is not installed yet. Configure it to support PHP. Bitrix Site Manager requires Apache web server version 1.3 or higher (or Microsoft IIS 5.0 and higher), and PHP version 5.0.0 and higher.
• Install the desired database engine (MySQL version 4.1.11 (5.0 and higher is recommended); or Oracle 10g or higher; or MSSQL 2000 or higher).
• If you install the Oracle based edition, please ensure the client part of Oracle 10g or higher is installed. Create a new user there (alternatively, you can do that during the installation).
• If you install a MSSQL version, ensure that 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.

Installation Step 1 (The Start)

The installation process starts. The installation wizard displays information about the product and the installation.

Installation Step 2 (License Agreement)

The installation wizard displays the license agreement. Read it carefully. You have to accept the license agreement to continue the installation.

Installation Step 3 (Database Type Selection)

• License key: If you have already purchased a license, enter the license key here. If you install the product for evaluation purposes, leave the default field value (DEMO).
• Choose database: You must select the exact database type for which your license has been 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 the portal.

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 does not meet these conditions, the MSSQL and/or Oracle database types will not be available.

Oracle and MySQL databases can be installed in UTF-8 encoding. If you choose to install UTF-8 version, mark the Install in UTF-8 Mode option.

Installation step 4 (Preliminary Verification):

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

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, you can still proceed with the installation. The installer will show the potentially incorrect settings. However, it is strongly recommended that you bring these settings into line with the recommended values. You can verify the system preferences in the Site Check form in Control Panel.

Installation step 5 (Database Creation):

Here the license file and the database connection configuration file are created, and the data is uploaded to the database.

• MySQL:
  • Server: Server that hosts the database engine. Usually "localhost:31006" for local servers.
  • Database user: If checked, a new database user will be created. Otherwise, an existing user will be used.
  • User name: The user name (login) of a database user to access the database.
  • Password: The user password to access the database.
  • Database: if checked, a new database will be created. Otherwise, the existing database will be used.
  • Database name: The 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's login and password.

    Note! The database administrator's user name and password are used only at the installation and database creation time. This information is not stored in the system.

  • Login: the administrator's login to be used for connection to the database.
  • Password: the administrator's password to be used for connection to the database.
  • Type of database tables: Select here the required type of tables. MySQL supports custom table types as of version 4.0 and higher.
• Oracle:
  • Connection string: This field should contain either the name of a local Oracle instance, or the record name in tnsnames.ora 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, an existing user will be used.
  • User: A user name (login) of the database user used to access the database.
  • Password: A 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's login and password.

    Note! the database administrator's user name and password are used only at the installation and database creation time. This information is not stored in the system.

  • Login: the administrator's login to be used for connection to the database.
  • Password: the administrator's password to be used for connection to the database.
• MSSQL:
  • DSN: a database connection string. 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.

    Note! Sometimes you would need to specify a user DSN name instead of the server name here (a connection must already exist).
    For local servers (if the product is installed on the same server as the database), this parameters is usually localhost;

  • Database user: If checked, a new database user will be created. Otherwise, an 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.
  • 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's login and password.

    Note! The database administrator's user name and password are used only at the installation and database creation time. This information is not stored in the system.

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

• Additional parameters:

  • Access permission for portal 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 portal 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.

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

Installation step 6

Here the system creates the database. This step does not require any user interaction. The process of the database creation is indicated by the progress bar. When the database creation is completed, the installation wizard will proceed to the next installation step.

Installation step 7 (Configuration)

Here you can configure the portal and create the portal administrator account. This account gives a user the exclusive access to the portal management functions and allows to edit all the portal settings. You can create more users with less permissions later.

• Login: The portal administrator login to access the portal Control Panel. Login should contain at least 3 symbols which can be Latin letters and digits only.
• Password: The portal administrator password. Login should contain at least 6 symbols which can be Roman letters and digits only.
• Confirm password: Type in the password again to ensure its correctness.
• E-Mail: The e-mail address of the portal administrator.
• First name: The portal administrator's first name.
• Last name: The portal administrator's last name.

When the administrator account is created, the system will start the Demo Portal Creation Wizard.

Follow the installation wizard instructions.

Note: The Cancel button in the Demo Site Creation Wizard is disabled during the installation. This button is active when the wizard is launched in Control Panel.

Wizard Step 1

Here you can select the template for your portal. Templates vary in design, main page layout and settings.

Wizard Step 2

Choose the required colour scheme for your site. Each template has a specific set of colour schemes.

Wizard Step 3

Specify the name and title of your portal, and provide the company logo.

Wizard Step 4

This step configures the installation parameters. If you specify to set the Active Directory preferences, the two additional substeps will follow in which you will configure your Active Directory and provide the AD-to-portal user group mapping.

Otherwise, the wizard will proceed to the last step.

Wizard Step 5

This step installs the portal files and does not require any user interaction. You can watch the installation process in the progress bar. Then, the installation wizard will proceed to the final step.

Final Step

This screen shows that the Portal Creation Wizard has completed successfully.

• 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 Apache web server may not support this.