Bitrix Site Manager 7

Bitrix Site Manager 7.х

Installation Guide For
Windows Server 2008 / IIS 7.0 Users

1

Contents

Introduction

Chapter 1.Installing Internet Information Services (IIS)

IIS Installation

Step 1

Step 2

Step 3

Step 4

Step 5

Installing The IIS Update

Chapter 2.Installing and Configuring PHP

PHP Installation

Step 1

Step 2

Step 3

Step 4

Step 5

Step 6

Step 7

PHP Configuration

Configuring IIS to Work With PHP

Chapter 3.Installing Bitrix Site Manager

Windows based part of installation

Run bitrix_premium_src.exe.

AddingAWebSite

Setting The Default Page

Configuring The Error 404 and SEF URL’s

Installing Bitrix Site Manager Web based part

1

Introduction

Microsoft Windows Server 2008 now includes IIS version 7.0. The greatest advantage of this version in respect to co-operation with Bitrix Site Manager is the implementation of FastCGI. Installation and configuration of Bitrix Site Manager on Windows servers has been made much more simple.

This guide is for Bitrix Site Manager users who install the system on Windows Server 2008 under IIS 7.0. The document discusses on the installation of Bitrix Site Manager and all the software required.

This guide does not explain how to install Windows Server 2008. For the installation instructions, please refer to Microsoft Corporation reference manuals.

Note: by default, Windows Server 2008 allows write access to the system folder under administrative permissions only. It means that an application in which you are going to create or edit a file, must be run under the Administrator’s account. You can change access permission for this folder, or run Windows Explorer (or another file management application) using Run as administrator command.

Chapter 1.Installing Internet Information Services (IIS)

By default, Microsoft Windows Server 2008 does not come with Internet Information Services 7.0 installed. You will have to install IIS manually; beside that, you are recommended to install an update which is not included in the distribution package.

IIS Installation

Run Start > Administration Tools > Server Manager. A Server Manager window will bring up. If required, provide your authorization information.

Select Roles in the server manager Console Tree (Fig. 1.1).

Fig. 1.1 Server roles

Click Add Roles in the right pane. An Add Roles Wizard will start (Fig. 1.2).

Step 1

Fig. 1.2 First wizard window

The first windows shows the wizard overview.

Click Next to start the role installation.

Step 2

Fig. 1.3 Choosing roles to be installed on server

Check the Web Server (IIS) box. Add Roles Wizard will show warning you that some components are required (Fig. 1.4).

Fig. 1.4 Required components notification

Click Add Required Features.

Click Next to continue installation.

Click Next in the next window.

Step 3

Fig. 1.5 Selecting the components

Select the following components.

Note: when you select some of the below listed components, you may see the Add Roles Wizard dialogs bringing up (Fig. 1.4) suggesting to install the missing features. In that case, always click Add Required Features.

Management toolsIIS6 Management Compatibility – if you are planning to use a standard SMTP- or FTP server.

Management toolsManagement Service – required for remote IIS administration using IIS Manager addon rather than Remote Desktop Protocol.

FTP Publishing Service –required bythe FTP server.

Application Development CGI – this option is essential to allow PHP run in FastCGI mode.

Health and DiagnosticsLogging tools – required for journaling.

PerfomanceDynamic Content Compression - required to compress dynamic files.

Common HTTP Features HTTP Redirection – used by HTTP redirections.

Note: you can add other required features later by selecting Roles > Web Server (IIS) in Console Tree and clicking Add Role Services.

Click Next to proceed.

Step 4

Fig. 1.6 Confirming the selected options

Check the installation parameters and click Install.

Fig. 1.7 The system is performing the installation

Wait while the wizard is installing the role.

Step 5

Fig. 1.8 Completing the installation

The installation is now completed. Click Close.

A new IIS role will show in the server manager (Fig. 1.9).

Fig. 1.9 New role

Installing The IIS Update

In order to proceed, you must update IIS to version 7.0 which is not a part or Windows Server 2008 at the moment of writing this document.

Download the required update from

Install the update following the installation wizard instructions.

Chapter 2.Installing and Configuring PHP

PHP Installation

Download the PHP 5 non thread safe installation file from (for example PHP 5.2.9-1 Non-thread-safe installer).

Run the downloaded file and follow the installation wizard instructions.

Step 1

Fig. 2.1 The PHP installation wizard

The first window show the product information. Click Next.

Step 2

Fig. 2.2 License agreement

Read the license agreement. Check the box I accept the terms in the License Agreement if you accept it.

Click Next to proceed.

