Skip to content

Commit

Permalink
Update all the Cheat Sheets of the tools
Browse files Browse the repository at this point in the history
  • Loading branch information
marcgise committed Jul 27, 2017
1 parent f830d49 commit a001ca7
Show file tree
Hide file tree
Showing 14 changed files with 330 additions and 74 deletions.
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
<?xml version="1.0" encoding="UTF-8"?>
<cheatsheet
title="Anomaly Detection Tool">
<intro>
<description>This Cheat Sheet will help you to start working with the tool</description>
</intro>
<item title="Configuring and executing the tool">
<description>The tool is available via two menu entries:</description>
<subitem
label="You can configure the tool using the menu DICE Tools --&gt; ADT Configure">
</subitem>
<subitem
label="You can run the tool using the menu DICE Tools --&gt; ADT Launch">
</subitem>

</item>

</cheatsheet>
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
<?xml version="1.0" encoding="UTF-8"?>
<cheatsheet
title="Configuration Optimization Tool">
<intro>
<description>This Cheat Sheet will help you to start working with the tool</description>
</intro>
<item title="Open the View of the tool">
<description>There is a view dedicated to the tool, where the user can interact with it and execute the service over Jenkins. The name of the view is "DICE Configuration View"</description>
</item>
<item title="Further information in the GitHub website">
<description>The user will find further information about how to use the tool in the GitHub website: https://github.com/dice-project/DICE-Configuration-BO4CO/wiki/Getting-Started</description>
</item>

</cheatsheet>

This file was deleted.

Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
<?xml version="1.0" encoding="UTF-8"?>
<cheatsheet
title="Delivery Tool - Registering deployment service">
<intro>
<description>This Cheat Sheet will help you registering DICE Deployment Service that is accessible over HTTP or uses a trusted certificate over HTTPS</description>
</intro>
<item title="Obtain service registration data">
<description>If we would like to register new deployment service into delivery tool, we need to obtain the following pieces of information from administrator, responsible for maintaining the service: service address, username and password</description>
</item>
<item title="Open deployment tool preferences">
<description>If we would like to register new service, we must first open the preferences page.</description>
</item>
<item title="Open dialog for adding new service">
<description>To start service registration, we must press Add button that will open dialog with service entry fields</description>
</item>
<item title="Enter service data">
<description>When we have dialog open, we can enter the service information. Address, username and password should contain the data administrator supplied. Name field should contain short, descriptive name that we will use to identify this service in other dialogs. Keystore related fields can be left empty in this scenario. If the data we entered is valid, last field in the dialog will be auto-populated for us with some default value that we can change if we wish. If we make any error while entering the data, the error will be displayed at the top of the dialog. When we are done, we press Ok. If the data we entered is valid, last field in the dialog will be auto-populated for us with some default value that we can change if we wish. If we make any error while entering the data, the error will be displayed at the top of the dialog</description>
</item>
<item title="Save configuration">
<description>This far, we only have data in temporary buffers. To save it, we press OK and we are done with configuration</description>
</item>
<item title="Adding more services">
<description>If we would like to add more services, we simply repeat the last two steps for each additional service</description>
</item>
<item title="Saving changes">
<description>All of the changes that we made this far only persist in memory. In order to save them, we must press OK button that will close the preferences and save the values</description>
</item>

