CIM_HT031 How to Install WebSpace with CIMPLICITY v4.

0
GE HMI/SCADA - CIMPLICITY

Outline
This document walks through the minimal configuration steps needed to get Proficy WebSpace 4.8 to
work with CIMPLICITY.

Configuring WebSpace with CIMPLICITY

The following steps outline what is necessary to get WebSpace functional with CIMPLICITY using Microsoft
Internet Information Services (IIS).

Prior to installation the following will be necessary:

o WebSpace 4.8.259 Installation media (downloadable from the GE Support site)

https://digitalsupport.ge.com/communities/en_US/Download/ProficyWebSpace-v4-8-259-
English

Note: It is highly recommended to use the WebSpace 4.8.259 build as opposed to the WebSpace
4.8 build as it does not support the Compatibility Updates.

o CIMPLICITY Installation media (DVD/ISO)

o Operating System installation disk (necessary for the Microsoft Internet Information Services
components).
o A valid WebSpace 4.8 License
o A valid CIMPLICITY License

Note: The following steps must be done in the order in which they are listed. Skipping any steps may
cause WebSpace to fail to install properly on the system.

Installation Outline
The minimal steps that will be necessary to Install WebSpace with CIMPLICITY are as follows:

i. Install CIMPLICITY
ii. Reboot
iii. Install the latest CIMPLICITY SIM
iv. Reboot
v. Install Microsoft Internet Information Services (IIS)
vi. Reboot
vii. Install Proficy WebSpace 4.8.259
viii. Reboot

1
 ix. Install the latest Proficy WebSpace Compatibility Update

1. Installation of CIMPLICITY

Before WebSpace itself can be installed, CIMPLICITY must be first installed on the system in question. It is
possible to install and run a project on a CIMPLICITY Server that is also running WebSpace, but it is not
recommended. Ideally, it is suggested to install CIMPLICITY (as a Server) on the WebSpace system, but to
use it more as a CIMPLICITY Viewer, and run the project remotely on another physical node. To install the
software, use the installation media for CIMPLICITY and ensure to install it while running as a Local
Administrator account. When given the option on the installation splash screen, choose to install as a
CIMPLICITY Server. When the installation process finishes then reboot the system to complete the
installation.

i. Launch the InstallFrontEnd.exe from the HMI/SCADA - CIMPLICITY DVD/ISO

ii. On the Front End choose to install a “CIMPLICITY Server”
iii. Go through the installation and let it complete
iv. Reboot the system when complete

2. Installation of Latest CIMPLICITY SIM

After the installation of CIMPLICITY is complete, it is necessary to install the latest CIMPLICITY SIM. If
intending to use CIMPLICITY 8.2, then a minimum of CIMPLICITY 8.2 SIM 24 must be installed. After the
installation of CIMPLICITY, it is recommended to install the latest CIMPLICITY SIM. To do this, please
download it from the GE website and run the installer. Again, make sure that the installation is run as a
Local System Administrator account.

i. Download the latest SIM from the GE Support site

ii. Install the SIM
iii. Reboot when complete

3. Installation of Microsoft Internet Information Server/Components

Before WebSpace can be installed on the host system, it is necessary to install Microsoft IIS with the
necessary components. The following steps outline the installation of these components and IIS:

a. Windows 2012 R2 Installation

When installing Microsoft Internet Information Server on a Windows 2012 R2 system, it is

necessary to use the Computer Manager, and to run the Add Roles or Features Wizard. Using the
Computer Manager select the Server Roles tab.

i. Navigate to the Windows “Control Panel->Administrative Tools->Server Manager”

ii. When it opens click on the “Add Roles and features” link
iii. The Add Roles and Features Wizard will appear
iv. Click the “Next” button
v. On the “Select Installation Type” dialog, choose “Role based or feature based
installation”, and click the “Next” button.
vi. On the “Select Destination Server” dialog, choose the local server and click on the
“Next” button.

2
 vii. On the “Select Server Roles” dialog choose “Web Server (IIS)”. If a dialog comes up