Step 3

Fig. 2.3 Choosing the destination folder

Choose the directory to which the software will be installed.

Click Next.

Step 4

Fig. 2.4 Choosing the web server type

Select IIS FastCGI.

Click Next.

Step 5

Fig. 2.5 Selecting PHP extensions

Enable the required Extensions:

GD2;

LDAP (if you are planning to use LDAP authorization);

OpenSSL;

SMTP;

Win32ps;

Win32scheduler;

Zip.

Note: you can activate these extensions manually at a later time by adding the lines extension=extension_file_name.dll to php.ini in the PHP installation folder. For example: extension=php_win32scheduler.dll.

Click Next.

Step 6

Fig. 2.6 PHP is ready to install

Click Install.

Fig. 2.7 PHP is being installed

Wait while the wizard copies and installs files.

Step 7

Fig. 2.8 The installation is completed

Now PHP has been installed successfully. Click Finish to close the wizard.

PHP Configuration

Now that PHP has been installed, you have to configure it.

Open the PHP installation folder in any file manager.

Open php.ini for editing.

Add the following parameters:

fastcgi.impersonate = 1

cgi.fix_pathinfo = 1

cgi.force_redirect = 0

short_open_tag = On

extension_dir = "C:\<php folder_path>\PHP\ext"

upload_tmp_dir="C:\inetpub\temp"

session.save_path="C:\inetpub\temp"

allow_call_time_pass_reference = On

display_errors = On

Note: in order to verify the installation correctness, you can run C:\<folder path>\PHP\php –info. You would get this configuration if there are no errors.

Configuring IIS to Work With PHP

Now you have to configure IIS in such a way that all PHP files are processed by FastCGI.

Note:If you install PHP version 5.2.9 or higher, Handler Mappings and FastCGI settings are configured automatically.

Select Handler Mappings in IIS group (Fig. 2.9). Handler Mappings settings will bring up.

Fig. 2.9 IIS configuration

Select Add Module Mapping in the Action pane. The Add Module Mapping window will open (Fig. 2.10).

Fig. 2.10 Extensions

Type *.php in Request path field.

Select FastCGIModule in Module field.

Type the path to php-cgi.exe in Executable field.

Warning! Quote the file path if it contains spaces.

Note: use php.exe if you run Bitrix Site Manager with PHP version prior to 5.0.

In the Name field, type the name for the created Module Mapping.

Click ОК. Module Mapping is now created.

Go back to the remote sever home page.

Click Restart in the Action pane.

You can check that the new binding works fine the following way:

create a file test.php in C:\Inetpub\wwwroot and add the following line to it:

<? phpinfo(); ?>

Type in your browser.

If the configuration is correct, a conventional PHP information page will open (Fig. 2.11):

Fig. 2.11 PHP information

However, additional configuration is required to improve system performance. You can do that in Internet Information Services Manager.

Download Administration Pack for IIS 7.0 for your server type ().

Install it following the wizard instructions.

Restart the web server and IIS Manager. The FastCGI Settings shortcut will become available (Fig. 2.12).

Fig. 2.12 IIS settings

Activate the icon. FastCGI settings will show (Fig. 2.13).

Fig. 2.13 FastCGI settings

Select Edit in the Actions pane. FastCGI configurator will bring up (Fig. 2.14).

Fig. 2.14 FastCGI configurator

Set InstanceMaxRequests to 10000.

Select EnvironmentVariables and click the properties button on the right to bring up the collection editor (Fig. 2.15).

Fig. 2.15 Adding a new variable

Click Add and add the PHP_FCGI_MAX_REQUESTS parameter. Set it to 10000.

Save changes.

Now configure the time-out parameter.

Activate Default Web Site in the Connection pane of IIS Manager. The Action pane will refresh.

Select Limits in the Configure group. Open the limits settings form (Fig. 2.16).

Fig. 2.16 Limits

Set Connection time-out to 600.

Save changes.

This will wittingly set the very long script execution time-out – 600 seconds.

Open php.ini for editing.

Add the following parameters: max_execution_time = 240 and max_input_time = 240.

Save changes.

Note: you can optimize these values still further depending on your hosting server peculiarities.

Chapter 3.Installing Bitrix Site Manager

You will install Bitrix Site Manager using the installation package bitrix_premium_src.exe.

Windows based part of installation

Run bitrix_premium_src.exe.

The installation wizard window will open:

Read the License Agreement. You must accept it to continue the installation:

