PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
  • This lesson will teach you the following concepts
  • Overview
  • Required configuration
  • Installing and configuring the "WEBDEV Application Server - 10 Connections"
  • Installing the "WEBDEV Application Server - 10 Connections"
  • Configuration via the Hosting Control Center
  • Creating a deployment account
  • The different deployment modes
  • A detailed example: deployment by FTP
  • Correspondence between the directories of the development computer and the deployment
Lesson 6.1. Deploying a site
This lesson will teach you the following concepts
  • How to deploy?
  • Required configuration

Estimated time: 30 mn
Previous LessonTable of contentsNext Lesson
Overview
When the WEBDEV site is developed, it must be deployed on a server in order to make it accessible to the Web users.
We are going to present the different steps required to deploy a WEBDEV site.

Note

This section presents the deployment on a Windows server. If you want to use a Linux server, see the documentation about the WEBDEV application server for Linux or the online help.
Several methods can be used to deploy a dynamic WEBDEV site:
  • Deployment by physical media (CD, ...). This deployment can be stand-alone: in this case, a Web server and a limited WEBDEV application server are also installed by the setup.
  • Remote deployment from the development computer (by FTP).
  • Remote deployment from a management computer (by FTP) via a "deployment package"
  • Deployment via the test hosting service of PC SOFT.
  • Deployment in PC SOFT Cloud.
Required configuration
For the deployment on the server, the following elements must have been installed and configured:
  • A Web server,
  • An FTP server,
  • A WEBDEV application server (a 10-connection version is supplied with WEBDEV).
When installing WEBDEV, you have the ability to install the test version of WEBDEV application server. This allows you to test the deployment of your dynamic sites.
To simplify the deployment operations and to allow you to directly test the deployment of your Web site, we will:
  • Install a WEBDEV Application Server 10 connections on a Windows computer. This application server must be installed on a computer other than the development computer. WEBDEV Development must not be installed on this computer.
  • Deploy the site remotely (by FTP).

Note

If you already have the parameters for accessing the server on which your site will be deployed, there is no need to install the WEBDEV Application Server 10 Connections. The setup can be directly performed on the server by FTP.
Installing and configuring the "WEBDEV Application Server - 10 Connections"
The setup program of "WEBDEV Application Server - 10 Connections" is available:
  • for download on the www.windev.com site, in the "Download" section, "WEBDEV upgrades", "Application server (deployment)".
  • on the setup DVD of WEBDEV: start "Menu.exe" and select "Install a WEBDEV Application Server - 10 connections"..

Installing the "WEBDEV Application Server - 10 Connections"

The setup steps are as follows:
  1. Accept the license agreement. Go to the next wizard step.
  2. Choose the "Windows" platform. Go to the next step.

    Note

    This section presents the deployment on a Windows server. If you want to use a Linux server, see the documentation about the WEBDEV application server for Linux or the online help.
  3. Select the setup path of application server ("C:\WEBDEV23" by default).
  4. The next step is used to specify the advanced parameters of WEBDEV application server. Keep the option "Use the default parameters".
  5. If an earlier version of WEBDEV application server was already installed on the same computer, the wizard is used to define the management of sites and webservices in earlier versions. Keep the option "Allow the deployment of sites in version 23" and go to the next step.
  6. The next step is used to manage the hosting of SaaS sites. The SaaS activation automatically installs a site and a Webservice to manage your SaaS sites. See the online help for more details. Validate this step.
  7. The next step requires a secure connection for accessing the SaaS administrator.
  8. Validate the different setup steps.
    Note: The IIS Web server is automatically installed if no valid Web server is detected by the setup (in case of failure, you will have the ability to install the Apache Web server).
  9. Select the virtual Web servers on which the WEBDEV application server must be installed. The default Web site is sufficient. Validate.
  10. Keep the selected options and check "Start the WEBDEV administrator". Validate.
  11. The administrator is automatically started.

Note

The PDF file named "WebDevDeployment.pdf" is installed with the WEBDEV application server 10 connections. This file may help you solve the configuration problems linked to the access rights on the server.
Note: If the option "Place the icons in the Start menu" was checked at the end of setup, this file will be accessible via the "Start" menu.

Configuration via the Hosting Control Center

