WebEA Quick Start Guide - IIS

1.1

The Pro Cloud Server installer can be downloaded from the registered user section of the Sparx Systems website.

     https://sparxsystems.com/registered/reg_ea_down.html

Note:  You will need valid credentials to access this area of the website. 

2.1

For details on IIS and PHP installation, refer to the following link:

https://learn.microsoft.com/en-us/iis/application-frameworks/scenario-build-a-php-website-on-iis/configuring-step-1-install-iis-and-php

2.2

Install IIS as described in the link above.

Note: As mentioned in the link, ensure you enable CGI during the installation.

2.3

Install PHP as described in the "Download and Install PHP Manually" section; however, skip the download/extraction of the WinCache extension (Steps 2 - 4).

2.4

Check that PHP was installed successfully by entering the following at the Windows Command Prompt:

php -info

If this returns an error you may need to install the latest VS C++ redistributable (See: https://answers.microsoft.com/en-us/windows/forum/all/vcruntime140dll-was-not-found/f43d5afd-9239-4913-8f32-20e44a959e13).

2.5

Test PHP as described in the "To test your PHP installation" section.

2.6

Now enable the PHP extensions which are required for WebEA. Open the folder where you installed php (e.g. C:\PHP\) and edit the php.ini file. Find each of the following lines and remove the comment character (;).

;extension=curl

;extension=gettext

;extension=mbstring

;extension=openssl

Note:

• With a new installation you may find you have php.ini-development and php.ini-production files, but no php.ini file. In this case copy the php.ini-production file and rename it to php.ini.

• You may also need to uncomment the line ";extension_dir=" and adjust the path to the extensions folder.

3.1

No additional configuration is required. Test the connection by browsing to the server address from another computer. The 'Internet Information Services' landing page should display.

Note: If you wish to use Windows Authentication for WebEA then IIS should be configured as described in the 'Configuring IIS for WebEA Windows Authentication' topic.

4.1

The Pro Cloud Server installer is a standard MSI; double-click on it to start the installation.

Note: Depending on a number of factors, you might be prompted for the credentials of a user with elevated permissions; these must be entered before the installation will continue.

4.2

The 'Sparx Systems Pro Cloud Server Setup' dialog displays. Click on the Next button.

4.3

Read the license agreement and select the checkbox to indicate that you accept the terms. Click on the Next button.

4.4

Read the information about the Pro Cloud Server. Click on the Next button.

4.5

The 'Custom Setup' page displays. Click on the Next button to accept the defaults.

4.6

Click on the Install button to run the installation.

5.1

Double-click on the 'Pro Cloud Config Client' shortcut that was added to your desktop.

5.2

Enter the Server address:

localhost:1803

Enter the default password:

pcsadm1n

Click on the OK button.

Note, if you are using PCS version 4 or earlier, the default password is blank (leave the password field empty).

5.3

Click on the Licensing button and then on the Create Request button; fill in your company and purchase details, save the License Request and email it to the Sparx Systems Sales team ([email protected]). 

When the Sparx Systems Sales team return your License Certificate, click on the Add button and select the supplied certificate file; the Pro Cloud Server should now have a valid License loaded.

5.4

Select the 'Ports' tab

Select Port '1804' from the list and click on the Edit button.

Tick the 'OSLC Supported' checkbox then click on the OK button.

5.5

Select the 'Database Managers' tab, then click on the Add button.

Type the name 'fb-procloud.feap' in the connection string field, then click on the OK button.

Select the new entry in the list and click on the Edit button.

On the Configure Database Manager screen, select the 'Enabled' and 'Enable Pro Features (OSLC, WebEA and Integration)' checkboxes.

Click on the OK button.

For a more in-depth explanation of how to add database managers, see the Help topic Add Database Manager - ODBC.

5.6

Open the standard Windows Services console (command 'services.msc'), locate and select the service 'Sparx Systems Professional Cloud', then restart it.

6.1

Delete the default IIS files from C:\inetpub\wwwroot

6.2

Copy the folder   C:\Program Files (x86)\Sparx Systems\Pro Cloud Server\WebEA\     to      C:\inetpub\wwwroot.

6.3

Restart IIS (in IIS Manager, select the PC name from the connection list, then within the "Actions" panel click on the "Restart" option).

7.1

Open the file 'C:\inetpub\wwwroot\WebEA\includes\webea_config.ini' with a text editor.

7.2

In the "[model_list]" section, remove the 'model4' and 'model5' lines. Edit the remaining model names to:

model1 = "Pro Cloud Model (no updates)"

model2 = "Pro Cloud Model with discussions"

model3 = "Pro Cloud Model with access code"

7.3

In the "[model1 : settings]" section change the SSCS_DB_ALIAS option to "fb-procloud". The remaining default options should remain unchanged.

7.4

In the "[model2 : settings]" section change the SSCS_DB_ALIAS option to "fb-procloud". The remaining default options should remain unchanged.

7.5

Delete the "[model3 : settings]" and "[model5 : settings]" sections, rename the "[model4 : settings] section header to [model3 : settings]", then set these options as shown:

   sscs_db_alias = "fb-procloud"

   sscs_port = "1804"

   sscs_model_user = ""

   sscs_model_pwd = ""

   auth_code = "password01"

7.6

Save the changes to the file webea_config.ini   in   C:\inetpub\wwwroot\WebEA\includes.

8.1

Firewall rules will have to be adjusted to allow traffic between the [Client] and [Web Server], on ports 80 and 443.

8.2

Firewall rules will have to be adjusted to allow traffic between the [Web Server] and [Pro Cloud Server], on ports 1804 and 1805.

9.1

On a client machine with access to the web server, open Enterprise Architect v13.5 or later.

9.2

From the Start Page select 'Manage Projects' or, from the ribbon, select the ' > Open Project' option.

9.3

Click on the Connect to Cloud button.

9.4

On the 'Cloud Connection' screen set these parameters:

Name: fb-procloud

Protocol: http://

Server: {your servername}

Port: 1804

Model Name: fb-procloud

Click on the OK button.

9.5

Open the 'Settings > Model > Options > Cloud' page and tick these checkboxes:

• Auto create Diagram Image and Image Map (each time a diagram is saved)
• Auto create HTML Page (each time a Linked Document is saved)

These options ensure diagrams and Linked Documents are saved in a format that allows them to be viewed in WebEA.

9.6

Create a sample set of Model Views, Packages, diagrams and elements, so that they can be viewed in WebEA later.

10.1

On a client machine, open an internet browser and enter the URL:

http://{yourwebserver}/WebEA/login.php

where the value '{yourwebserver}' is either the name or IP number of the machine hosting the WebEA website. The WebEA login screen displays, listing the three model connections we defined earlier:

• Pro Cloud Model (no updates)
• Pro Cloud Model with discussions
• Pro Cloud Model with access code

10.2

Select the first model connection - Pro Cloud Model (no updates) - and click on the Next button. This connects you to the model and displays the model views that are defined.

From here you should be able to navigate through the model by selecting Packages, diagrams and elements. When you select an element, its complete details are displayed. Because of the way this model connection is defined, the bottom of the properties section will NOT contain the 'Discussions' section.

10.3

Click on the 'hamburger' icon in the top right corner of the display, and select the 'Logout' option. Then select the second model connection - Pro Cloud Model with discussions - and click on the Next button. You should see the same model views as before; now navigate to an element and confirm that the 'Discussions' section is visible.

10.4

Once again, click on the 'hamburger' icon in the top right corner, and select the 'Logout' option.

Select the third model connection, 'Pro Cloud Model with access code' and click on the Next button. This time you should be presented with a prompt for the Access Code; enter 'password01' (as we defined in step 7.5) and click on the Login button. You should see the same model views as before. Navigate to an element; this time there should be a blue 'hamburger' menu in the element details area that allows the creation of element features such as tests and resource allocations. There should also be a pencil icon next to the element notes area that, when clicked on, will allow the modification of element notes.