Cloud Server Installation
The Sparx Systems Cloud Server runs as a Windows Service, accepting network connections from Enterprise Architect clients and sending the data required by the system back over the network. The service installer can be downloaded from the registered user section of the Sparx website:
Installing the service and editing configuration files will both require you to have Administration rights. To ensure that you are running as Administrator, right-click on the downloaded installer and select 'Run as Administrator'.
Cloud Server Components
Sparx Systems Cloud Service
The Windows service that will accept connections from Enterprise Architect and the management client.
Note: The only time you will not want this installed is when you are installing the IIS integration or management client on a different machine to the one running the service.
Optional component for integration with IIS.
Note: This is only required when using the advanced authentication method available through IIS; it can be installed on a different machine to the service itself. See the Cloud Server Using IIS topic.
This is used for management tasks - including configuration of databases to connect to - and some server options.
Note: This can be installed separate from the service itself, allowing many management tasks to be performed without logging directly into the server.
When setting up a server, you do need to check that the Firewall on the server is set to allow the incoming ports for the database connections that you have created.
For example, in the default SSCloudServices.config the ports 804 and 805 are set as operative. If you have a firewall you must set these ports as enabled for inbound traffic.
See also the Windows documentation Open a Port in Windows Firewall.
Note: Another common cause of failure is that other services are already using the allocated ports. This is especially likely when using the default http (80) and https (443) ports.
Self-Signed Certificate using OpenSSL
In order to use a secure connection to your model, a server certificate is required. For a production environment, particularly one providing access to external users, you should obtain a certificate from an appropriate certificate authority. However, to help with initial setup and testing purposes these instructions are included for generating your own certificate.
This is a simple batch file that assumes that openssl is available on the windows path and is appropriately configured. If you paste this code into a batch file and run it with the target hostname as a parameter, it will generate an appropriate key file, which can then be placed in the service install directory.
if not "%1" == "" goto generate
echo ERROR: No target specified
echo USAGE: %0 url
echo EXAMPLE %0 localhost
openssl genrsa -out %1.key 2048
openssl req -new -x509 -key %1.key -out %1.cert -days 3650 -subj /CN=%1
copy /b %1.cert+%1.key server.pem