asking to “add Feature required for Web Server (IIS)”, click on the “Add Features”
button.
viii. On the left hand pane, there should be an entry that appears called “Web Server Role
(IIS)”. Select “Web Server Role (IIS)->Role Services” from the list.
ix. Choose the following Role Services as per the list below:

Web Server (IIS)

Web Server
Common HTTP Features
Default Document
Directory Browsing
HTTP Errors
Static Content
HTTP Redirection
Health And Diagnostics
HTTP Logging
Request Monitor
Performance
Static Content Compression
Security
Request Filtering
Basic Authentication
Application Development
.NET Extensibility 3.5
.NET Extensibility 4.5
Application Initialization
ASP
ASP .NET 3.5
ASP .NET 4.5
ISAPI Extensions
ISAPI Filters
Management Tools
IIS Management Console

x. When done selecting the entries click on the “Next” button

xi. Select the “Install” button.
xii. When the software installation is complete, then close the dialog and reboot the
computer

b. Windows 7 Installation

When installing on a Windows 7/Windows 2008 operating system, the Microsoft IIS features can be
installed via the “Programs and Features” utility located in the Windows Control Panel. In order to get
to this utility please do the following:

3
 i. Navigate to the Windows Control Panel
ii. Navigate to “Programs and Features” and click on it. The “Programs and Features” utility
will open.
iii. From the “Programs and Features” window click on “Turn Windows Features on or off”
link on the left-hand side.
iv. A dialog will appear on which the following options must be selected:

Internet Information Services

Web Management Tools
IIS Management Console
World Wide Web Services
Application Development Features
.NET Extensibility
ASP
ASP .NET
ISAPI Extensions
ISAPI Filters
Common HTTP Features
Default Document
Directory Browsing
HTTP Errors
HTTP Redirection
Static Content
Health And Diagnostics
HTTP Logging
Request Monitor
Performance Features
Static Content Compression
Security
Request Filtering
Basic Authentication

v. Select the required options and click on the “OK” button. This will cause Windows to
install the required components.

Note: It may prompt you for the Operating System media when doing this so it is
recommended to have that available if needed.

vi. After the required options are installed, then reboot the computer.

4. Install Proficy WebSpace 4.8.259

The next step is to install Proficy WebSpace 4.8.259 on the computer. Launch the Proficy WebSpace
installer, and choose to install the WebSpace server on the system. When installing, make sure that the
installer is run by a Local System Administrator on the computer.

i. Launch the InstallFrontEnd.exe from the WebSpace installation media

4
ii. From the menu choose to install Proficy WebSpace

Figure 1 – The Proficy WebSpace 4.8 Installation menu.

iii. Accept the license agreement when prompted

iv. It is suggested to use the default installation location if possible, but this can be modified as
needed.
v. When prompted for a Logon, please leave the user name and password fields blank. This will
set the “ProficyWebSpaceAppPool” application pool in IIS to run under the provided
account/identity.

Figure 2 – The WebSpace logon credentials prompt dialog.

vi. Let the installation finish, and then reboot when complete.

5
5. Install Required WebSpace Compatibility Updates

Note: To install the required updates for WebSpace 4.8.259 the CIMPLICITY software on the WebSpace
server must be configured with the following CIMPLICITY SIM’s
a. CIMPLICITY 8.2 SIM 47 or newer,
b. CIMPLICITY 9.0 SIM 19 or newer,
c. CIMPLICITY 9.5 SIM 4 or newer.
The server must have WebSpace 4.8.259 installed on it before applying these updates.

i. Download the WebSpace "ProficyWebSpace-v4-8-259-English" update from the following link:

https://digitalsupport.ge.com/communities/en_US/Download/ProficyWebSpace-v4-8-259-
English”.

Right-click on the file and select “Run as Administrator” to begin the installation. Select “Install
Proficy WebSpace v4.8” from the installation window and select the default prompts that may be
required through the configuration process.
ii. Download the proper WebSpace Compatibility Update 5 update file from the following link:

PWS48_CompatibilityUpdate_005_x64 (64 bit Operating System) -