The next installation screen will suggest to download and install the system execution environment package. This package (bitrix_env_nodb.exe) contains free applications Apache and PHP preconfigured to run the system. The product can be installed to support IIS, however, you will have to install PHP and configure IIS manually.

Since you install the system on IIS, you do not have to install the execution environment (Apache and PHP).

Uncheck the Install Bitrix Environment box.

In the warning window, click Yes:

ClickNext.

The next step suggests that you select the folder in which the system will be installed:

Click Browse and select any installation path of your choice. For example: C:\inetpub\wwwroot:

Note!This folder is a primary application folder.

Click Next.

Click Install.

After that, the Bitrix Site Manager installation is starting.

Click Finish.

Note: To install in silent mode without user interface, run the installation file with the following parameters:
bitrix_premium_src.exe /VERYSILENT /DIR="C:\inetpub\wwwroot\bitrix" /NOENV

Adding A Web Site

In IIS manager, open Sites in the Connections pane.

Delete the Default Web Site.

Note: you can proceed without deleting the default web site, but you will have to change the port for a new site in that case.

Select Add Web Site in context menu (Fig. 3.1).

Fig. 3.1 Creating a new site

A new site dialog will show (Fig. 3.2).

Fig. 3.2 New site creation

Specify the host name in Site name (here: bitrix).

Type the path to the folder containing the extracted files (primary application folder) in Physical path.

Click Test Setting. The system will verify the connection settings and warn you if any error occurs (Fig. 3.3).

Fig. 3.3 Establishing a test connection

The most common are the authorization errors whose reason is that the connection is lacking access permissions. The following actions will fix the error.

Close the Test Connection dialog.

Click Connect as (Fig. 3.2) to show the connection preferences dialog (Fig. 3.4):

Fig. 3.4 Selecting a user

Check the Specific User box and click Set.

Type the administrator’s login and password. Click ОК.

Test the connection again.

Save the site.

Setting The Default Page

Note: If you use PHP version 5.2.9 or higher, the default page is configured automatically.

Select bitrix in Connections.

Select Default Document in IIS group (Fig. 3.5).

Fig. 3.5 Documents

Click Add and add index.php (Fig. 3.6).

Fig. 3.6 Adding an index page

Save changes.

Configuring The Error 404 and SEF URL’s

SEF URL’s are implemented via handing error 404.

Select bitrix in Connections of IIS Manager.

Activate Error Pages in IIS group (Fig. 3.7).

Fig. 3.7 IIS control panel

Right-click the row containing the error 404 to bring up the error properties form (Fig. 3.8).

Fig. 3.8 Error properties

Select Execute a URL on this site.

Type the error 404 script path in URL: /404.php. This file is created at the Bitrix Site Manager installation time.

Click ОК.

Click Edit Feature Settings…

Check “Custom error pages” option. Click OK.

Installing Bitrix Site Manager Web based part

Bitrix Site Manager can be installed and configured remotely.

Select bitrix in the Connections pane. Click Browse in the Action pane of the Browse Web Site group. The web browser will start showing the initial installation step of Bitrix Site Manager. Alternatively, you can run the browser and open the page .

Now the web installation stage is starting to complete the system configuration. The URL will open in a web browser window. Click Next.

Accept the license agreement.

Click Next.

Enter the license key: SM7-MS-132X5091100000

Click Next.

The web part installer will check your system to meet the requirements. If the test has passed, click Next.

Now provide the SQL Server 2005/2008 access parameters.

The system accesses SQL Server via ODBC; therefore enter parameters in ODBC DSN format.

If a new user or a database are required to be created, provide the sa access parameters. If a database and a user already exist, such user must have dbo permission for this database.

Having specified all the parameters, click Next.

If you install on Windows Server 2008 x64, potentaial ODBC connection problems are possible as shown below:

If the connection has been established successfully, proceed with the installation.

Otherwise, you have to configure ODBC. Open the Run dialog (Start->Run...), and type %SystemRoot%\SysWow64\odbcad32.exe . Click OK.

The ODBC Data Source Administrator window will open. Click Add on the System DSN tab.

Select SQL Driver.

Type the SQL Server name and address.

Configure the server access parameters. Click Client Configuration...

Check your SQL Server connection parameters. Click OK.

If the parameetrs you have specified are correct, the next step will open.

Click Next.

Click Finish.

Check the parameters in this window and click ОК.

Now the parameters are saved.

Now return to the web browser window and click Next to continue:

Enter the access parameters for a new site Administrator.

The configuration wizard will start:

After the configuration has been completed, your new site will open. To manage the site, click the Control Panel tab on top of the screen.

1