Skip to content
removed div / p tags authored by Franck TALBART's avatar Franck TALBART
......@@ -10,62 +10,62 @@ The next section is [Section 3: Compile](TutorialsGeneralUsageCodeletManagementC
# Introduction #
<div align='justify'>
The following section explains how to add applications, run Codelet Finder, and automatically create codelets. Please be sure to have read [Adding a codelet](TutorialsGeneralUsageCodeletManagementAddingACodelet) as it contains important information on file management. Codelet management is the first step in characterizing and optimizing code segments in CTI.
</div>
<br/>
<div align='justify'>
The rest of the documentation uses the following application example: <a href='http://wiki.codelet-tuning-infrastructure.googlecode.com/git/Test_cti_codelet_manager.tar.gz'>Test_cti_codelet_manager.tar.gz</a>.
</div>
<br/>
The user first has to create an application entry. The name and directory are provided.
# Adding an Application #
<div align='justify'>
Codelets are created from a given application. CTI must have an entry describing the application in order to create the codelets.
</div>
</br/>
<div align='justify'>
Before adding an application, it is recommended to build a [local repository](TutorialsGeneralUsageRepositories). The user should always perform grouped experiments inside a separate local repository.
</div>
## CTS ##
<div align='justify'>
To import an application, click on the "Codelet management" link from the top-menu. Then, from the sub-list of the "Application" item in the left menu, select "Add an application".
The application creation form should appear:
</div>
<p align='center'>![](img/CTS-add_Application-Hot-Links.png)</p>
<p align='center'><i>The application form</i></p>
![](img/CTS-add_Application-Hot-Links.png)
<i>The application form</i>
<div align='justify'>
The form can be completed, among other fields, by [choosing the repository](TutorialsGeneralUsageRepositories), the displayed name, the name of the application, and the full path to the directory. The path to the application is the path from the computer running CTI or CTS and not automatically the user's local machine.
</div>
<br/>
<div align='justify'>
Once completed, the user can click on Add to finally add the application. This will make a link to the newly-created entry appear.
</div>
<br/>
<div align='justify'>
Clicking this link will display a view, providing information about the application.
</div>
<p align='center'>![](img/CTS-Import-Application-Information.png)</p>
<p align='center'><i>The application viewer</i></p>
![](img/CTS-Import-Application-Information.png)
<i>The application viewer</i>
<div align='justify'>
At creation, there are no codelets associated to the application. The following section presents how to create the codelets for the application using CAPS' tool called Codelet Finder(CF).
</div>
## Command-Line ##
<div align='justify'>
Using the command-line, a user can add an application to a local repository.
The command is performed in a CTI directory, ie a cti repository init command has previously been performed in the directory. To import an application, the user must do the following:
</div>
```
$ cti repository init my_rep
The local repository is created (UID = 2f4bfcd0-7dbd-49b8-963e-8852859618ff)!
......@@ -80,9 +80,9 @@ In the previous case, the application /home/users/ftalbart/test is added to the
# Creating Codelets from the Application #
<div align='justify'>
Creating codelets automatically from the application can be done via CTS or command line. The application is compressed and sent to the target machine (supported protocols: SSH and Slurm), or the local machine. Then, CF is launched on the machine specified by the user. Finally, the codelets generated by CF are sent back to machine's user and imported into CTI.
</div>
Before the first creation, the user needs to send its SSH public key to the target machine (if the experiment is not run locally):
......@@ -100,35 +100,35 @@ Then, the user can run the experiment and never has to perform the ssh-key step
Via CTS, the user must go to the created application entry and click on the "Create new codelets" button:
<p align='center'>![](img/CTS-Import-Application-Information.png)</p>
![](img/CTS-Import-Application-Information.png)
<p align='center'><i>The application viewer</i></p>
<i>The application viewer</i>
Then, the user specifies on which machine CF should be run, by clicking on the "Find" button:
<p align='center'>![](img/CTS-create-codelet-platform.png)</p>
![](img/CTS-create-codelet-platform.png)
<p align='center'><i>The Codelet Finder form</i></p>
<i>The Codelet Finder form</i>
If the machine is not registered in CTI, the user follows the "Add an entry" link, on the top of the pop-up. Then, he fills in the following form:
<p align='center'>![](img/CTS-add-platform-form.png)</p>
![](img/CTS-add-platform-form.png)
<p align='center'>The platform form_</p>_
The platform form__
/!\ If the user plans to use MAQAO CQA, he must specify the CPU and its micro-architecture.
Finally, the user goes back to the previous form and select the platform. The user can also specify makefile/sbatch option:
<p align='center'>![](img/CTS-launch-CF-process.png)</p>
![](img/CTS-launch-CF-process.png)
<p align='center'><i>The Codelet Finder form</i></p>
<i>The Codelet Finder form</i>
The CF daemon is launched and the daemon output is updated in an output file that is viewable:
<p align='center'>![](img/CTS-daemon-output.png)</p>
![](img/CTS-daemon-output.png)
<p align='center'><i>The daemon is running</i></p>
<i>The daemon is running</i>
## Command-Line ##
......@@ -222,33 +222,33 @@ When the process is finished, the codelets are automatically imported into CTI i
At the end of the process, Application DATA_UID is displayed:
<p align='center'>![](img/CTS-daemon-output.png)</p>
![](img/CTS-daemon-output.png)
<p align='center'><i>The daemon's output</i></p>
<i>The daemon's output</i>
Then, the user can go back to the application entry by following the "produced_by" link:
<p align='center'>![](img/CTS-codelets-list.png)</p>
![](img/CTS-codelets-list.png)
<p align='center'><i>The application viewer</i></p>
<i>The application viewer</i>
A new "codelet_group" entry is created each time the user invokes the "create codelets" button. By clicking on one, information about the set of codelets is retrieved:
<p align='center'>![](img/CTS-codelet-list.png)</p>
![](img/CTS-codelet-list.png)
<p align='center'><i>The list of codelets</i></p>
<i>The list of codelets</i>
By choosing one of the codelets, the related file entry is displayed:
<p align='center'>![](img/CTS-files-list.png)</p>
![](img/CTS-files-list.png)
<p align='center'><i>The list of files</i></p>
<i>The list of files</i>
By clicking on the filenames, the file viewer displays the content:
<p align='center'>![](img/CTS-file-entry.png)</p>
![](img/CTS-file-entry.png)
<p align='center'><i>The file viewer</i></p>
<i>The file viewer</i>
## Command-Line ##
......
......