PowerServer Mobile/Web installation

Prerequisites

Before you install PowerServer Mobile/Web make sure

  1. .NET Framework 4.x is successfully installed.

  2. IIS 7.5, 8.0, or 10 is correctly installed with necessary components.

    If you want to install Appeon File Server later, you will also need to install the components listed under IIS 6 Management Compatibility.

Installing .NET Framework 4.x

If you are using one of the latest versions of the Windows or Windows Server operating system, the .NET Framework might already be installed on your computer. Specifically, the .NET Framework 3.5.1 is included with Windows 7, the .NET Framework 4.5 is included with Windows 8/8.1 and Windows Server 2012, and the .NET Framework 4.6 is included with Windows 10 and Windows Server 2016. Appeon PowerServer 2019 requires .NET Framework 4.x to be installed.

  • If you are using Windows 7 or earlier version, you need to manually install .NET Framework 4.x. You can download and install .NET Framework 4.x from http://www.microsoft.com/en-us/download/details.aspx?id=17851.

  • If you are using Windows 8 or later, you need to enable the .NET Framework 4.x through Control Panel.

    Take Windows 8 for example.

    1. In Control Panel, click Programs > Turn on or off Windows features.

    2. In the Windows Features dialog box, select the .NET Framework 4.5 Advanced Services checkbox, and then expand the list and select the item ASP.NET 4.5.

      .NET Framework 4.5 Advanced Services

    3. Click OK to let Windows finish the installation and reboot the system.

Installing IIS 10 on Windows 10 or Windows Server 2016

IIS 10 is included with Windows 10 or Windows Server 2016, but it is not installed in Windows by default. You need to manually install it. Follow the instructions below and make sure that the following highlighted features are installed; these features are not selected to install by default, you will need to manually select them during the IIS installation.

  1. In Control Panel, click Programs > Turn on or off Windows features.

  2. In the Windows Features dialog box, select the check box of Internet Information Services, then expand the list and select the items listed under Application Development Features and under Common HTTP Features as shown in the figure below. Click OK. These features of IIS provide runtime support for PowerServer.

    Note: The aforementioned features are the necessary features for PowerServer. If you want to better manage your IIS or to install Appeon File Server, you should select the items listed under IIS 6 Management Compatibility.

    Windows features in Windows 10

  3. Click OK to let Windows finish the installation and reboot the system.

Installing IIS 8.0 on Windows 8

IIS 8.0 is included with Windows 8/8.1, but it is not installed on Windows 8/8.1 by default. You need to manually install it. Follow the instructions below and make sure that the following highlighted features are installed; these features are not selected to install by default, you will need to manually select them during the IIS installation.

  1. In Control Panel, click Programs > Turn on or off Windows features.

  2. In the Windows Features dialog box, select the check box of Internet Information Services, then expand the list and select the items listed under Application Development Features and under Common HTTP Features as shown in the figure below. Click OK. These features of IIS provide runtime support for PowerServer.

    Note: The aforementioned features are the necessary features for PowerServer. If you want to better manage your IIS or to install Appeon File Server, you should select the items listed under IIS 6 Management Compatibility.

    Windows features in Windows 8

  3. Click OK to let Windows finish the installation and reboot the system.

Installing IIS 8.0 on Windows Server 2012

IIS 8.0 is included with Windows Server 2012, but it is not installed on Windows Server 2012 by default. You need to manually install it. Follow the instructions below and make sure that the following highlighted features are installed; these features are not selected to install by default, you will need to manually select them during the IIS installation.

  1. In Control Panel, click Turn on or off Windows features to enter Add Roles and Features Wizard. Click Next until you enter the Server Roles page.

  2. In the Server Roles page, select the check box of Web Server (IIS) -> Web Server, then expand the list and select the items under the Application Development Features and under Common HTTP Features (as shown in the red boxes in the figure below). Click OK. These features of IIS provide runtime support for PowerServer.

    Windows features in Windows 2012

  3. Click OK to let Windows finish the installation and reboot the system.

Installing IIS 7.5 on Windows Server 2008 R2

IIS 7.5 is included with Windows Server 2008 R2, but it is not installed on Windows Server 2008 R2 by default. You need to manually install it. Follow the instructions below and make sure that the following highlighted features are installed; these features are not selected to install by default, you will need to manually select them during the IIS installation.

  1. Click Start, point to Administrative Tools and then click Server Manager. Click Roles under Server Manager, and the Roles Summary view is displayed.

    Server manager


  2. In Roles Summary, click Add Roles, and follow the instructions of the Add Roles Wizard.

  3. Select Web Server (IIS) in Select Server Roles, and click Next.

    Select Web Server (IIS)


  4. In the Select Role Services page, select the items listed under Common HTTP Features and Application Development (as shown in the red boxes in the figure below).

    Select Application Development features


  5. Since IIS depends on the Windows Process Activation Service (WAS) feature, the following informational dialog displays. Click Add Required Features to continue when the Add Roles Wizard notifies you on any required dependencies.

    Add Required Features


  6. Go through the installation with the wizard and reboot the system.

