Running on the Web

Install Windows Services

The Install Windows Services window is used to add and install one or more instances of each type of Windows service. The types of services that can be installed are EZWeb Server, Simple Client Server, AutoChart Scheduler, Inittab Emulation Server and PxPlus Web Server.

Access this window from the PxPlus IDE Main Launcher by expanding the Installation and Setup category and selecting Install Windows Services.

(The Install Windows Services window was added in PxPlus 2016.)

This window includes a drop box for selecting the type of service and a grid for defining the settings for the service. Grid side buttons provide functionality for installing/uninstalling a service, adding another service and removing a selected service. A print button is provided for viewing and printing a detailed listing of all the types of services.

The Install Windows Services window consists of the following:

Type of Service	Type of Windows service. Selections are EZWeb Server, Simple Client Server, AutoChart Scheduler, Inittab Emulation Server, and PxPlus Web Server. (Default: EZWeb Server)
Install	*(Available only when selecting an existing service in the grid where the Installed check box = No)* Displays a message that first asks if you want to install the selected service. Responding Yes installs the service. If the installation is successful, the Installed check box is selected automatically. A message confirms that the service has been installed, and the Install button changes to an Uninstall button for this service. Responding No to the install message does not install the service.
Uninstall	*(Available only when selecting an existing service in the grid where the Installed check box = Yes)* Displays a message that first asks if you want to uninstall the selected service. Responding Yes uninstalls the service. If the uninstall is successful, the Installed check box is deselected automatically. A message confirms that the service has been uninstalled, and the Uninstall button changes back to an Install button for this service. Responding No to the uninstall message does not uninstall the service.
Add	Creates a new row at the bottom of the grid for defining an additional service.
Remove	Deletes the selected service from the grid. Before an installed service can be removed, it must first be uninstalled with the Uninstall button. If all services for the selected service type are removed from the grid, including the default, and then you immediately exit the panel, the default service will display the next time Install Windows Services is invoked.
*The columns displayed in the grid vary depending on the Type of Service* selected, as explained below:**
Name of Service	Unique name for the service. Entering a duplicate name for any of the service types is not allowed. If a duplicate name is entered, a message will indicate that the name already exists. A default name is provided in the first row for each Type of Service selected (e.g. PxPlusEZWeb is the default service name for the EZWeb Server service type). When adding a new service, the default name displays as <New Service>. This default name must be changed to a unique name before you can edit the other settings for the new service, exit the panel or add a new service.
Installed	Indicates whether the selected service is installed. This check box is selected or deselected automatically when clicking the Install or Uninstall button. It cannot be changed manually by clicking directly on the check box.
Starting Directory	*(Not Applicable for PxPlus Web Server)* Directory used as the start-up directory for the service. Click the Browse button to locate the starting directory.
Port #	*(EZWeb Server and Simple Client Server Only)* TCP/IP Port number Default Port number for EZWeb Server without SSL Certificate: 80 (standard Web port for HTTP requests) Default Port number for EZWeb Server with SSL Certificate: 443 Default Port number for Simple Client Server: 4093 Port numbers cannot be duplicated. When adding a new service, the default Port number automatically increments by 1 until a unique number can be assigned to the new service. Attempting to manually change the Port number to a number already assigned to a service displays a "Port number is in use" message.
Start	Start-up option for the service. Selections are Manual and Automatic. (Default: Manual)
SSL Certificate	*(EZWeb Server and Simple Client Server Only)* Specify the pathname to the server's SSL Certificate file. Click the File Selection button to select an existing file. (The File Selection button was added in PxPlus 2017.) (The SSL Certificate column was added to the Simple Client Server grid in PxPlus 2018.)
Certificate Key	*(EZWeb Server and Simple Client Server Only - Available when an SSL Certificate is entered)* Option that is used to indicate the PEM file, which contains the certificate private key. Click the File Selection button to select an existing file. This is needed only if you have defined the security argument and have separate PEM files for the certificate and private key. Note: This column is disabled if no SSL Certificate has been entered or if a PFX Password has already been entered. (The Certificate Key column was added to the EZWeb Server and Simple Client Server grids in PxPlus 2019.)
PFX Password	*(EZWeb Server Only - Available when an SSL Certificate is entered)* Option that is used to indicate the PFX certificate password if a PFX certificate is defined for the security argument. This can be either blank or not defined to define an empty password. Note: This column is disabled if no SSL Certificate has been entered or if a Certificate Key has already been entered. (The PFX Password column was added to the EZWeb Server grid in PxPlus 2019.)
Reconnect Time (secs)	*(Simple Client Server Only)* Defines the time (in seconds) that the server will wait before attempting to reconnect in the event that the connection is dropped.
Forced Program	*(Simple Client Server Only)* Forced Lead program to be run by the host when the client connects. Click the File Selection button to select an existing file. (The File Selection button was added in PxPlus 2017.)
Security Options	*(Simple Client Server Only - Available when an SSL Certificate is entered)* Button that is used to display the TCP Options window to allow certain SSL protocols to be disabled or forced. These checkboxes are applicable only when an SSL Certificate has been entered. If anything other than All Protocols Supported (default behavior) is selected and saved, a check mark will display on the Security Options button. See PxPlus Simple Client-Server Interface. If desired, support for various protocols may be disabled by selecting the Disable Support for radio button and then selecting the protocols to be disallowed. Alternatively, the Force Support for Only radio button option allows only one selected protocol to be used. (The Security Options button was added to the Simple Client Server grid in PxPlus 2020.)

Note:
Once a service is installed, you cannot modify any of the settings for that service. To change a setting, you must first uninstall the service. The Security Options is still available for an installed service; however, all of the TCP Options displayed will be disabled.

Running on the Web

Note:
This column is disabled if no SSL Certificate has been entered or if a PFX Password has already been entered.

Note:
This column is disabled if no SSL Certificate has been entered or if a Certificate Key has already been entered.

Note:
Once a service is installed, you cannot modify any of the settings for that service. To change a setting, you must first uninstall the service. The Security Options is still available for an installed service; however, all of the TCP Options displayed will be disabled.

Running on the Web

Note: This column is disabled if no SSL Certificate has been entered or if a PFX Password has already been entered.

Note: This column is disabled if no SSL Certificate has been entered or if a Certificate Key has already been entered.

Note: Once a service is installed, you cannot modify any of the settings for that service. To change a setting, you must first uninstall the service. The Security Options is still available for an installed service; however, all of the TCP Options displayed will be disabled.

Note:
This column is disabled if no SSL Certificate has been entered or if a PFX Password has already been entered.

Note:
This column is disabled if no SSL Certificate has been entered or if a Certificate Key has already been entered.

Note:
Once a service is installed, you cannot modify any of the settings for that service. To change a setting, you must first uninstall the service. The Security Options is still available for an installed service; however, all of the TCP Options displayed will be disabled.