PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
New WEBDEV 24 feature!
  • 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 HTTP
  • 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 are using a Linux server, see the documentation about the WEBDEV application server for Linux.
Several methods can be used to deploy a WEBDEV site (in Session mode or in AWP mode):
  • 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 HTTP or FTP).
  • Remote deployment from a management computer (by HTTP or 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,
  • A WEBDEV application server (a 10-connection version is supplied with WEBDEV).
Note: If a remote setup is performed by FTP, an FTP server must also be installed on the server.
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 WEBDEV 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 HTTP).

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 HTTP.
Installing and configuring the "WEBDEV Application Server - 10 Connections"
The setup program of "WEBDEV Application Server - 10 Connections" is available:
  • for download on the https://www.windev.com/ts/download/index.html site (click the most recent version of "WEBDEV 24 Application Server" and choose the "10 connections" package).
  • in the WEBDEV setup package: start "Menu.exe" and select "WEBDEV Server - 10 connections Setup".

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:\WEBDEV 24" 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 there is an earlier version of WEBDEV application server in the same computer, the wizard allows:
    • defining the management of sites and webservices of earlier versions. Keep the option "Keep the sites in earlier versions" and go to the next step.
    • importing WEBDEV accounts. Keep the option "Do not import existing accounts" 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 SaaS for more details. Validate this step.
  7. The next step allows defining the need for a secure connection to access all administration sites.
  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. The option "Display the user guide (pdf)" is used to automatically display this file at the end of setup. 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 also be accessible via the "Start" menu.

Configuration via the Hosting Control Center

The Hosting Control Center is a tool designed to automatically configure the following elements:
  • Application Server,
  • Web server (IIS),
  • FTP server (IIS). The configuration of FTP server is required to a setup via FTP only.
  • 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 the 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.
      A good practice for running sites consists in using the "IIS_IUSRS" group (on Windows versions where it exists).
      This account must be specified when deploying the site by HTTP.
    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.
    Note: If not already done, the Hosting Control Center proposes to define a management group. In this example, answer "Yes" to the question "Do you want to continue without this group?".
  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. This step specifies whether FTP access and deployment should be allowed for the user. In our case, this option is not necessary because we will perform an HTTP deployment. 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 (DVD-ROM, etc.). 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 operates in Windows only.
  • Remote deployment from the development computer (by HTTP or FTP). We are going to deploy our site according to this method by HTTP.
    Note: the setup via FTP requires an FTP server.
  • Remote deployment from a management computer (by HTTP or FTP) via a "deployment package". This deployment mode operates like the direct remote deployment. 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 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 now study the deployment by HTTP.

A detailed example: deployment by HTTP

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. Display the WEBDEV home page if necessary (Ctrl + <).
    2. In the home page, 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, in the WEBDEV home page, click "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. The wizard starts. In the "Site creation and deployment" step, select "Generate and deploy site". Go to the next wizard 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 HTTP:
    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 system User account: this account corresponds to the Windows account of the WEB server that will install the WEBDEV site (this account has been selected and defined in the Hosting Control Center).

        Note

        Caution: the user name can be preceded by the domain name to avoid confusions. For example: "mycomputer\test" or "mydomain\test"
    3. Once you have entered the information of your WEBDEV account and your system User account, 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 to update, number of files to delete, etc.). To get the details of the operations and modify them if necessary, click"Edit the list of files".
    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. The wizard proposes to select the deployment mode:
      • Deploy without disconnecting users. This option allows you to update the site without disconnecting the users.
        Caution: If this mode is selected, it will no longer be possible to choose the mode "Deploy by disconnecting users" for the site. See the online help for more details.
      • Deploy by disconnecting users. If this option is selected, connected users will be automatically disconnected to update the site.
      Select "Deploy by disconnecting users" and go to the next step.
    9. 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.
    10. 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.
    11. 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 ("Schedule the deployment for a later date").
    12. Go to the next step.
    13. The wizard allows you to define the parameters for site security: Change of IP, ... Go to the next step.
    14. 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.
    15. Validate the setup (green button at the bottom of wizard). 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
<Project 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 name of site.
The distribution of files can be configured in the deployment wizard.
Previous LessonTable of contentsNext Lesson
Minimum version required
  • Version 24
Comments
Click [Add] to post a comment