Prev Next

Pro Cloud Server Configuration Client - Web

As an alternative to the Pro Cloud Server Configuration Application, the Pro Cloud Server also includes a Web Based Configuration Client "WebConfig".

WebConfig Server Requirements

To setup the WebConfig Client you require the following:

  • A Web Server (Apache or IIS) capable of hosting PHP v7.0 (or later)
  • A Web Server with these standard PHP extensions installed and enabled: core, curl, date, gettext, hash, json, libxml, mbstring, pcre, session, standard and tokenizer
  • A Web Server with PHP sessions enabled
  • Communication between the web server and the server hosting the Pro Cloud Server
  • A base folder (on the web server) to store the WebConfig website pages

Note, these requirements are the same as for hosting WebEA. The WebConfig, could be deployed on the same Web Server as WebEA.

Configuration Steps

Step

Description

See also

1

If you have not already, install the Pro Cloud Server by following the steps outlined in the Pro Cloud Server Installation topic, making sure that the WebConfig component is installed.

After installation you should find the WebConfig website files in the Installation directory (e.g. C:\Program Files (x86)\Sparx Systems\Pro Cloud Server\WebConfig). These files make up the "WebConfig" website/client, and need to be hosted on a web server. In the simplest configuration the web server would be installed on the same machine as the Pro Cloud Server.

Pro Cloud Server Installation

2

Download/install and configure your web server for PHP, according to your requirements.

Tip: XAMPP is the most common Apache/PHP web server that includes all the required components; it is available for Windows/Linux and OS X at https://www.apachefriends.org/download.html.

Note: The WebConfig only requires the minimum XAMPP installation, Apache and PHP; it does not require MySQL, FileZilla Mercury, Tomcat or any of the other optional components, so if you have no need for these components Sparx Systems would recommend to not install them.

3

Define and configure a website for the WebConfig in your web server.

As there are many different web servers and configurations, configuring the web site, deciding what port the web server will listen to, and making sure the website is secure from external attacks, are all outside the scope of this documentation.

Tip: Using the default XAMPP configuration, the port for the default website is 80 and the base folder is at 'C:\xampp\htdocs'. XAMPP will already have added files to this folder; The WebConfig does not require these files, so if you have no need for them, move them to a backup location.

4

Copy the WebConfig folder from the Pro Cloud Installation (e.g. C:\Program Files (x86)\Sparx Systems\Pro Cloud Server\WebConfig) to an appropriate location on the web server (e.g. C:\xampp\htdocs).

5

Within the WebConfig folder which was copied to your web server, locate the file settings.php and open it with a text editor. This file defines the following settings:

$sProtocol = 'http';

The Protocol used to access the Pro Cloud Server

$sServerName = 'localhost';

The Name/IP of the machine running the Pro Cloud Server

$sPort = '804';

The Port which should be used to access the Pro Cloud Server

$sEnforceCerts = 'true';

Applies to https connections only. When 'true' self-signed SSL certificates will be denied. When 'false' self-signed SSL certificates can be used.

These settings determine how the WebConfig will access the Pro Cloud Server. By default, the Pro Cloud Server is configured to allow HTTP communication on Port 804, therefore if the Pro Cloud Server and web server are on the same machine then these settings can typically be left as is.

Alternatively, update these values to reflect the name/ip of the Cloud Server and the appropriate Protocol and Port based on the definitions in the SSProCloud.config file.

6

On a remote machine, open an internet browser and enter the URL of http://{yourwebserver}/WebConfig/index.php, where the value '{yourwebserver}' is either the name or IP number of the machine hosting the WebConfig website.

This should display the WebConfig. If a password has already been set for the Pro Cloud Server then the "PCS Configuration - Login" prompt will be displayed. If no password has been set, then the Pro Cloud Server Configuration Home screen will be displayed.

Learn more