Website Procedures

This section provides additional procedures related to websites configuration.

Install Application Request Routing (ARR)
  • You have the prerequisite Application Request Routing (ARR) available on the Desigo CC software distribution.
  1. Copy the Gms.ARRInstaller.exe file from the
    ….\InstallFiles\EM\Installer\Prerequisites\Application Request Routing to the desired location on the third-party (target) machine.
  1. Go to the location where you have copied the Gms.ARRInstaller.exe file, right click and select the Run as administrator option to install the prerequisite Application Request Routing on the third-party machine.
  • The prerequisite Application Request Routing (ARR) is installed successfully.

 

Verify Existing ARR Installation

Perform the following procedure to verify the existing ARR installation.

  1. Open IIS Manager in one of the following ways:
  • From the Windows Start menu, type inetmgr in the Search Programs and files field. Press ENTER.
  • Select Control Panel > Administrative Tools > Internet Information Services (IIS) Manager.
  • The IIS Manager window opens.
  1. In the IIS Manager window, verify if Application Request Routing Cache is present. Otherwise, re-run the Gms.InstallerSetup.exe file that installs the prerequisite ARR.

 

Enable Proxy for the Application Request Routing (ARR) Cache in IIS
  • Application Request Routing (ARR) is installed on your system.
  1. To open IIS Manager, do any of the following:
  • From Windows Start menu, enter inetmgr in the Search Programs and files field. Press ENTER.
  • Select Control Panel > Administrative Tools > Internet Information Services (IIS) Manager.
  • The IIS Manager window opens.
  1. In the IIS Manager window, double-click Application Request Routing Cache.
  • The Application Request Routing (ARR) Cache page displays.
  1. Click Server Proxy Settings in the Actions pane.
  1. In the ARR page for proxy settings, select the Enable proxy check box.
  1. Click Apply in the Actions pane.
  • The proxy settings that you have just entered are applied and saved.
  1. In the Connections pane of the IIS Manager window, select the root node (http://local host/) and click Restart in the Actions pane to restart IIS.
  1. Now, launch the SMC.
  1. Create website and web application linked to a project.
  1. Browse the website and web application URL and launch the Windows App client.
Create an IIS User and Assigning it to the IIS_IUSRS Group

For detailed information, see Microsoft help.

  1. Run Computer Management from the Start menu.
  1. From Local Users and Groups and in the context menu, select New User and do the following:
    a. Enter a user name. For example, GmsIISUser.
    b.     Enter a full name.
    c. Enter and confirm the password.
    d. Select Password never expires if appropriate for the requested IT security.
    e. Click Create.
  1. Once the user account is visible in the Users folder, assign the GmsIISUser to the IIS_IUSRS group by performing the following steps:
    a. From Groups folder, select IIS_IUSRS group and right-click to open a menu.
    Click Add to Group to open the IIS_IUSRS Properties dialog box.
    b. Click Add to open Select Users, Computers, Service Accounts, or Groups dialog box.
    c. Enter the created IIS user name.
    d. Click Check Names and check if the correct user was found.
    e. Click OK and close the IIS_IUSRS Properties dialog box.
  1. Verify that the GmsIISUser is added to the IIS_IUSRS group.

 

Remove the Default IIS Website in IIS Manager

When you install and configure IIS, a default website is created. It uses the default ports (HTTP and HTTPS).

NOTICE

Corruption of other Products

Do not delete the default website created by IIS if other products are installed on the same system where you have installed IIS.
This is because these products use the default website, such as VMS, and deleting the default IIS website may corrupt them.
You must create a new website on different port.

You cannot use the SMC to delete websites that are created by other applications. You must delete the third-party or default website using Microsoft Internet Information Services (IIS) Manager.

  1. To open IIS Manager, do one of the following:
  • From the Windows Start menu, type inetmgr in the Search Programs and files field. Click ENTER.
  • Select Control Panel > Administrative Tools > Internet Information Services (IIS) Manager.
  • The IIS Manager window opens.
  1. Expand the Web Server computer node, and the Sites folder.
  1. Select the Default Website and right-click, and then select Remove.
  1. Click Yes.
  1. Close the IIS Manager window.

 

Upgrade a Website

You need to upgrade a website when you upgrade a management station or an extension.

  • The website status indicates Outdated (in red).
  1. In the SMC tree, select Websites > [website].
  1. Click Upgrade .
  1. Click OK.
  • A message displays.
  1. Click OK.
  • The selected website is upgraded.

 

Stop a Website
  • At least one website is available under Websites and it is started.
  1. In the SMC tree, select Websites > [website].
  1. Click Stop .
  • A confirmation message displays.
  1. Click OK to stop the started website.
  • The selected website is stopped.

 

Delete a Website
  • At least one website is available under Websites and is Stopped.
  • No web application is available under the website that you are about to delete.
  1. In the SMC tree, select Websites > [website].
  1. Click Delete .
  1. Click OK.
    NOTE: A third-party website (a website not created using the SMC) cannot be deleted using the SMC.
  • If confirmed, the selected website is deleted from the Websites tree in the Console, from the disk location at the path specified when the website was created, and from IIS.

 

Modify the Website Parameters

Use this procedure to modify the website parameters, such as website certificate, port numbers and so on. For example, if a website certificate gets deleted from the Windows Certificate store after creating the website, the certificate displays in red, when you select that website. In this case you must edit the website and select another website certificate and then save it.

You can also use this procedure to modify third-party website parameters.

  • At least one website is available under Websites and it is stopped.
  1. In the SMC tree, select Websites > [website].
  1. Click Edit .
  1. You can edit the following fields:
  • Host name: Provide the full computer name, DNS name, or IP address of the web server (IIS) system. The Host name must be reachable from the Windows App client.
  • Browse and select another certificate using the Select Certificate dialog box. You can select a certificate only from the Personal tab of the store location Local machine certificates.
  • User by browsing for it using the Select User dialog box and provide the Password for the selected user.
    Ensure that the website user's password is updated to the most recent password.
    For example, if you changed the website user's password from Windows or if the domain user’s password has expired, you must update the most recent password in the SMC and save the settings.
  • Edit the default port numbers for the http and https ports according to the given range.
  1. Click Save .
    NOTE: If the website certificate is modified, a message displays indicating that you must sign all the child web applications.

 

Modify the Website Parameters

Use this procedure to modify the website parameters, such as website certificate, port number and so on. For example, if a website certificate gets deleted from the Windows Certificate store after creating the website, the certificate displays in red, when you select that website. In this case you must edit the website and select another website certificate and then save it.

You can also use this procedure to modify third-party website parameters.

  • At least one website is available under Websites and it is stopped.
  1. In the SMC tree, select Websites > [website].
  1. Click Edit .
  1. You can edit the following fields:
  • Host name: Provide the full computer name, DNS name, or IP address of the web server (IIS) system. The Host name must be reachable from the Windows App client.
  • Browse and select another certificate using the Select Certificate dialog box. You can select a certificate only from the Personal tab of the store location Local machine certificates.
  • User by browsing for it using the Select User dialog box and enter the password for the selected user.
    Ensure that the website user's password is updated to the most recent password.
    For example, if you changed the website user's password from Windows or if the domain user’s password has expired, you must update the most recent password in the SMC and save the settings.
  • Edit the default port number for the https ports according to the given range.
  1. Click Save .
  • If the website certificate is modified, a message displays indicating that you must sign all the child web applications.
  1. Click OK.
  • The website modifications are saved.

 

Save a Website
  1. Click Save .
  • A message displays if any of the following is true:
  • A website already exists.
  • Http and https ports already exist and are in use. Other websites might be using them.
  • The website user is not a member of IIS_IUSRS Group.
  • The password does not match the selected user's password.
  1. Click OK.
  1. Click Edit to edit the website details.
  1. Click Save .
  • The website is saved. On successful saving, the website URL displays with the specified port numbers for HTTPs in the format:
    https://[Host name]:[HTTPS port number]/name].

 

Start a Website
  • At least one site is available under Websites and it is stopped.
  1. In the SMC tree, select the Websites > [website].
  1. Click Start Website .
  • The website starts.

Tips

  • When you create a website, it is started by default.
  • Multiple websites can be started, each website on a different port.
  • After re-starting the Desigo CC server, all the websites started in the SMC remain in the Started status and all the stopped websites remain in the Stopped status.
  • If the website hosting a web application is stopped, the web application page does not display and an error message displays.
  • You cannot start a website that has the same port numbers as that of the another website that is started.