https://code.cor-lab.de/https://code.cor-lab.de/favicon.ico?14019720732013-02-14T14:28:28ZOpen Source Collaboration PlatformCoR-Lab Tutorials - Tasks #1416: Pre-packaged installation tutorialhttps://code.cor-lab.de/issues/1416?journal_id=36012013-02-14T14:28:28ZJ. Wienkejwienke@techfak.uni-bielefeld.de
<ul><li><strong>Description</strong> updated (<a href="/journals/diff/3601?detail_id=4349" title="View differences">diff</a>)</li></ul> CoR-Lab Tutorials - Tasks #1416: Pre-packaged installation tutorialhttps://code.cor-lab.de/issues/1416?journal_id=36022013-02-14T14:29:34ZJ. Wienkejwienke@techfak.uni-bielefeld.de
<ul><li><strong>Description</strong> updated (<a href="/journals/diff/3602?detail_id=4350" title="View differences">diff</a>)</li></ul> CoR-Lab Tutorials - Tasks #1416: Pre-packaged installation tutorialhttps://code.cor-lab.de/issues/1416?journal_id=36032013-02-14T14:29:49ZJ. Wienkejwienke@techfak.uni-bielefeld.de
<ul><li><strong>Description</strong> updated (<a href="/journals/diff/3603?detail_id=4351" title="View differences">diff</a>)</li></ul> CoR-Lab Tutorials - Tasks #1416: Pre-packaged installation tutorialhttps://code.cor-lab.de/issues/1416?journal_id=36042013-02-14T14:34:27ZJ. Wienkejwienke@techfak.uni-bielefeld.de
<ul><li><strong>Description</strong> updated (<a href="/journals/diff/3604?detail_id=4352" title="View differences">diff</a>)</li></ul> CoR-Lab Tutorials - Tasks #1416: Pre-packaged installation tutorialhttps://code.cor-lab.de/issues/1416?journal_id=36052013-02-14T14:37:48ZJ. Wienkejwienke@techfak.uni-bielefeld.de
<ul></ul><p>This is the debian package installation content from the wiki:</p>
<a name="Debian-Packages"></a>
<h1 >Debian Packages<a href="#Debian-Packages" class="wiki-anchor">¶</a></h1>
<p>Debian packages for RSC, RSB and related projects can be obtained from the CoR-Lab repository located at <a class="external" href="http://packages.cor-lab.de">http://packages.cor-lab.de</a>.</p>
<p><em>The steps described in the following sections have to be executed with superuser privileges. For further information on how to integrate the repository for example in the Ubuntu Software Center please use the documentation at <a class="external" href="http://www.ubuntu.com">http://www.ubuntu.com</a>.</em></p>
<a name="Adding-the-Repository"></a>
<h2 >Adding the Repository<a href="#Adding-the-Repository" class="wiki-anchor">¶</a></h2>
<p>Add the following public key to your apt keyring:</p>
<pre>
-----BEGIN PGP PUBLIC KEY BLOCK-----
Version: GnuPG v1.4.10 (GNU/Linux)
mQENBE6dj58BCADYerktYV3BF2QB7ZM9b/M5LNmsllXr+qTrNwT15emAm1HlDg3h
IlrFkJjfATi2DiWuRwYxlssLrPltqgvDwHKe0BDB9usxqGrZNj9tNeMhOZ8y2jRr
GPJFOX6SRtmiAV492wD3WcCcv7bGUZ2li2opLL1slCcY9U++RiqPDs/QWyvoyCcE
6Dner91OHkek3XXTYvWvfcD0vdGRjMaEqGQPOhcRZi/HJxrAY+MhiJuWRMEJb3vz
ykAkqshAzi7L1BlhZUa6qa29Pis77Iw1m3oCl8e0N1MI76Xzmh/fw791E1BxXGxw
xB8oPF9zwblJwiAEF9Z5s47VDzxzhe07uD3HABEBAAG0QkNvUi1MYWIgKENvUi1M
YWIgQWRtaW5pc3RyYXRpb24pIDxjb3JhZG1AdGVjaGZhay51bmktYmllbGVmZWxk
LmRlPokBPgQTAQIAKAUCTp2PnwIbAwUJCWYBgAYLCQgHAwIGFQgCCQoLBBYCAwEC
HgECF4AACgkQ9jNhxXFwfhlc7gf/Rxt7VXIBbTnlo8mvZuogFRW903PDOwPGAi2z
hVxUkuzs202RItotDT3b47oLiESPeLWBo1bH+uhq6cjy05iCRebtj2Pn7EPczjN2
53ViokxnMzoTKpmSt9DwlvZ9QZSFQhmXZck612Yk42fJi4En7EzITaCQd8zTHhVN
fodPVaf7x4qC71pCorPU+VaQFPIuLIcw01w/3PXZrYQyGuEtKPW0kVjMQZXHzRE/
eB31Lb7r8qBiHiEOTBtc1oYCWY9wkHDOYiFgjtEpXgbxowcgcviwwpFOMzlilvlt
owBIyGtLFmLFcv/caZ9BwM85Br+KSzn7E3e4P93mQXihvaTg7LkBDQROnY+fAQgA
0Pe9jTKjBGZrzFMZaH2XwBF88oHOs7a3GajkYlWh1KT1QW80ScuyHpR7hssgOle3
uF/FtZ1C0DeaRPwbV5ZkKFgBXpRAU0w4N2sTGTyp/7GiNnHLa9J0yLZB1UQTf+AO
zLSEt+qD2ZXV97pyoYAqOAc1h0j1fLfuS9M1kpAzfDIuAyXkTGyWu73Mx29+gtdK
OKsMQ987qDIX9UDXQNomZ7lqWfsarfRjmwNO1xqnaN47sL2F5xrMrso+SOdLF8JE
clCBPSfAeEwxOwz+trqjnxqkQjha8vhztSitB1aoDeLRy5sAORo+W480O21YKjeA
BEnMX5TM9BqWPN0DlWrhcwARAQABiQElBBgBAgAPBQJOnY+fAhsMBQkJZgGAAAoJ
EPYzYcVxcH4Z++4IAMCS86JA0JksyAK+To5gqmrCnHilrjHj3nSJqb3KzmLM8t0d
WIFY6OEyyvGKvjNwZIkKkpTnyCU1fp/vWcdvtdtD72N0xgzeAOrBModt+MsvOxlJ
qeF7hmDLdR7dTHMeLj3KAP5mXhR9EvB6fUJarla1BipwhKoupXFT26EdHmcw3nGV
1pEmRcBTlQNkZerHQu0VTRpj45Op9TOxmyGVsB0Qyblf6ve4zYlEZTSykL6cGAoq
7Sx72LWhgdlljJzOr0B8qRpwTl94tk1ULVB+GRcMtko1EK2YJvp5oReft6yoEVRJ
WLWKX3kbuD/ERBWbY46wbeJBB3KqrnKm6ck2xFI=
=6vmi
-----END PGP PUBLIC KEY BLOCK-----
</pre>
<p>This public key is also available for download <a href="https://webdav.cor-lab.de/server_keys/packages.cor-lab.de_server_key.txt" class="external">here</a>.</p>
<p>Download or copy the public key to a file (e.g. <code>package_server_key.txt</code>) and execute the following command:</p>
<pre>
#:~> apt-key add package_server_key.txt
</pre>
<a name="Extending-Package-Source-List"></a>
<h2 >Extending Package Source List<a href="#Extending-Package-Source-List" class="wiki-anchor">¶</a></h2>
<p>Add the following line to the <code>/etc/apt/sources.list</code> file (adapt the release name (e.g. lucid, natty, ...) to match your distribution):</p>
<pre>
deb http://packages.cor-lab.de/ubuntu oneiric testing
</pre>
<a name="Installing"></a>
<h2 >Installing<a href="#Installing" class="wiki-anchor">¶</a></h2>
<p>After updating the apt database you can install the packages from the repository:</p>
<pre>
#:~> apt-get update
#:~> apt-get install rsb0.6
</pre> CoR-Lab Tutorials - Tasks #1416: Pre-packaged installation tutorialhttps://code.cor-lab.de/issues/1416?journal_id=50532014-02-07T15:17:02ZJ. Wienkejwienke@techfak.uni-bielefeld.de
<ul><li><strong>Assignee</strong> set to <i>S. Sharma</i></li></ul> CoR-Lab Tutorials - Tasks #1416: Pre-packaged installation tutorialhttps://code.cor-lab.de/issues/1416?journal_id=50662014-02-11T17:02:58ZS. Sharmasuchitsharma_2007@yahoo.co.in
<ul><li><strong>Target version</strong> set to <i>rsb-0.11</i></li></ul><p>Could you plaese add the link of the page on cor-lab site from where the below information was taken:</p>
<p>Method (all with dependency tracking):<br /> dpkg<br /> homebrew<br /> pip<br /> maven<br /> Windows installer downloads<br />OS:<br /> Linux<br /> Windows<br /> Mac</p> CoR-Lab Tutorials - Tasks #1416: Pre-packaged installation tutorialhttps://code.cor-lab.de/issues/1416?journal_id=50682014-02-11T17:57:38ZJ. Moringenjmoringe@cor-lab.uni-bielefeld.de
<ul></ul><blockquote>
<p>Could you plaese add the link of the page on cor-lab site from where the below information was taken:</p>
</blockquote>
<p>If I remember correctly, we just gathered that list from memory. There may be more combinations of installation methods and operating systems to consider.</p>
<p>The actual descriptions of individual methods are scattered among several documentation projects/docs.cor-lab.org.</p>
<p>For this task, we suggest starting with <a href="https://code.cor-lab.de/issues/1754" class="issue tracker-4 status-3 priority-4 priority-default closed child" title="Create empty sphinx project (Resolved)">#1754</a>. It may also be a good idea to finish <a href="https://code.cor-lab.de/issues/1732" class="issue tracker-5 status-3 priority-4 priority-default closed" title="Document how to use maven from the citec repository server in client projects (Resolved)">#1732</a> and <a href="https://code.cor-lab.de/issues/1753" class="issue tracker-4 status-3 priority-4 priority-default closed" title="Document how to use RST for java with Maven (Resolved)">#1753</a> before starting work on this issue.</p> CoR-Lab Tutorials - Tasks #1416: Pre-packaged installation tutorialhttps://code.cor-lab.de/issues/1416?journal_id=51962014-02-26T14:41:43ZS. Wredeswrede@cor-lab.uni-bielefeld.de
<ul></ul><p>We (Suchit, Jan, Sebastian) dicussed the general issue today and came up with the following proposal:</p>
<ul>
<li>We consider a dedicated <code>common-install-docs</code> project as useful.</li>
<li>This project will provide templates and CMake macros for generating project-specific install documentation from the templates.</li>
<li>These macros will be used by specific manual projects. (The manual projects use CMake, so providing the macros in CMake format doesn't seem to be a problem).</li>
<li>Installation sections for specific packages that comply to the general installation policies will thus be very easy to generate.</li>
<li>In the <code>common-install-doc</code> project we shall start with generic / invariant installation information, e.g., on <strong>binary</strong> installation from
<ul>
<li>Debian packags</li>
<li>Maven repos</li>
<li>PyPI packages</li>
<li>Homebrew scripts?</li>
<li>Windows archives?</li>
</ul>
</li>
<li>Initially, we want to deploy the generated project specific installation documentation together with the project specific packages. So, from a user perspective there is now big change except that the binary installation instructions look everywhere the same.</li>
</ul> CoR-Lab Tutorials - Tasks #1416: Pre-packaged installation tutorialhttps://code.cor-lab.de/issues/1416?journal_id=51972014-02-26T14:56:17ZJ. Wienkejwienke@techfak.uni-bielefeld.de
<ul></ul><p>Sounds like a good plan.</p>
For the technical realization: Did you also consider providing either:
<ul>
<li>Python functions that are used to generate fragments of the configuration options for the sphinx project</li>
<li>A dedicated sphinx domain</li>
</ul>
<p>Python might be easier to use for generating complex stuff / contents than the CMake language.</p> CoR-Lab Tutorials - Tasks #1416: Pre-packaged installation tutorialhttps://code.cor-lab.de/issues/1416?journal_id=52092014-03-03T11:39:10ZS. Sharmasuchitsharma_2007@yahoo.co.in
<ul></ul><p>Johannes Wienke wrote:</p>
<blockquote>
<p>Sounds like a good plan.</p>
For the technical realization: Did you also consider providing either:
<ul>
<li>Python functions that are used to generate fragments of the configuration options for the sphinx project</li>
<li>A dedicated sphinx domain</li>
</ul>
<p>Python might be easier to use for generating complex stuff / contents than the CMake language.</p>
</blockquote>
<p>I haven't considered any of these yet, since I not very familiar with python or cmake so if you have an opinion I can proceed with the approach suggested by you.</p> CoR-Lab Tutorials - Tasks #1416: Pre-packaged installation tutorialhttps://code.cor-lab.de/issues/1416?journal_id=52482014-03-13T13:29:32ZS. Sharmasuchitsharma_2007@yahoo.co.in
<ul></ul><p>I am using templates like maven installation,pypi installation,etc which contain general information about an installation. For project specific details I use conf.py or import data from text files to fill in the project specific information in between the templates.The problem with this approach is that for every html file we have the content distributed among many files (some data from template rest from different text files to be imported for project specific details).I doubt if this is a nice approach as later if the user wants to update html document he will have to change content which is distributed among different files.We may have to explore option of changing the content programatically.</p> CoR-Lab Tutorials - Tasks #1416: Pre-packaged installation tutorialhttps://code.cor-lab.de/issues/1416?journal_id=52652014-03-18T12:28:46ZS. Sharmasuchitsharma_2007@yahoo.co.in
<ul></ul><p>We could not discuss our approach for using templates yesterday as Jan was not there in the meeting.<br />@Jan/Johannes can we have a brief meeting to discuss our appproach.</p> CoR-Lab Tutorials - Tasks #1416: Pre-packaged installation tutorialhttps://code.cor-lab.de/issues/1416?journal_id=52782014-03-20T11:29:26ZS. Sharmasuchitsharma_2007@yahoo.co.in
<ul></ul><p>adding jan and johannes to watchers of the issue (earlier watchers list was empty)<br />Suchit Sharma wrote:</p>
<blockquote>
<p>We could not discuss our approach for using templates yesterday as Jan was not there in the meeting.<br />@Jan/Johannes can we have a brief meeting to discuss our appproach.</p>
</blockquote> CoR-Lab Tutorials - Tasks #1416: Pre-packaged installation tutorialhttps://code.cor-lab.de/issues/1416?journal_id=52942014-03-24T16:23:58ZJ. Wienkejwienke@techfak.uni-bielefeld.de
<ul></ul><p>Suchit, could you attend the RSB meeting on Thursday, 2pm to present your current results?</p> CoR-Lab Tutorials - Tasks #1416: Pre-packaged installation tutorialhttps://code.cor-lab.de/issues/1416?journal_id=52952014-03-24T16:53:36ZS. Sharmasuchitsharma_2007@yahoo.co.in
<ul></ul><p>Yes, sure I will attend the thursday meeting.</p> CoR-Lab Tutorials - Tasks #1416: Pre-packaged installation tutorialhttps://code.cor-lab.de/issues/1416?journal_id=62912014-12-01T16:24:18ZJ. Moringenjmoringe@cor-lab.uni-bielefeld.de
<ul><li><strong>Assignee</strong> deleted (<del><i>S. Sharma</i></del>)</li></ul> CoR-Lab Tutorials - Tasks #1416: Pre-packaged installation tutorialhttps://code.cor-lab.de/issues/1416?journal_id=64932015-01-07T18:12:05ZJ. Moringenjmoringe@cor-lab.uni-bielefeld.de
<ul><li><strong>Target version</strong> changed from <i>rsb-0.11</i> to <i>rsb-0.12</i></li></ul> CoR-Lab Tutorials - Tasks #1416: Pre-packaged installation tutorialhttps://code.cor-lab.de/issues/1416?journal_id=80202016-03-03T11:08:02ZJ. Moringenjmoringe@cor-lab.uni-bielefeld.de
<ul><li><strong>Target version</strong> changed from <i>rsb-0.12</i> to <i>rsb-0.14</i></li></ul> CoR-Lab Tutorials - Tasks #1416: Pre-packaged installation tutorialhttps://code.cor-lab.de/issues/1416?journal_id=84022016-06-08T19:03:07ZJ. Moringenjmoringe@cor-lab.uni-bielefeld.de
<ul><li><strong>Target version</strong> changed from <i>rsb-0.14</i> to <i>rsb-0.15</i></li></ul> CoR-Lab Tutorials - Tasks #1416: Pre-packaged installation tutorialhttps://code.cor-lab.de/issues/1416?journal_id=89232016-11-07T18:24:13ZJ. Moringenjmoringe@cor-lab.uni-bielefeld.de
<ul><li><strong>Target version</strong> changed from <i>rsb-0.15</i> to <i>rsb-0.16</i></li></ul> CoR-Lab Tutorials - Tasks #1416: Pre-packaged installation tutorialhttps://code.cor-lab.de/issues/1416?journal_id=92632017-09-28T18:52:30ZJ. Moringenjmoringe@cor-lab.uni-bielefeld.de
<ul><li><strong>Target version</strong> changed from <i>rsb-0.16</i> to <i>rsb-1.0</i></li></ul>