Salome HOME
sat #8897 : prise en compte du cas overwrite où version est un dictionnaire
[tools/sat.git] / doc / build / html / commands / application.html
1
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
3   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
4
5 <html xmlns="http://www.w3.org/1999/xhtml">
6   <head>
7     <meta http-equiv="X-UA-Compatible" content="IE=Edge" />
8     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
9     <title>Command application &#8212; salomeTools 5.0.0dev documentation</title>
10     <link rel="stylesheet" href="../_static/alabaster.css" type="text/css" />
11     <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
12     <script type="text/javascript" src="../_static/documentation_options.js"></script>
13     <script type="text/javascript" src="../_static/jquery.js"></script>
14     <script type="text/javascript" src="../_static/underscore.js"></script>
15     <script type="text/javascript" src="../_static/doctools.js"></script>
16     <script type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
17     <link rel="index" title="Index" href="../genindex.html" />
18     <link rel="search" title="Search" href="../search.html" />
19     <link rel="next" title="Command log" href="log.html" />
20     <link rel="prev" title="Command launcher" href="launcher.html" />
21    
22   <link rel="stylesheet" href="../_static/custom.css" type="text/css" />
23   
24   
25   <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
26
27   </head><body>
28   
29
30     <div class="document">
31       <div class="documentwrapper">
32         <div class="bodywrapper">
33           <div class="body" role="main">
34             
35   <div class="section" id="command-application">
36 <h1>Command application<a class="headerlink" href="#command-application" title="Permalink to this headline">¶</a></h1>
37 <div class="section" id="description">
38 <h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
39 <p>The <strong>application</strong> command creates a virtual <a class="reference external" href="http://www.salome-platform.org">SALOME</a> application.
40 Virtual SALOME applications are used to start SALOME when distribution is needed.</p>
41 </div>
42 <div class="section" id="usage">
43 <h2>Usage<a class="headerlink" href="#usage" title="Permalink to this headline">¶</a></h2>
44 <ul>
45 <li><p class="first">Create an application:</p>
46 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">sat</span> <span class="n">application</span> <span class="o">&lt;</span><span class="n">application</span><span class="o">&gt;</span>
47 </pre></div>
48 </div>
49 <p>Create the virtual application directory in the salomeTool application directory <code class="docutils literal notranslate"><span class="pre">$APPLICATION.workdir</span></code>.</p>
50 </li>
51 <li><p class="first">Give a name to the application:</p>
52 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">sat</span> <span class="n">application</span> <span class="o">&lt;</span><span class="n">application</span><span class="o">&gt;</span> <span class="o">--</span><span class="n">name</span> <span class="o">&lt;</span><span class="n">my_application_name</span><span class="o">&gt;</span>
53 </pre></div>
54 </div>
55 <p><em>Remark</em>: this option overrides the name given in the virtual_app section of the configuration file <code class="docutils literal notranslate"><span class="pre">$APPLICATION.virtual_app.name</span></code>.</p>
56 </li>
57 <li><p class="first">Change the directory where the application is created:</p>
58 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">sat</span> <span class="n">application</span> <span class="o">&lt;</span><span class="n">application</span><span class="o">&gt;</span> <span class="o">--</span><span class="n">target</span> <span class="o">&lt;</span><span class="n">my_application_directory</span><span class="o">&gt;</span>
59 </pre></div>
60 </div>
61 </li>
62 <li><p class="first">Set a specific <a class="reference external" href="http://www.salome-platform.org">SALOME</a> resources catalog (it will be used for the distribution of components on distant machines):</p>
63 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">sat</span> <span class="n">application</span> <span class="o">&lt;</span><span class="n">application</span><span class="o">&gt;</span> <span class="o">--</span><span class="n">catalog</span> <span class="o">&lt;</span><span class="n">path_to_catalog</span><span class="o">&gt;</span>
64 </pre></div>
65 </div>
66 <p>Note that the catalog specified will be copied to the application directory.</p>
67 </li>
68 <li><p class="first">Generate the catalog for a list of machines:</p>
69 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">sat</span> <span class="n">application</span> <span class="o">&lt;</span><span class="n">application</span><span class="o">&gt;</span> <span class="o">--</span><span class="n">gencat</span> <span class="n">machine1</span><span class="p">,</span><span class="n">machine2</span><span class="p">,</span><span class="n">machine3</span>
70 </pre></div>
71 </div>
72 <p>This will create a catalog by querying each machine through ssh protocol (memory, number of processor) with ssh.</p>
73 </li>
74 <li><p class="first">Generate a mesa application (if mesa and llvm are parts of the application). Use this option only if you have to use salome through ssh and have problems with ssh X forwarding of OpengGL modules (like Paravis):</p>
75 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">sat</span> <span class="n">launcher</span> <span class="o">&lt;</span><span class="n">application</span><span class="o">&gt;</span> <span class="o">--</span><span class="n">use_mesa</span>
76 </pre></div>
77 </div>
78 </li>
79 </ul>
80 </div>
81 <div class="section" id="some-useful-configuration-pathes">
82 <h2>Some useful configuration pathes<a class="headerlink" href="#some-useful-configuration-pathes" title="Permalink to this headline">¶</a></h2>
83 <p>The virtual application can be configured with the virtual_app section of the configutation file.</p>
84 <ul class="simple">
85 <li><strong>APPLICATION.virtual_app</strong><ul>
86 <li><strong>name</strong> : name of the launcher (to replace the default runAppli).</li>
87 <li><strong>application_name</strong> : (optional) the name of the virtual application directory, if missing the default value is <code class="docutils literal notranslate"><span class="pre">$name</span> <span class="pre">+</span> <span class="pre">_appli</span></code>.</li>
88 </ul>
89 </li>
90 </ul>
91 </div>
92 </div>
93
94
95           </div>
96         </div>
97       </div>
98       <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
99         <div class="sphinxsidebarwrapper">
100             <p class="logo"><a href="../index.html">
101               <img class="logo" src="../_static/sat_v5.0.png" alt="Logo"/>
102             </a></p>
103   <h3><a href="../index.html">Table Of Contents</a></h3>
104   <ul>
105 <li><a class="reference internal" href="#">Command application</a><ul>
106 <li><a class="reference internal" href="#description">Description</a></li>
107 <li><a class="reference internal" href="#usage">Usage</a></li>
108 <li><a class="reference internal" href="#some-useful-configuration-pathes">Some useful configuration pathes</a></li>
109 </ul>
110 </li>
111 </ul>
112 <div class="relations">
113 <h3>Related Topics</h3>
114 <ul>
115   <li><a href="../index.html">Documentation overview</a><ul>
116       <li>Previous: <a href="launcher.html" title="previous chapter">Command launcher</a></li>
117       <li>Next: <a href="log.html" title="next chapter">Command log</a></li>
118   </ul></li>
119 </ul>
120 </div>
121   <div role="note" aria-label="source link">
122     <h3>This Page</h3>
123     <ul class="this-page-menu">
124       <li><a href="../_sources/commands/application.rst.txt"
125             rel="nofollow">Show Source</a></li>
126     </ul>
127    </div>
128 <div id="searchbox" style="display: none" role="search">
129   <h3>Quick search</h3>
130     <div class="searchformwrapper">
131     <form class="search" action="../search.html" method="get">
132       <input type="text" name="q" />
133       <input type="submit" value="Go" />
134       <input type="hidden" name="check_keywords" value="yes" />
135       <input type="hidden" name="area" value="default" />
136     </form>
137     </div>
138 </div>
139 <script type="text/javascript">$('#searchbox').show(0);</script>
140         </div>
141       </div>
142       <div class="clearer"></div>
143     </div>
144     <div class="footer">
145       &copy;2018, CEA.
146       
147       |
148       Powered by <a href="http://sphinx-doc.org/">Sphinx 1.7.3</a>
149       &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.10</a>
150       
151       |
152       <a href="../_sources/commands/application.rst.txt"
153           rel="nofollow">Page source</a>
154     </div>
155
156     
157
158     
159   </body>
160 </html>