Using the Web Client > The CitectSCADA Web Client > Frequently Asked Questions > General considerations
General considerations

This section describes general considerations relating to the Web Client product.

Q. When I try to run a deployment in Internet Explorer, I get the following error: "Problems with this page might prevent it from being displayed properly...". What is the cause?

A. When you first try to run a deployment, Citect will attempt to download the client component (the .cab file) associated with that deployment if it is not already present on the local machine. If this download of the client component is triggered, and the currently signed in user does not have Windows local administrative rights on the client, then this alert message occurs.

The solution is to verify that the person who runs a deployment for the first time is a Windows local administrator on the client machine. Once the components have been downloaded, any user will be able to access and run the deployment. The alert message will not reoccur unless the .cab file is updated.

Q. I deployed a project from within CitectSCADA using the appropriate Citect.ini [WebServer] parameters, but the project does not appear in the list of deployments on the Web Server. A dialog informed me that the deployment was successful. What has happened?

A. This situation can occur if you make an error with the syntax for the [WebServer]DeployRoot parameter. If, for example, you use a curly bracket instead of a square bracket, (for example, "[WebServer}DeployRoot"), the compiler cannot read the parameter and deployment files are sent to the CitectSCADA project directory instead:

[User]\<Project Name>

The deployment is flagged as successful, but it cannot be located by the Web Server.

If you have deployed a project but it does not appear in the Web Server's list, check the location above for a subfolder called "Web Deploy". If such a folder exists, correct the syntax used in your Citect.ini file.

Q. I deleted a user from the list of users configured for access to the Web Server, but they can still log in. How do I deny them access?

A. Sometimes a user can connect to the Web Server even after their user account has been deleted. This can occur when the operating system does not immediately report the user deletion to the web server. The period between the deletion of a user and the restriction of access can be about a half an hour.

The solution is to deny access to the user before deleting them. That way, they cannot gain access. See the topic "Deleting a user account" in the Web Client section of the CitectSCADA Installation and Configuration Guide.

Q. When I try to run the Web Client component for the first time, I get a "System Settings Change" message instructing me to restart my computer. What do I do?

A. This message appears on computers that contain old versions of some system files necessary by the Web Client Control. If these files are used by another application during installation, this System Settings Change message appears. Click OK to restart your machine to allow the newer versions of the necessary files to be installed during system reboot. The alert message will not reoccur unless another application reloads the old files.

Q. One of the ActiveX Object's included in my project cannot locate its associated data source. Where is it?

A. If an ActiveX object has an associated data source, you need to verify the data source can be located by the computer hosting the Web Client. See the topic Managing associated data sources for details.

Q. Why does a pop-up saying "Client control (CitectSCADAWebClient_7_0_xxx.cab) is not in the option list!" when I try to edit my deployment from the Web Client Deployment Configuration Page?

There are two possible reasons for this dialog:

  1. You might have set the [Web Server] parameter WebClientControl incorrectly. The Web page might not recognize the name or version of the .cab file. also check that you've used a forward slash in front of the cab file name, as this is necessary for the Web Server to locate the correct file.
  2. A user might have deleted the necessary .cab file from C:Program Files\Citect\CitectSCADA 7.10\WebServer\client\700(or the specified location). Therefore, the Web page cannot find it.

Q. The Process Analyst interface normally displays in a foreign language as I translated the language resource DLL, but it displays in English on the Web Client platform. How do I correct this?

A. A Process Analyst control running inside a CitectSCADA Web Client supports runtime language switching, but you need to configure which languages the Web Client will download to the client machine.

To configure the languages to download:

  1. Create a zip file in the C:\Program Files\Citect\CitectSCADA 7.10\WebServer\client\700 folder called bin.zip.
  2. Add to the zip file the language resource DLL files that you want the client to download and use. (You can find these files in your \Program Files\Common Files\Citect folder.)
  3. Note: The bin.zip file and its contents are not version-checked. This means you need to manually remove the bin.zip from the Web Client machines if your server contains a more recent bin.zip file. To do this:

    1. Find the installation directory of the Analyst.dll file on your Web Client machines and look for a file called bin.zip in this directory.
    2. Delete this file.
    3. Reconnect to the Web server to download the latest bin.zip file.

