summaryrefslogtreecommitdiff
path: root/installation/ubuntu.html
diff options
context:
space:
mode:
Diffstat (limited to 'installation/ubuntu.html')
-rw-r--r--installation/ubuntu.html189
1 files changed, 189 insertions, 0 deletions
diff --git a/installation/ubuntu.html b/installation/ubuntu.html
new file mode 100644
index 0000000..9e4b8c3
--- /dev/null
+++ b/installation/ubuntu.html
@@ -0,0 +1,189 @@
+
+
+<!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 &mdash; 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=e59714d7" />
+
+
+ <link rel="shortcut icon" href="../_static/favicon.ico"/>
+ <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=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="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>libpcre2-dev</strong> - source code of pcre2 lib, accel-ppp need it for use reg expression</p></li>
+<li><p><strong>libssl-dev</strong> - source code of ssl 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>libpcre2-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>&#169; 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> \ No newline at end of file
generated by cgit v1.2.3 (git 2.39.1) at 2025-03-12 23:04:05 +0000