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
|
<!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>Install on Ubuntu — Accel-ppp 1.12 documentation</title>
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=80d5e7a1" />
<link rel="stylesheet" type="text/css" href="../_static/css/theme.css?v=19f00094" />
<link rel="shortcut icon" href="../_static/favicon.ico"/>
<!--[if lt IE 9]>
<script src="../_static/js/html5shiv.min.js"></script>
<![endif]-->
<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=2d52a127"></script>
<script src="../_static/doctools.js?v=9a2dae69"></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="Install on Centos" href="centos.html" />
<link rel="prev" title="Install on Debian" href="debian.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">
Accel-ppp
<img src="../_static/logo.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">
<p class="caption" role="heading"><span class="caption-text">Contents:</span></p>
<ul class="current">
<li class="toctree-l1 current"><a class="reference internal" href="install.html">Installation</a><ul class="current">
<li class="toctree-l2"><a class="reference internal" href="generic_inst.html">Generic Installation</a></li>
<li class="toctree-l2"><a class="reference internal" href="debian.html">Install on Debian</a></li>
<li class="toctree-l2 current"><a class="current reference internal" href="#">Install on Ubuntu</a></li>
<li class="toctree-l2"><a class="reference internal" href="centos.html">Install on Centos</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../configuration/configuration.html">Configuration</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guides/control_features.html">Control features</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guides/recommendations.html">Recommendations</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guides/BRAS_tuning.html">BRAS tuning</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guides/radius_features.html">RADIUS and DM/CoA features</a></li>
<li class="toctree-l1"><a class="reference internal" href="../examples/examples.html">Examples</a></li>
<li class="toctree-l1"><a class="reference internal" href="../debugging/index.html">Debugging</a></li>
<li class="toctree-l1"><a class="reference internal" href="../debugging/faq.html">FAQ</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">Accel-ppp</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="install.html">Installation</a></li>
<li class="breadcrumb-item active">Install on Ubuntu</li>
<li class="wy-breadcrumbs-aside">
<a href="../_sources/installation/ubuntu.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="install-on-ubuntu">
<h1>Install on Ubuntu<a class="headerlink" href="#install-on-ubuntu" title="Link to this heading"></a></h1>
<p><strong>Preparation</strong></p>
<p>Before compile and build package need satisfy some dependencies</p>
<ul class="simple">
<li><p><strong>cmake</strong> - open-source system that manages the build process</p></li>
<li><p><strong>gcc</strong> - GNU Compiler Collection (GCC) is a compiler system</p></li>
<li><p><strong>linux-headers-`uname -r`</strong> - source code of current installing linux kernel, need for build ipoe and vlan_mon modules. If you don`t need these modules, you may don`t install this</p></li>
<li><p><strong>git</strong> - version-control system for tracking changes, (need for downloading source code)</p></li>
<li><p><strong>libpcre3-dev</strong> - source code of pcre lib, accel-ppp need it for use reg expression</p></li>
<li><p><strong>libssl-dev</strong> - source code of pcre lib, accel-ppp need it for use regular expression</p></li>
<li><p><strong>liblua5.1-0-dev</strong> - this need for create custom username (IPoE) from packet. Script write on lua language</p></li>
</ul>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>apt-get<span class="w"> </span>install<span class="w"> </span>-y<span class="w"> </span>build-essential<span class="w"> </span>cmake<span class="w"> </span>gcc<span class="w"> </span>linux-headers-<span class="sb">`</span>uname<span class="w"> </span>-r<span class="sb">`</span><span class="w"> </span>git<span class="w"> </span>libpcre3-dev<span class="w"> </span>libssl-dev<span class="w"> </span>liblua5.1-0-dev
</pre></div>
</div>
<p>After install dependencies, download accel-ppp source code with git client, tree master . Master tree contain actual patches last release.</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>git<span class="w"> </span>clone<span class="w"> </span>https://github.com/accel-ppp/accel-ppp.git<span class="w"> </span>/opt/accel-ppp-code
</pre></div>
</div>
<p>Create directory for build source code and go to this directory.</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>mkdir<span class="w"> </span>/opt/accel-ppp-code/build
<span class="nb">cd</span><span class="w"> </span>/opt/accel-ppp-code/build/
</pre></div>
</div>
<p>For building code need we can set next params:</p>
<ul class="simple">
<li><p><strong>-DBUILD_IPOE_DRIVER=TRUE</strong> include IPoE module.This module need if you want use accel-ppp as shared interface.</p></li>
<li><p><strong>-DBUILD_VLAN_MON_DRIVER=TRUE</strong> include vlan monitoring module. If you want create vlan automatically on analyse IP headers with regular expression set on accel-ppp config file. (Available for IPoE and PPPoE)</p></li>
<li><p><strong>-DKDIR=/usr/src/linux-headers-`uname -r`</strong> sets path to Linux kernel source code. Need only for build IPOE, VLAN-MON.</p></li>
<li><p><strong>-DCMAKE_INSTALL_PREFIX=/usr</strong> path for install executable code. If you build DEB package, not recommended change this.</p></li>
<li><p><strong>-DCPACK_TYPE=Ubuntu18</strong> this arguments for building DEB package. If used Ubuntu other version, set it. For example, if used Ubuntu 16 set <strong>-DCPACK_TYPE=Ubuntu16</strong></p></li>
</ul>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>cmake<span class="w"> </span>-DBUILD_IPOE_DRIVER<span class="o">=</span>TRUE<span class="w"> </span>-DBUILD_VLAN_MON_DRIVER<span class="o">=</span>TRUE<span class="w"> </span>-DCMAKE_INSTALL_PREFIX<span class="o">=</span>/usr<span class="w"> </span>-DKDIR<span class="o">=</span>/usr/src/linux-headers-<span class="sb">`</span>uname<span class="w"> </span>-r<span class="sb">`</span><span class="w"> </span>-DLUA<span class="o">=</span>TRUE<span class="w"> </span>-DCPACK_TYPE<span class="o">=</span>Ubuntu18<span class="w"> </span>..
</pre></div>
</div>
<div class="admonition-notice admonition">
<p class="admonition-title">Notice:</p>
<p>ended symbols <strong>..</strong> sets path to accel-ppp source code, not delete this! Or you can replace it full path to accel-ppp-code like /opt/accel-ppp-code/</p>
</div>
<p>Compile:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>make
</pre></div>
</div>
<p>Create DEB package:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>cpack<span class="w"> </span>-G<span class="w"> </span>DEB
</pre></div>
</div>
<p>Install package:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>dpkg<span class="w"> </span>-i<span class="w"> </span>accel-ppp.deb
</pre></div>
</div>
<p>If you have success packet install, rename config file to accel-ppp.conf</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>mv<span class="w"> </span>/etc/accel-ppp.conf.dist<span class="w"> </span>/etc/accel-ppp.conf
</pre></div>
</div>
<p>Edit accel-ppp.conf for you schemas and run accel-ppp</p>
<p><strong>Run as systemd unit:</strong></p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>systemctl<span class="w"> </span>start<span class="w"> </span>accel-ppp
</pre></div>
</div>
<p>or run manual (not recommended)</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>accel-pppd<span class="w"> </span>-d<span class="w"> </span>-c<span class="w"> </span>/etc/accel-ppp.conf<span class="w"> </span>-p<span class="w"> </span>/var/run/accel-ppp.pid
</pre></div>
</div>
</section>
</div>
</div>
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
<a href="debian.html" class="btn btn-neutral float-left" title="Install on Debian" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
<a href="centos.html" class="btn btn-neutral float-right" title="Install on Centos" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
</div>
<hr/>
<div role="contentinfo">
<p>© Copyright 2023, Accel-ppp Dev.</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>
|