Q. I have keyboard shortcuts configured in my CitectSCADA project, but they do not work properly when the project is deployed in the Web Client. What's wrong?

A. Keyboard shortcuts configured for Internet Explorer (IE) take precedence over keyboard shortcuts configured within your CitectSCADA projects. For example, the Example project has F11 assigned to call up Help on a selected animation point on a graphics page. If the project is run as a Web Client deployment, F11 will toggle the view to full screen, as is the case normally with IE.

This is a limitation of using Internet Explorer to host CitectSCADA projects. The easiest solution is to return to the CitectSCADA configuration environment and assign your shortcuts so that no clashes occur. See the Internet Explorer Help for details of preconfigured keyboard shortcuts.

Q. I can't print from the Web Client. Why not?

A. You can print from the Web Client, but not by using your browser's File | Print command. Instead, in your CitectSCADA project, create a Print control that uses the Cicode WinPrint() function to print the page you want.

Q. The new page that I added to my CitectSCADA project does not appear in the Page Select list or the default menu page in the Web Client. How can I correct this?

A: If the page you added to your CitectSCADA project does not appear in Web Client, you can manually type in the page name in the Page Select list to view this new page. In this version of the Web Client, the new page is not added to the default menu page.

Q. How does the Web Client deal with ActiveX controls (for example, CiMeterX.ocx) and user files (Recipes.dbf, for example) that are necessary by a user project?

A. If your user project requires files such as these, you need to create special zip files to contain them. Create an ActiveX.zip file to contain the ActiveX files necessary by your project, and a Misc.zip file to contain other files that your project needs; for example, recipes.dbf, Chinese.dbf, Japan.dbf, and so on. Add these files under the main project path (for example, [User]\Example).

Note: You can have subfolders within the zip files, but your project needs to be configured to use the same relative path structure.

During compilation, any zip files that contain supporting files necessary by a CitectSCADA project are copied to the Webdeploy subfolder. During startup, the Web Client will check the timestamp of any zip files to determine if the zip files have been updated; if the files have been updated, the zip files will be downloaded.

Q. My project was created using CitectFacilities and incorporates the Citect TimeScheduler. The TimeScheduler is not working when I run the project on the Web Client. What's wrong?

A. If you want to run the Time Scheduler on a CitectSCADA Web Client, you need to verify that the user profile you log in with has appropriate network access to the configuration tool, and the location of the configuration files. The user needs to be able to execute the configuration tool, and write to the configuration files.

Q. The Web Client Deployment Page displays incorrectly on Windows 2000 Advanced Server. 'Show Server Details' is missing, and the icons for Start client, Delete Deployment and Edit Deployment are also missing. What is wrong?

A. This appears to be caused by Windows Automatic Update installing several components at the same time after a fresh install of the operating system. Even though Internet Explorer might have been upgraded to the latest version (for example, 6.0.2800.1106) it might still behave as a version 5 browser; for example, it offers limited support for "iframes". If you call up About Internet Explorer from the Help menu, and a Version 5-style dialog appears with a version 6 release number, then your computer is affected in this way.

A complete uninstall/reinstall of Internet Explorer will correct the problem.

Q. When I launch the web server, the login form prompts me for a user name and password. When I enter the valid local administrator user name and password the HTTP 500 Internal server error message pops up saying that the page cannot be displayed. What is wrong?

A. The problem is caused by the fact that the computer was in an invalid state in the way that it lost its trust relationship with the domain controller. Removing the computer and re-adding it to the domain will correct the problem. To do so perform the following steps:

  1. Open the Computer properties dialog. (WinKey + Pause/Break).
  2. On the Computer Name tab click Change Enable workgroup and enter any string, such as "Test".
  3. Click Ok and enter the credentials, Apply (no need to restart at this point) Click Change again, Enable domain and enter "Citect.com".
  4. Click Ok, enter the credentials, click OK to reboot.

Q. When I start the control client from a web client the Internet Explorer information bar displays telling me that it has blocked the running of scripts or ActiveX controls.

A. One of the reasons for this issue is Internet Explorer security preventing the download of any ActiveX controls. To resolve this issue, add the web site to the list of trusted sites under Tools -> Internet Options -> Security