</cheatsheet>
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
<?xml version="1.0" encoding="UTF-8"?>
<cheatsheet
title="Delivery Tool - Registering deployment service that uses self signed certificate">
<intro>
<description>This Cheat Sheet will help you registering DICE Deployment Service that is accessible over HTTPS that uses self-signed certificate</description>
</intro>
<item title="Obtain service registration data">
<description>If we would like to register new deployment service into delivery tool, we need to obtain the following pieces of information from administrator, responsible for maintaining the service: service address, username, password and service certificate</description>
</item>
<item title="Importing certificate into keystore">
<description>In order to be able to use server certificate that administrator supplied to us, we must import it into keystore. Exact instructions are out of scope for this task, so consult documentation on how to achieve this</description>
</item>
<item title="Open deployment tool preferences">
<description>If we would like to register new service, we must first open the preferences page</description>
</item>
<item title="Open dialog for adding new service">
<description>To start service registration, we must press Add button that will open dialog with service entry fields</description>
</item>
<item title="Enter service data">
<description>When we have dialog open, we can enter the service information. Address, username and password should contain the data administrator supplied. Name field should contain short, descriptive name that we will use to identify this service in other dialogs. Keystore file field should point to your keystore and password should be the password used to unlock it. If the data we entered is valid, last field in the dialog will be auto-populated for us with some default value that we can change if we wish. If we make any error while entering the data, the error will be displayed at the top of the dialog. When we are done, we press Ok. If the data we entered is valid, last field in the dialog will be auto-populated for us with some default value that we can change if we wish. If we make any error while entering the data, the error will be displayed at the top of the dialog</description>
</item>
<item title="Save configuration">
<description>This far, we only have data in temporary buffers. To save it, we press OK and we are done with configuration</description>
</item>
<item title="Adding more services">
<description>If we would like to add more services, we simply repeat the last two steps for each additional service</description>
</item>
<item title="Saving changes">
<description>All of the changes that we made this far only persist in memory. In order to save them, we must press OK button that will close the preferences and save the values</description>
</item>

</cheatsheet>
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
<?xml version="1.0" encoding="UTF-8"?>
<cheatsheet
title="Delivery Tool - Create blueprint">
<intro>
<description>This Cheat Sheet will help you creating minimal blueprint project that can be deployed</description>
</intro>
<item title="Create new project">
<description>Each blueprint that we would like to deploy needs to live in a project. To satisfy this condition we must first create new project</description>
</item>
<item title="Create blueprint">
<description>Now we need to actually produce valid blueprint. In order to speed up the process, we can simply download sample blueprint from DICE deployment service's repository and place it into project we created in previous step</description>
</item>
<item title="Create resources folder">
<description>In order to be able to send additional data along with the blueprint, we need to create a folder in our project that will hold those additional resources</description>
</item>

</cheatsheet>
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
<?xml version="1.0" encoding="UTF-8"?>
<cheatsheet
title="Delivery Tool - Create deploy configuration">
<intro>
<description>This Cheat Sheet will help you creating new run configuration that can be used to deploy selected blueprint</description>
</intro>
<item title="Open run configurations dialog">
<description>From the DICE Tools menu we select DICE Tools -> Delivery Tool, which will open the configuration dialog</description>
</item>
<item title="Create new configuration">
<description>To create new deploy configuration, we must select DICE Deploy in the left selector and then click the new button</description>
</item>
<item title="Add deploy data">
<description>First, we need to pick a sensible name for deploy. Right now, we might just as well call it test, since this is its purpose. Next, we need to select our blueprint and resources folder we created earlier. Deployment service part should be already configured correctly, but we can modify it if we wish. We can save the deploy by pressing Apply button</description>
</item>

</cheatsheet>
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
<?xml version="1.0" encoding="UTF-8"?>
<cheatsheet
title="Delivery Tool - Deploy blueprint">
<intro>
<description>This Cheat Sheet will help you learning how to deploy a blueprint</description>
</intro>
<item title="Start deployment process">
<description>In order to start deployment process, we must open the runtime configuration dialog, select test configuration from the selector in the left side and press Run</description>
</item>
<item title="Monitor progress">
<description>To keep an eye on the deployment process we can open container view that will display statuses of all containers that are available to us</description>
</item>

