How to Install WebSpace 4.8/5.0 or 6.

0 to Function Properly with iFIX

Prior to the installation the following will be necessary:

• WebSpace Installation media (DVD/ISO)

• iFIX Installation media (DVD/ISO)
• Operating System installation disk (necessary for the Microsoft Internet Information Services
components).
• A valid WebSpace License
• A valid iFIX 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 iFIX are as follows:

A. Install IFIX
B. Reboot
C. Install the latest IFIX SIMS
D. Reboot
E. Install Microsoft Internet Information Services (IIS)
F. Reboot
G. Install Proficy WebSpace
H. Reboot
I. Verify WebSpace Install
J. Validate client connection

A. Installation of IFIX
Before WebSpace itself can be installed, IFIX must be first installed on the system in question. It is
possible to install and run a project on a IFIX Server that is also running WebSpace, but it is not
recommended. Ideally, it is suggested to install IFIX (as a Server) on the WebSpace system, but to use it
more as a IFIX Viewer, and run the project remotely on another physical node. To install the software,
use the installation media for IFIX 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 IFIX Server. When the
installation process finishes then reboot the system to complete the installation.

1. Launch the InstallFrontEnd.exe from the HMI/SCADA - IFIX DVD/ISO

2. On the Front End choose to install “IFIX Server”
3. Go through the installation and let it complete

Allow iFIX and the WebSpace Server through the firewall, if the Windows firewall is enabled. Click Yes to
continue. The install will automatically configure the rest of these settings for you. If you are using a
different firewall, you will need to manually open the firewall for your iFIX WebSpace components.
Port Usage - When you install the iFIX WebSpace, and the firewall is enabled, the install automatically
prompts you to add the iFIX WebSpace to your exception list. The following port numbers are used by
the iFIX WebSpace:

Port 491 is the port on which the “iFIX WebSpace Server Application Publishing Service” listens on (for
both TCP and SSL).

Update the HOSTS file with the IP address and name of the iFIX SCADA Server, to ensure the highest
reliability for connectivity. You can find the HOSTS file in the C:\WINDOWS\system32\drivers\etc folder.

If the iFIX SCADA Server node name is different from the computer name that it was installed on, you
also need to add this name to the HOSTS file. The HOSTS file on the iFIX WebSpace Server should be
identical to the one on the iFIX SCADA Server

In the iFIX System Configuration (SCU) tool:

• Open the WEB.SCU file.

• Verify that Network Configuration is set to TCP/IP (Configure > Network), that SCADA is disabled
(Configure > SCADA), and that Workspace.exe appears in your tasks list (Configure > Tasks). By
default, these settings are automatically configured during install. If these settings are not
correct, update them now.
• Specify the name of your iFIX SCADA Server in the Remote Nodes list (Configure > Network).

Either copy your pictures from the SCADA Server to the PIC folder on the Dependent Application Server
(recommended for optimum performance), or map a drive to your PIC folder on your SCADA Server.

B. Reboot the system when complete

C. Installation of Latest IFIX SIMs

After the installation of IFIX is complete, it is necessary to install the latest IFIX SIM. After the
installation of IFIX, it is recommended to install the latest IFIX WORKSPACE GENERAL 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.

1. Download the latest SIM from the GE Support site

2. Install the SIM

D. Reboot when complete

E. 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:

1. Windows Server 2012/2016 Installation

When Microsoft Internet Information Server is installed on a Windows Server 2012/2016 system, it is
necessary to use the Sever Manager, and to run the Add Roles or Features Wizard. Here are the
steps to do it:
a. Navigate to the Windows “Control Panel->Administrative Tools->Server Manager”
b. When it opens, click on the “Add Roles and features” link
c. The Add Roles and Features Wizard will appear
d. Click the “Next” button
e. On the “Select Installation Type” dialog, choose “Role based or feature based installation”,
and click the “Next” button.
f. On the “Select Destination Server” dialog, choose the local server from the Server Pool
Computer and click on the “Next” button.
g. 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.
h. 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.
i. 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
.NET Extensibility 4.6
Application Initialization
ASP
ASP .NET 3.5
ASP .NET 4.5
ASP .NET 4.6
ISAPI Extensions
ISAPI Filters
Management Tools
IIS Management Console
 j. When done selecting the entries click on the “Next” button
k. Select the “Install” button.
l. When the software installation is complete, then close the dialog and reboot the computer

2. 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:

a. Navigate to the Windows Control Panel

b. Navigate to “Programs and Features” and click on it. The “Programs and Features” utility will
open.
c. From the “Programs and Features” window click on “Turn Windows Features on or off” link
on the left- hand side.
d. 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

e. 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.
F. After installation of the required options, reboot the computer

G. Installation of Proficy WebSpace

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

1. Launch the InstallFrontEnd.exe from the WebSpace installation DVD/ISO

2. From the menu choose to install Proficy WebSpace
3. Accept the license agreement when prompted
4. It is suggested to use the default installation location if possible, but this can be modified as
needed.
5. 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.
6. Let the installation finish

H. Reboot when complete

I. Verify 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.

1. Open Microsoft Internet Information Services (IIS) Manager (INETMGR)