The Hosting Control Center is a tool designed to automatically configure the Application Server, the Web Server (IIS) and the FTP Server (IIS). To use the Hosting Control Center:
  1. Start the Hosting Control Center from the "Start" menu of Windows.
  2. In the "Hosting parameters" group, click "Directories".
    Note: The different options of this group allow you to define the parameters that will be used by default for your hosting server.
  3. Indicate where the sites will be installed. Choose the root directory where the sub-directories of WEBDEV accounts will be created.

    Note

    Use a directory local to the computer. If you want to use a network directory, a UNC path must necessarily be specified. The Internet guest of computer must have access to this path without having to authenticate.

    You can choose the names of sub-directories that will contain the sites, the webservices and data.
  4. Click "Accounts of OS" and define the groups where the Windows users created for the deployment will be assigned.
    For the deployment, you can create a group or use the standard "Power Users" group.
    For running sites, a good practice consists in using the "IIS_IUSRS" group (on the Windows versions where it exists).
  5. Click "WEBDEV accounts" to specify the limitations of resources that will be applied to the WEBDEV accounts:
    • Maximum number of connections that will be shared between sites (0 corresponds to an unlimited number),
    • Limitation regarding the number of sites to associate with an account, ...
  6. Click "HFSQL Client/Server database" to configure the creation of a HFSQL database whenever a user is created.
  7. Once the hosting is configured, click "Apply" then the "Refresh" button (if this button is proposed).

Creating a deployment account