</cheatsheet>
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
<?xml version="1.0" encoding="UTF-8"?>
<cheatsheet
title="Enhancement Tool">
<intro>
<description>This Cheat Sheet describes the steps that the DICE user follows for using DICE Enhancement tool in DICE IDE</description>
</intro>
<item title="Install Matlab Compiler Runtime (MCR) 2015a">
<description>Install Matlab Compiler Runtime (MCR) 2015a. This is a royalty-free runtime that does not require owning a Matlab license</description>
</item>
<item title="Configure the Matlab Runtime Environment">
<description>After installed the MCR, user needs to ensure that Java environment, Classpath, system path are properly configured. For example, if user installed R2015a(8.5)-64bit in the Windows Operating System under path “C:\MATLAB\MATLAB Runtime”</description>
<subitem
label="Configure CLASSPATH: to use the compiled classes, user needs to include a file called javabuilder.jar on the Java class path. User needs to add “C:\MATLAB\MATLAB Runtime\v85\toolbox\javabuilder\jar” to CLASSPATH">
</subitem>
<subitem
label="Configure system PATH: user needs to add the MCR runtime path “C:\MATLAB\MATLAB Runtime\v85\runtime\win64” to the system PATH">
</subitem>
<subitem
label="The Enhancement tool needs to read two configuration files, DICE-FG-Configuration.xml and DICE-APR-Configuration.xml, to obtain the related parameters for running. User can download the sample configuration files from the following Github page: https://github.com/dice-project/DICE-Enhancement-APR/tree/master/Plugin/doc">
</subitem>
<subitem
label="User needs to put configuration files under the same folder of the target UML model and set the corresponding parameters. The more details of the meaning of those parameters can be found at the following Github page: https://github.com/dice-project/DICE-Enhancement-APR/tree/master/Plugin/doc/Configuration%20Files">
</subitem>
</item>

</cheatsheet>
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,31 @@
<cheatsheet
title="Optimization Tool">
<intro>
<description>This Cheat Sheet brings an example of use of the DICE Optimization Tool. This tool is currently externally integrated, so the main functionality remains in an external web server</description>
<description>describes the methodological steps that DICE users follow for identifying the configuration of minimum cost with the D-SPACE4Cloud tool</description>
</intro>
<item title="Configure the tool" dialog="true">
<description>Before launching the tool, you need to check the connection properties to the external web server</description>
<subitem label="Open the preferences page of the Optimization Tool (Window -&gt; Preferences -&gt; DICE -&gt; Optimization Tool)">
<command required="false" serialization="org.eclipse.ui.window.preferences(preferencePageId=org.dice.ui.preferences.optimization)"></command></subitem>
<subitem label="Check the attributes of the preferences page and modify the values properly. This values are used when launching the tool"></subitem></item>
<item title="Launch the Optimization Service"><description>As the tool is externally integrated, the execution is very easy. Simply click on the menu "DICE Tools -> DICE Optimization Service", and the web server will be opened</description><command required="false" serialization="org.dice.ui.optimizationCommand"></command>
</item>
<item title="Start the optimization wizard" dialog="true">
<description>The optimization process is supported by a five step wizard, which starts by pressing the corresponding button or by selecting the entry Optimization Wizard from the D-SPACE4Cloud plug-in menu.
</description>
</item>
<item title="Select classes, technology and cloud deployment">
<description> Specify the number of classes, the DIA target technology and the deployment (public or private).
</description>
</item>
<item title="Select optimization alternatives and DTSMs">
<description> For each class, specify the optimization alternatives selecting, possibly, multiple VM types at different providers candidate for the final deployment. For each VM type, select the corresponding DTSM model.
</description>
</item>
<item title="Select DDSM including the deployment model">
<description>For each class, select the DDSM model, which includes the deployment model of the DIA, which will be updated by D-SPACE4Cloud with the optimal solution found.
</description>
</item>
<item title="Select Optimization constraints">
<description>At this step optimization constraints are specified and are technology specific. In particular, for Spark and Hadoop MapReduce, specify the minimum and maximum number of concurrent users, the DIA end users’ think time and the DIA deadline (job penalty cost can be specified only on the private cloud case). For Storm, specify the cluster maximum utilization.
</description>
</item>
<item title="Download the results">
<description>When the optimization engine finishes, the DDSM introduced at step 4 is updated and can be used as input by the DICER tool to finally deploy the optimal solution.
</description>
</item>

</cheatsheet>
Loading

0 comments on commit a001ca7

Please sign in to comment.