- Extract files from the Bitrix Site Manager distribution package to the root directory of your site.
- 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.
- Open a page: http://<your site>/index.php in your browser
(replace
your site with the real address of your site).
- 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.
- 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/
|