Installing IIS 7.5 on Windows 7

IIS 7.5 is included with Windows 7, but it is not installed on Windows 7 by default. You need to manually install it. Follow the instructions below and make sure that the following highlighted features are installed; these features are not selected to install by default, you will need to manually select them during the IIS installation.

  1. Click Start > Control Panel > Programs > Turn on or off Windows features.

  2. In the Windows Features dialog box, select the check box of Internet Information Services, then expand the list and select the items listed under Application Development Features and under Common HTTP Features (as shown in the red boxes marked with "1" and "2" in the figure below). Click OK. These features of IIS provide runtime support for PowerServer.

    Note: The features checked above are the necessary features for PowerServer. If you want to better manage your IIS or to install Appeon File Server, you can select the items listed under IIS 6 Management Compatibility (as shown in the red box marked with "3" in the figure below).

    Windows features


  3. Click OK to let Windows finish the installation and reboot the system.

Installation instructions

During the PowerServer installation, the setup program will automatically configure the .NET IIS server so PowerServer and IIS can work with each other. In very few cases, the automatic configuration may fail due to reasons such as environmental issues, user privileges, configuration changes etc., as a result PowerServer is not working properly. When this happens, you can go through the configurations in the section called “Install PowerServer to .NET IIS” in PowerServer Troubleshooting Guide to manually fix the problem.

32-bit or 64-bit PowerServer installers

Both 32-bit and 64-bit PowerServer installers are provided in the PowerBuilder Universal edition. The setup program will automatically check the operating system (32-bit or 64-bit), and then run the corresponding PowerServer installer (32-bit or 64-bit).

To install the 32-bit PowerServer to a 64-bit operating system, you will have to manually download and run the 32-bit PowerServer installer.

Step 1: Launch the PowerBuilder 2019 Setup program and select to install PowerServer (PB Edition) (see Starting the installation). Wait until PowerServer completes the preparation.

Step 2: Specify the IIS Web site where PowerServer will be installed and click Next.

PowerServer can be installed to an existing Web site or a new Web site. If you want to install PowerServer to a new Web site, create one by selecting the Create a new Web Site option and inputting the Web site description, TCP port, and home directory. The Description, TCP Port, and Home Directory of the new Web site cannot be the same as the existing Web site.

Setting

Instructions

Description

Type a name to be used as the new Web site name.

TCP Port

Type a port number to be used as the new Web site port.

Home Directory

Click Browse to specify a root path of the new Web site.


Step 3: Select whether to install the demo application and click Next.

Step 4: If you selected to install the demo application, specify the path for the SAP SQL Anywhere engine and click Next. Appeon demo application requires SQL Anywhere to run.

Notes: Depending on the version of PowerServer (32-bit or 64-bit), Setup lists all copies of SQL Anywhere engines of the corresponding version (32-bit or 64-bit) detected in your machine.

If you encounter the following message, Appeon recommends you click Yes to allow the setup program to enable the connection pooling in ODBC Data Source Administrator, this eliminates the likelihood of having any performance issues at runtime.

Detect connection pooling


Step 5: Specify the AEM login user name and password.

Step 6: Modify the settings for ASP.NET when necessary.

Select the Modify current ASP.NET settings checkbox and then modify the attribute values; or click Reset to restore the default values. These values are used to determine the maximum number of concurrent users that PowerServer can support, therefore, setting proper values can help improve the PowerServer performance. For detailed instructions, refer to the section called “Microsoft IIS server” in PowerServer Performance Tuning Guide.

Step 7: Check the summary of settings. Click Back to change any unwanted settings or click Next to have Setup begin copying files.

At the click of the Next button, the setup program begins copying files to your computer.

Step 8: Wait until the installation is complete.

If you have selected to install PowerServer as well as the other components (such as PowerServer Web Component, PowerServer Help etc.), the setup program will install PowerServer first, and then install the other components before it displays the setup complete screen (as described in the next step).

Step 9: Click Finish to complete the installation of PowerServer.

During the PowerServer installation, the AEM (installed to %powerserver%\AEM) and the PowerServer Web Component (installed to %powerserver%\weblibrary_ax) are automatically installed. %powerserver% indicates the PowerServer Mobile/Web installation directory, for example, C:\Inetpub\wwwroot\appeon.