The Hosting Control Center also allows you to create a deployment account. To create a deployment account:
  1. Click "User accounts".
  2. Click the "New user" button. The wizard for creating a new user starts. All you have to do is follow the different steps.
  3. Type the user name and password (you also have the ability to generate the password. In this case, don't forget to write it down!). Go to the next wizard step.
  4. The wizard proposes to create the necessary Windows accounts. Keep the default choices and go to the next step.
  5. Type the information regarding the user. Go to the next step.
  6. The directories of the user account are automatically filled according to the specified data.
  7. Continue with the wizard until you reach the "Virtual Web site" step.
    • If you choose to create a new virtual site, all you have to do is specify the DNS name that will lead to this site (the DNS must be configured accordingly).
    • If you choose to use an existing virtual site, its configuration will be replaced.
  8. Go to the next step.
  9. Select an FTP site. Go to the next step.
  10. The wizard is ended. Check all choices. You have the ability to uncheck some operations if you do not want the wizard to perform them on your behalf.
  11. Validate the wizard. Your server is now ready to receive WEBDEV sites.
The different deployment modes
Now that our Web server was configured, we are ready to deploy our site. Several methods are available. The choice of a method mainly depends on the technical constraints (ability to use an FTP server or not, access to the server, ...). A dynamic WEBDEV site can be deployed according to one of these methods:
  • Deployment by physical media (CD, ...). The deployment by physical media creates a setup support (like an application) that will have to be run on the server directly. This deployment mode avoids having an FTP server. It operates on Windows only.
  • Remote deployment from the development computer (by FTP). We are going to deploy our site according to this method.
  • Remote deployment from a management compute (by FTP) via a "deployment package". This deployment mode operates like the deployment by FTP. The only difference: the deployment is not performed from the development environment of WEBDEV. In this mode:
    • the developer generates a deployment package.
    • The site manager (who can be a person other than the developer) deploys the package on the remote server (by using the same mechanism as the deployment by FTP) via WDDeploy. WDDeploy is a freely distributable tool that is supplied with WEBDEV.
  • Deployment via the test hosting service of PC SOFT.
  • Deployment in PC SOFT Cloud.
Let's study the deployment by FTP.

A detailed example: deployment by FTP

We are going to deploy the "Full_WEBDEV_Site" project that was used in part 3 of this tutorial. A corrected version is available if you did not use this project yet.
  • To open this project in WEBDEV:
    1. Close (if necessary) the current project in order to display the home window.
    2. In the home window, click "Tutorial" and select "Full WEBDEV Site (Exercise)".

      Answer

      If you did not perform the operations in the previous parts, open the corrected project. This project contains the different pages created in the previous parts.
      To open the corrected project, on the "Home" pane, in the "Online help" group, expand "Tutorial" and select "Full WEBDEV site (Answer)".
Preparing the setup
A setup wizard is supplied with WEBDEV ; this wizard allows you to easily install your site at the hosting company (Internet or Extranet site for example) or on one of your servers dedicated to WEBDEV hosting (Intranet site for example).
  • We are going to use this wizard:
    1. In the ribbon, on the "Project" pane, in the "Generation" group, expand "Deploy the site" and select "Deploy the site remotely".
    2. Display the next step.
    3. Before performing the setup, all elements found in your site must be included in a library. A library is a file that groups all elements created during the development steps (description of database, pages, reports, queries, ...). The HTML pages and the images are not included in the library.
      Go to the next step.
    4. Several languages can be included in the library. In our example, we will keep the default options. Go to the next step.
    5. The information about the library version is used to enter the elements that will be displayed in the file properties in the Windows explorer. Go to the next step.
    6. Don't save the project and validate the library creation.
Setup
  • The setup wizard will now ask you some questions to define how your site will be deployed. In our case, we are going to perform a remote setup by FTP:
    1. Select the first option "Deploy the WEBDEV site on a remote WEBDEV Application Server". Go to the next step.
    2. To define the server parameters, the following information must be supplied by your hosting company. We are going to type the information corresponding to the setup that was performed beforehand:
      • Server address (in our example, name of computer where WEBDEV Application Server 10 connections was installed). The name can be:
        • a computer name accessible by network (for example: "TestServer"),
        • an IP address (for example: 192.168.15.99),
        • an Internet address (for example: www.myserver.eu).
      • Characteristics of user account typed by the hosting company in the WEBDEV account manager.
      • Characteristics of FTP account typed by the hosting company when creating an FTP account.

        Note

        Caution: the user name can be preceded by the domain name to avoid confusions. For example: "mycomputer\test" or "mydomain\test"
    3. When the information regarding your WEBDEV account and your FTP account was typed, go to the next step.
    4. Type the parameters for site deployment. We will keep the default options. Go to the next step.
    5. WEBDEV establishes the connection and it summarizes the operations to perform (number of files ot update, number of files to delete, ...). To get the details of operations and ot modify them if necessary, click the "Edit the list of files" button.
    6. Go to the next step.
    7. The wizard proposes to include the automatic modification of data files in the setup. You also have the ability to configure the elements required to use a HFSQL Client/Server database. Keep the default options and go to the next step.
    8. Specify the site parameter:
      You can modify:
      • The maximum number of connections to the site: if this value is set to "5" for example, only 5 Web users will be able to connect to your site at the same time.
      • The maximum number of connections per Web user: if this value is set to "5" for example, a Web user will be able to start your site up to 5 times.
      • The amount of idle time before user disconnection: this option is used to free all the resources occupied by the session of Web user if this one has performed no action since the specified duration.
    9. By default, your site is immediately enabled after setup. The users will have no access to your site if "Enable the site at the end of setup" is unchecked.
    10. The wizard proposes to perform:
      • an immediate setup: the files will be immediately transferred to the server and your site will be immediately installed.
      • a delayed setup: the files will be immediately transferred to the server but your site will be installed at the specified date and time ("Program the deployment for a later date" option).
    11. Go to the next step.
    12. The wizard allows you to define the parameters for site security: Change of IP, ... Go to the next step.
    13. The wizard proposes to automatically generate the statistical files for the site. These statistics affect for example the actions performed on the site, the origin of Web users, ...
      Keep the options proposed by default and go to the next step.
    14. Display the next screen and validate the setup. The setup wizard transfers the files.
During the file transfer, the wizard compresses and encrypts the transferred data. Your data is transferred with a high-security level.
At the end of setup, a link allows you to immediately start the site.
Correspondence between the directories of the development computer and the deployment
The distribution of site files is slightly different between the development and the deployment server. Let's see a summary of the distribution automatically proposed by WEBDEV.
Directory on the development computerDirectory on the deployment server
< Porject Name>\< Project Name>_WEB< site>\< site name>\< site name in uppercase>_WEB
< Project Name>\Exe For a site:
  • data files (.fic, .ndx, .mmo, .ftx): < data>\< site name>
  • other files: < site>\< site name>
For a Webservice:
  • data files (.fic, .ndx, .mmo, .ftx): < data>\< site name>
  • other files: < webservice>\< site name>
where
  • < site>, < data> and < webservice> are the directories defined when creating the hosting account (see above).
  • < site name> is the site name.
The distribution of files can be configured in the deployment wizard.
Previous LessonTable of contentsNext Lesson
Minimum version required
  • Version 23
Comments
Click [Add] to post a comment