-
Notifications
You must be signed in to change notification settings - Fork 7
/
build.html
256 lines (235 loc) · 14.6 KB
/
build.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
<!DOCTYPE html>
<html class="writer-html5" lang="en" data-content_root="./">
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Source Builds — GEOPM documentation</title>
<link rel="stylesheet" type="text/css" href="_static/pygments.css?v=b86133f3" />
<link rel="stylesheet" type="text/css" href="_static/css/theme.css?v=e59714d7" />
<script src="_static/jquery.js?v=5d32c60e"></script>
<script src="_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
<script src="_static/documentation_options.js?v=5929fcd5"></script>
<script src="_static/doctools.js?v=9bcbadda"></script>
<script src="_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="_static/js/theme.js"></script>
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="Service Security" href="security.html" />
<link rel="prev" title="Requirements" href="requires.html" />
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="index.html" class="icon icon-home">
GEOPM
<img src="https://geopm.github.io/images/geopm-logo-clear.png" class="logo" alt="Logo"/>
</a>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
<input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="overview.html">Getting Started</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="user_guides.html">User Guides</a><ul class="current">
<li class="toctree-l2 current"><a class="reference internal" href="service.html">User Guide for GEOPM Service</a><ul class="current">
<li class="toctree-l3"><a class="reference internal" href="service_readme.html">GEOPM Service</a></li>
<li class="toctree-l3"><a class="reference internal" href="install.html">Installation</a></li>
<li class="toctree-l3"><a class="reference internal" href="requires.html">Requirements</a></li>
<li class="toctree-l3 current"><a class="current reference internal" href="#">Source Builds</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#building-geopm-service-rpms">Building GEOPM Service RPMs</a></li>
<li class="toctree-l4"><a class="reference internal" href="#installing-and-running-the-geopm-service">Installing and Running the GEOPM Service</a></li>
<li class="toctree-l4"><a class="reference internal" href="#removal-of-the-geopm-service">Removal of the GEOPM Service</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="security.html">Service Security</a></li>
<li class="toctree-l3"><a class="reference internal" href="admin.html">Service Administrators</a></li>
<li class="toctree-l3"><a class="reference internal" href="client.html">Service Clients</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="runtime.html">User Guide for GEOPM Runtime</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="contrib.html">Contributor Guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="devel.html">Developer Guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="publications.html">Publications</a></li>
<li class="toctree-l1"><a class="reference internal" href="reference.html">Reference Manual</a></li>
<li class="toctree-l1"><a class="reference internal" href="releases.html">Releases</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="index.html">GEOPM</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="Page navigation">
<ul class="wy-breadcrumbs">
<li><a href="index.html" class="icon icon-home" aria-label="Home"></a></li>
<li class="breadcrumb-item"><a href="user_guides.html">User Guides</a></li>
<li class="breadcrumb-item"><a href="service.html">User Guide for GEOPM Service</a></li>
<li class="breadcrumb-item active">Source Builds</li>
<li class="wy-breadcrumbs-aside">
<a href="_sources/build.rst.txt" rel="nofollow"> View page source</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<section id="source-builds">
<h1>Source Builds<a class="headerlink" href="#source-builds" title="Link to this heading"></a></h1>
<p>This documentation provides build instructions for administrators who are
interested in installing the GEOPM packages based on a checkout from the GEOPM
git repository. Following these instructions will assist users in creating RPM
or debian packages compatible with various Linux distributions.</p>
<p>We have tested packages created through this process on SLES 15 SP3 and SP4,
as well as Ubuntu jammy 22.04. Feedback from installations on other
distributions such as CentOS, openSUSE Leap, and Fedora would be greatly
appreciated.</p>
<p>GEOPM Service installation is available via both RPM and debian packages. These
packages provide cross-Linux-distribution compatibility for the installation of
the systemd service and facilitate a clean uninstallation process.</p>
<p>The GEOPM service build system provides support for packaging for:</p>
<ul class="simple">
<li><p>SLES 15 SP3 and SP4</p></li>
<li><p>CentOS 8 amd 9-Stream</p></li>
<li><p>Ubuntu 22.04 jammy</p></li>
</ul>
<section id="building-geopm-service-rpms">
<h2>Building GEOPM Service RPMs<a class="headerlink" href="#building-geopm-service-rpms" title="Link to this heading"></a></h2>
<p>First review the <a class="reference internal" href="requires.html"><span class="doc">requirements guide</span></a>, then use the following
bash commands to build all of the GEOPM packages.</p>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>git<span class="w"> </span>clone<span class="w"> </span>[email protected]:geopm/geopm.git
<span class="nb">cd</span><span class="w"> </span>geopm/service
./package.sh
</pre></div>
</div>
<p>These commands create the .rpm files or .deb files that package the GEOPM
software. On Ubuntu, these packages are build in the tree:</p>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>./docs/geopm-runtime-doc_<VERSION>-1_all.deb
./docs/geopm-service-doc_<VERSION>-1_all.deb
./docs/libgeopmd-doc_<VERSION>-1_all.deb
./docs/libgeopm-doc_<VERSION>-1_all.deb
./docs/python3-geopmdpy-doc_<VERSION>-1_all.deb
./docs/python3-geopmpy-doc_<VERSION>-1_all.deb
./geopmdpy/python3-geopmdpy_<VERSION>-1_all.deb
./geopmpy/python3-geopmpy_<VERSION>-1_all.deb
./libgeopmd/geopm-service_<VERSION>-1_amd64.deb
./libgeopmd/libgeopmd2_<VERSION>-1_amd64.deb
./libgeopmd/libgeopmd-dev_<VERSION>-1_amd64.deb
./libgeopm/geopm-runtime_<VERSION>-1_amd64.deb
./libgeopm/libgeopm2_<VERSION>-1_amd64.deb
./libgeopm/libgeopm-dev_<VERSION>-1_amd64.deb
</pre></div>
</div>
<p>In RPM based operating systems the RPMs are created in the rpmbuild root
(default is ~/rpmbuild).</p>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>./rpmbuild/RPMS/x86_64/geopm-runtime-<VERSION>-1.x86_64.rpm
./rpmbuild/RPMS/x86_64/geopm-runtime-devel-<VERSION>-1.x86_64.rpm
./rpmbuild/RPMS/x86_64/geopm-runtime-doc-<VERSION>-1.x86_64.rpm
./rpmbuild/RPMS/x86_64/geopm-service-<VERSION>-1.x86_64.rpm
./rpmbuild/RPMS/x86_64/geopm-service-devel-<VERSION>-1.x86_64.rpm
./rpmbuild/RPMS/x86_64/geopm-service-doc-<VERSION>-1.x86_64.rpm
./rpmbuild/RPMS/x86_64/libgeopm2-<VERSION>-1.x86_64.rpm
./rpmbuild/RPMS/x86_64/libgeopmd2-<VERSION>-1.x86_64.rpm
./rpmbuild/RPMS/x86_64/libgeopmd-doc-<VERSION>-1.x86_64.rpm
./rpmbuild/RPMS/x86_64/libgeopm-doc-<VERSION>-1.x86_64.rpm
./rpmbuild/RPMS/x86_64/python3-geopmdpy-<VERSION>-1.x86_64.rpm
./rpmbuild/RPMS/x86_64/python3-geopmdpy-doc-<VERSION>-1.x86_64.rpm
./rpmbuild/RPMS/x86_64/python3-geopmpy-<VERSION>-1.x86_64.rpm
./rpmbuild/RPMS/x86_64/python3-geopmpy-doc-<VERSION>-1.x86_64.rpm
</pre></div>
</div>
</section>
<section id="installing-and-running-the-geopm-service">
<h2>Installing and Running the GEOPM Service<a class="headerlink" href="#installing-and-running-the-geopm-service" title="Link to this heading"></a></h2>
<p>Once the packaging is complete, install the RPM files by issuing your OS’s
packaging manager (i.e. zypper or yum):</p>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>sudo<span class="w"> </span>zypper<span class="w"> </span>install<span class="w"> </span>--allow-unsigned-rpm<span class="w"> </span><span class="nv">$HOME</span>/rpmbuild/RPMS/x86_64/*geopm*.rpm
</pre></div>
</div>
<p>Or the DEB files by issuing:</p>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span><span class="nb">cd</span><span class="w"> </span>geopm
$<span class="w"> </span>sudo<span class="w"> </span>apt<span class="w"> </span>install<span class="w"> </span><span class="k">$(</span>find<span class="w"> </span>-name<span class="w"> </span><span class="s1">'*geopm*.deb'</span><span class="k">)</span>
</pre></div>
</div>
<p>To start the GEOPM service and check its status issue:</p>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>sudo<span class="w"> </span>systemctl<span class="w"> </span>start<span class="w"> </span>geopm
systemctl<span class="w"> </span>status<span class="w"> </span>geopm
</pre></div>
</div>
</section>
<section id="removal-of-the-geopm-service">
<h2>Removal of the GEOPM Service<a class="headerlink" href="#removal-of-the-geopm-service" title="Link to this heading"></a></h2>
<p>To stop the GEOPM service and remove the RPMs from your system, use your OS’s
package manager:</p>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>sudo<span class="w"> </span>systemctl<span class="w"> </span>stop<span class="w"> </span>geopm
sudo<span class="w"> </span>zypper<span class="w"> </span>remove<span class="w"> </span>geopm-runtime<span class="w"> </span><span class="se">\</span>
<span class="w"> </span>geopm-runtime-devel<span class="w"> </span><span class="se">\</span>
<span class="w"> </span>geopm-runtime-doc<span class="w"> </span><span class="se">\</span>
<span class="w"> </span>geopm-service<span class="w"> </span><span class="se">\</span>
<span class="w"> </span>geopm-service-devel<span class="w"> </span><span class="se">\</span>
<span class="w"> </span>geopm-service-doc<span class="w"> </span><span class="se">\</span>
<span class="w"> </span>libgeopm2<span class="w"> </span><span class="se">\</span>
<span class="w"> </span>libgeopmd2<span class="w"> </span><span class="se">\</span>
<span class="w"> </span>libgeopmd-doc<span class="w"> </span><span class="se">\</span>
<span class="w"> </span>libgeopm-doc<span class="w"> </span><span class="se">\</span>
<span class="w"> </span>python3-geopmdpy<span class="w"> </span><span class="se">\</span>
<span class="w"> </span>python3-geopmdpy-doc<span class="w"> </span><span class="se">\</span>
<span class="w"> </span>python3-geopmpy<span class="w"> </span><span class="se">\</span>
<span class="w"> </span>python3-geopmpy-doc
</pre></div>
</div>
<p>Or for the DEB packages by issuing:</p>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>sudo<span class="w"> </span>systemctl<span class="w"> </span>stop<span class="w"> </span>geopm
sudo<span class="w"> </span>apt<span class="w"> </span>remove<span class="w"> </span>geopm-runtime<span class="w"> </span><span class="se">\</span>
<span class="w"> </span>geopm-runtime-devel<span class="w"> </span><span class="se">\</span>
<span class="w"> </span>geopm-runtime-doc<span class="w"> </span><span class="se">\</span>
<span class="w"> </span>geopm-service<span class="w"> </span><span class="se">\</span>
<span class="w"> </span>geopm-service-devel<span class="w"> </span><span class="se">\</span>
<span class="w"> </span>geopm-service-doc<span class="w"> </span><span class="se">\</span>
<span class="w"> </span>libgeopm2<span class="w"> </span><span class="se">\</span>
<span class="w"> </span>libgeopmd2<span class="w"> </span><span class="se">\</span>
<span class="w"> </span>libgeopmd-doc<span class="w"> </span><span class="se">\</span>
<span class="w"> </span>libgeopm-doc<span class="w"> </span><span class="se">\</span>
<span class="w"> </span>python3-geopmdpy<span class="w"> </span><span class="se">\</span>
<span class="w"> </span>python3-geopmdpy-doc<span class="w"> </span><span class="se">\</span>
<span class="w"> </span>python3-geopmpy<span class="w"> </span><span class="se">\</span>
<span class="w"> </span>python3-geopmpy-doc
</pre></div>
</div>
</section>
</section>
</div>
</div>
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
<a href="requires.html" class="btn btn-neutral float-left" title="Requirements" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
<a href="security.html" class="btn btn-neutral float-right" title="Service Security" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
</div>
<hr/>
<div role="contentinfo">
<p>© Copyright 2015 - 2024 Intel Corporation. All rights reserved..</p>
</div>
Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
<a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script>
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>