2. On the left-hand pane of the IIS Manager, navigate to “COMPUTERNAME->Sites->Default Web
Site”.
3. 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.
4. It is advisable to confirm that the Proficy WebSpace Server service is running. This can be done
via the Windows Start menu by going to “Proficy WebSpace->Start Proficy WebSpace Server”.
5. 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”.

J. Validate Client Connection

These are the four methods to connect to WebSpace machine:

1. Web browser
2. Windows Desktop Client
3. iPad
4. Android device
1. Using a Web browser

The iFIX WebSpace ActiveX control is automatically installed the first time a user accesses the iFIX
WebSpace HTML page. To run the client, all you need to do is access the iFIX WebSpace Server
HTML page.

NOTE: If you want to change the options available when you run the iFIX WebSpace Embedded
ActiveX control, refer to the Command-line Options section below. To run the iFIX WebSpace
ActiveX control:

a. Start Internet Explorer.

b. In the URL box, type http:// followed by the iFIX WebSpace Server computer name (or IP
address) then /ProficyWebSpace and then iFIX.html.

For example:
http://iFIXWebSpaceServerName (or Ip address)/ProficyWebspace/iFIX.html

An installation message box appears the first time you log on to this page.

c. Click Install. Trust the digitally signed ActiveX control.

d. When the Logon dialog appears, type the following information:
• Your network user name in the User name field.
• Your network password in the Password field.
NOTE: Users are allowed three invalid logon attempts before the logon process shuts down.

To use a custom hyperlink command to open a web page:

• Open a web page in an editor.

• Choose the editor's Insert Hyperlink option.
• Enter the address of the host, followed by the desired hyperlink parameters. Refer to the
Summary of Command-line Options for a full list of available options. For example, to enable
loose mode instead of embedded mode, enter:
http://iFIXWebSpaceServerName/ProficyWebSpace/logon.html?embed=false

• Save the page.

2. Using the Windows Desktop Client

You can install the desktop client with the ifix-client.windows.exe installer provided on the iFIX
WebSpace Server computer in the folder where you publish the iFIX WebSpace files to be hosted by
your IIS or Apache server, or from the iFIX WebSpace install folder, which is the C:\Program
Files\Proficy\iFIX WebSpace\Web\Clients folder by default. You can also install it using the
AllClients.html web page and selecting the Windows Client option. To install the Windows Desktop
Client:

a. Obtain the ifix-client.windows.exe installer from the:

• iFIX WebSpace Server computer in the directory where you publish the iFIX WebSpace
files to be hosted by your IIS or Apache server.
 • iFIX DVD in the Setup\Proficy\WebSpace\WebSpaceServer subfolder.
• iFIX WebSpace install folder, which is by default the C:\Program Files\Proficy\iFIX
WebSpace\Web\Clients folder.
• The AllClients.html web page, which allows you to download and run the file on the
client computer.
b. Copy this file to the client computer.
c. Double-click ifix-client.windows.exe to start the install. The Welcome screen appears.
d. Click Next to continue. The License Agreement screen appears.
e. Select the "I accept the terms in the license agreement" and click Next to continue. The
Setup Type screen appears.
f. Select Complete (which includes the Desktop Client, as well as the Internet Explorer, and
Firefox plug-in), or Custom (to choose only the Desktop Client), and then click Next. The
Ready to Install screen appears.
g. Click Install. After a few moments, the Completion screen appears.
h. Click Finish.
i. Confirm that the Desktop Client short-cut appears on the Start menu (on the Start menu,
point to Programs > Proficy WebSpace Client > Proficy WebSpace Client).

To run the Windows Desktop Client:

a. On the Start menu, point to Programs > Proficy WebSpace Client > Proficy WebSpace Client.
The Desktop Client appears.
-Or-

Double-click the short-cut you created to start the Windows Desktop Client. The Desktop
Client appears.

b. Enter IP address or machine name of the WebSpace server

c. Select checkbox "Create desktop shortcut to this host"
d. Click on Connect
e. When the Logon dialog appears, type the following information:
• Your network user name in the User name field.
• Your network password in the Password field
f. The connection will fail because the shortcut needs to be configured with some switches
BUT there will be shortcut created on the desktop (its name will have IP address entered on
step 2)
g. Right-click on the shortcut and choose Properties
h. On the shortcut tab, go to the Target field and append the following switch:
-a iFIX
NOTE: ensure there is a space between the last character on the Target field and the above
switch
3. Using iPad

• The app can be downloaded by going to iTunes and searching for ProficySCADA or browse
for it in the Business category.
• See app’s requirement for supported iOS version
• Add a host with the following settings:
• IP Address = WebSpace machine’s IP
• User Name and Password of Windows user account
• Auto Zoom = ON
• Auto Launch = iFIX
• Port Number = 491
• For more details, see attached ProficyHMISCADAiPadApp_7-21-14.pdf

4. Using Android device

• The app can be downloaded by going to Google Play and searching for ProficySCADA
• See app’s requirement for supported Android version
• Add a host with the following settings:
• IP Address = WebSpace machine’s IP
• User Name and Password of Windows user account
• Auto Zoom = ON
• Auto Launch = iFIX
• Port Number = 491
• For more details, see attached Android Client User Guide_v3.pdf