https://digitalsupport.ge.com/communities/en_US/Download/PWS48-CompatibilityUpdate-005-
x64

PWS48_CompatibilityUpdate_005_x86 (32 bit Operating System) -

https://digitalsupport.ge.com/communities/en_US/Download/PWS48-CompatibilityUpdate-005-
x86

Right-click on the downloaded file and select “Extract All” to extract the file. Right-click on the
“PWS_48_CompatibilityUpdate_005_*.exe” file and select “Run as Administrator” to begin the
installation. Select the any default prompts that may be required through the configuration
process.
Let the installation finish and then re-boot the WebSpace server when complete.

6. Verifying WebSpace is Registered Properly

When WebSpace is properly installed on the system, then it inserts a new website into the Microsoft IIS
configuration called “ProficyWebSpace”. To confirm if this is set up properly please do the following.

i. Open Microsoft Internet Information Services (IIS) Manager

ii. On the left-hand pane of the IIS Manager, navigate to “COMPUTERNAME->Sites->Default
Web Site”.
iii. Underneath the default website should be another site called “ProficyWebSpace”. If this is
visible, then the Proficy WebSpace installation has occurred properly and it is available to be
used.

6
 Figure 3 – The ProficyWebSpace website in IIS.

iv. It is advisable to confirm that the Proficy WebSpace service is running. This can be done via
the Windows Start menu by going to “Proficy WebSpace->Start Proficy WebSpace Server”.
v. It is a good idea to also open the Proficy WebSpace administrator and confirm it is able to
connect to the running WebSpace instance. This can be done via the Start menu in the
“Proficy WebSpace->Tools->Proficy WebSpace Administrator”.

7. Creating the Web Page via CIMPLICITY Options

The next step is to create the web page that will be used to display the CIMPLICITY CimView screen. This is
done via the following steps:

i. Open CIMPLICITY Options

ii. Navigate to the “Proficy WebSpace” tab
iii. Click on the “Create Web Page” button

7
 Figure 4 – The CIMPLICITY Options Proficy WebSpace tab.

Figure 5 – The Create Web Page dialog in CIMPLICITY Options.

iv. On the dialog that opens click on the “Browse Screen” button and select the CimView screen
that you want to publish to WebSpace
v. Next select the “Browse Page” button and on the dialog that opens (which should open to
C:\Program Files\Proficy\Proficy WebSpace\Web by default) type in the file name (i.e.
myscreen.html).

8
 vi. Click the “Save” button when complete
vii. Click “OK” on the Create Web Page dialog when done
viii. At this point the configuration of everything should be complete.

8. Validating a Client Connection

The last step is to confirm that a Web Browser from a remote node is able to connect to the Proficy
WebSpace server and is able to View the screen.

Note: Prior to executing these steps, please ensure that the “CIMPLICITY Project” or the “VIEWER”
Process is running on the WebSpace node.

i. On a node other than the Proficy WebSpace host system, open up a Web Browser using a local
system administrator account.

Note: It is recommended that the first time that you connect to the WebSpace host that a local
system Administrator is used to launch the browser. This is due to the fact that it must install a
set of ActiveX controls and/or plugins and a user account that has privileges to install it is
needed. Once the installation is complete it will no longer be necessary to run the web browser
as an Administrator.

ii. In the Web Browser type in the following:

http://host/ProficyWebSpace/filename.html

host = the name of the computer that WebSpace is running on.

ProficyWebSpace = the registered web site name in the IIS Manager.
filename.html = the filename of the html file created via CIMPLICITY Options in Step 6
(previously).

iii. The user will be prompted to install the ActiveX control/plugin. Choose to agree when prompted.
iv. When the installation of the control is done, it may ask you to restart your browser. If it does ask
to restart the browser, then do so, and again attempt to reconnect to the same URL.
v. Once connected, you will be prompted for a username/password. Enter in a valid user name and
password for a Windows user that exists on the Proficy WebSpace computer.
vi. Once the user is logged in then it should display the CimView session with the specified screen
requested.