Source:Debian Repository: Difference between revisions

From SEPsesam
mNo edit summary
(Marked this version for translation)
 
(16 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<translate><!--T:1-->
<noinclude><div class="noprint"><languages />
<div class="noprint"><languages />
<br />
{{Copyright SEP AG|en}}


<!--T:2-->
<translate>== Overview == <!--T:3--> </translate>
{{Navigation_latest|release=[[Special:MyLanguage/SEP_sesam_Release_Versions|4.4.3/4.4.3 ''Beefalo V2'']]|link=[[Special:MyLanguage/SEP_sesam_Documentation#previous|Documentation archive]]}}</div></translate><br />


<translate>== Overview == <!--T:3--></translate>
</div></noinclude><translate><!--T:13-->
<div class="boilerplate metadata" id="Additional resources" style="background-color:#ecedf1; color:#8695a7; border: 1px ridge #cdd3db; margin: 0.5em; padding: 0.5em; float: right; width: 35%; "><center><b><translate><!--T:4--> Additional resources</translate></b></center>
 
{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
| rowspan="2" style="padding:0px 10px 0px;" |<translate><!--T:5--> [[File:SEP_next.png|45px|link=Special:MyLanguage/4_4_3:Installing_PostgreSQL|Installing PostgreSQL]]</translate>
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | <translate><!--T:6--> See also: [[Special:MyLanguage/4_4_3:SEP_sesam_Quick_Install_Guide#linux|SEP sesam Quick Install Guide]] – [https://wiki.debian.org/DebianReleases DebianReleases]</translate>
|}
 
{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
| rowspan="2" style="padding:0px 10px 0px;" | <translate><!--T:7--> [[File:support-matrix.png|45px|link=Special:MyLanguage/SEP_sesam_OS_and_Database_Support_Matrix#Linux]]</translate>
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" |
<translate><!--T:8--> Check supported [[Special:MyLanguage/SEP_sesam_OS_and_Database_Support_Matrix#Linux|configurations and versions]].</translate>
|}
 
{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
| rowspan="2" style="padding:0px 10px 0px;" | <translate><!--T:9--> [[File:SEP Tip.png|45px|link=Special:MyLanguage/FAQ|FAQ]]</translate>
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | <translate><!--T:10--> Check [[Special:MyLanguage/FAQ|FAQ]] to find the answers to most common questions.</translate>
|}
 
{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
| rowspan="2" style="padding:0px 10px 0px;" | <translate><!--T:11--> [[File:SEP Troubleshooting.png|45px|link=Special:MyLanguage/Troubleshooting_Guide|Troubleshooting Guide]]</translate>
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | <translate><!--T:12--> Problems? Check the [[Special:MyLanguage/Troubleshooting_Guide#installation|Troubleshooting Guide]].</translate>
|}</div>
<translate><!--T:13-->
For Debian-based distributions (Debian/Ubuntu/UCS) SEP sesam provides signed Debian repositories for easier package installation, verification and update of the SEP sesam software. This manual describes how to use these repositories.
For Debian-based distributions (Debian/Ubuntu/UCS) SEP sesam provides signed Debian repositories for easier package installation, verification and update of the SEP sesam software. This manual describes how to use these repositories.


Line 42: Line 17:
* Debian Stretch
* Debian Stretch
* Debian Buster
* Debian Buster
* Debian Bullseye
* Debian Bookworm


<translate><!--T:16--> '''''Ubuntu-based systems'''''</translate>
<translate><!--T:16--> '''''Ubuntu-based systems'''''</translate>
Line 48: Line 25:
* Ubuntu 16.04 LTS (<translate><!--T:18--> use the Debian Jessie packages</translate>)
* Ubuntu 16.04 LTS (<translate><!--T:18--> use the Debian Jessie packages</translate>)
* Ubuntu 18.04 LTS (<translate><!--T:19--> use the Debian Stretch packages</translate>)
* Ubuntu 18.04 LTS (<translate><!--T:19--> use the Debian Stretch packages</translate>)
* Ubuntu 20.04 LTS (<translate><!--T:59--> use the Debian Buster packages</translate>)
* Ubuntu 20.04 LTS (<translate><!--T:59--> use the Debian Buster packages</translate>
* Ubuntu 22.04 LTS (<translate><!--T:60--> use the Debian Bullseye packages</translate>)


<translate><!--T:20-->
<translate><!--T:20-->
For details on supported systems, check [[Special:MyLanguage/SEP_sesam_OS_and_Database_Support_Matrix#Linux|SEP sesam OS and Database Support Matrix]].
For details on supported systems, check [[Special:MyLanguage/SEP_sesam_OS_and_Database_Support_Matrix#Linux|SEP sesam OS and Database Support Matrix]].</translate>


== {{anchor|configuration}}Configuring Debian repositories == <!--T:21-->
== {{anchor|configuration}}<translate><!--T:21-->
Configuring Debian repositories ==


<!--T:22-->
<!--T:22-->
SEP sesam provides [https://download.sep.de/linux/repositories/debian/ packages] for installation on Debian and Ubuntu. APT (Advanced Packaging Tool) is used to handle SEP sesam installation, configuration and upgrade on Debian/Ubuntu Linux distributions.</translate>
SEP sesam provides [https://download.sep.de/linux/repositories/debian/ packages] for installation on Debian and Ubuntu. APT (Advanced Packaging Tool) is used to handle SEP sesam installation, configuration and upgrade on Debian/Ubuntu Linux distributions.</translate>


{{<translate><!--T:23--> note</translate>|<translate><!--T:24--> You have to run commands as the ''root'' user or by prefixing the commands you want to run with <tt>sudo</tt> if you use a different user.</translate>}}
{{note|<translate><!--T:24--> You have to run commands as the ''root'' user or by prefixing the commands you want to run with <tt>sudo</tt> if you use a different user.</translate>}}


<translate><!--T:25--> '''Steps'''</translate>
<translate><!--T:25--> '''Steps'''</translate>
<ol><li><translate><!--T:26--> {{anchor|key}}Download the SEP GPG public key to the system where SEP sesam will be installed:</translate></li>
<ol><li>{{anchor|key}}<translate><!--T:26--> Download the SEP GPG public key to the system where SEP sesam will be installed:</translate></li>
  {{DDL|linux/repositories/debian/key.asc}}
  {{DDL|linux/repositories/debian/key.asc}}
<li><translate><!--T:27--> Use <tt>apt-key</tt> (Debian tool for managing package authentication keys) to install the key and add it to the system keyring. In the following example, the key is downloaded via the command line tool <tt>curl</tt> and automatically passed to the <tt>apt-key</tt> tool for the import:</translate></li>
<li><translate><!--T:27--> On Debian systems version 11 or lower, use <tt>apt-key</tt> (Debian tool for managing package authentication keys) to install the key and add it to the system keyring. In the following example, the key is downloaded via the command line tool <tt>curl</tt> and automatically passed to the <tt>apt-key</tt> tool for the import:</translate></li>
 
<pre> curl https://download.sep.de/linux/repositories/debian/key.asc | sudo apt-key add -</pre>
 
<translate><!--T:61--> On newer Debian systems (version 12 or higher) the <tt>apt-key</tt> tool is deprecated. Use the following command to install the key:</translate>
 
<pre>wget -qO- https://download.sep.de/linux/repositories/debian/key.asc | sudo tee /etc/apt/trusted.gpg.d/sepsesam.asc</pre>


curl {{DDL|linux/repositories/debian/key.asc}} | apt-key add -
<li><translate><!--T:28--> Use the following command sequence to check if the key has been installed accordingly:</translate></li>
<li><translate><!--T:28--> Use the following command sequence to check if the key has been installed accordingly:</translate></li>


apt-key list | grep SEP
<pre> apt-key list | grep SEP
  <span style="color:darkred">uid                  SEP AG (<translate><!--T:29--> SEP sesam Repository key</translate>) <support@sep.de></span>
  uid                  SEP AG (<translate><!--T:29--> SEP sesam Repository key</translate>) <support@sep.de></pre>
<li><translate><!--T:30--> Edit the ''sources.list'' file. The system configuration file {{Path|/etc/apt/sources.list}} has to be expanded to include the SEP sesam repository, as shown below:</translate></li>
<li><translate><!--T:30--> Edit the ''sources.list'' file. The system configuration file {{Path|/etc/apt/sources.list}} has to be expanded to include the SEP sesam repository, as shown below:</translate></li>


deb {{DDL|linux/repositories/debian/}} <span style="color:darkred"><translate><!--T:31--> <DISTRIBUTION></translate></span> main
<pre> deb https://download.sep.de/linux/repositories/debian/ <translate><!--T:31--> <DISTRIBUTION></translate> main</pre>


<translate><!--T:32--> Replace <tt><DISTRIBUTION></tt> with your specific Debian distribution in lower case. The Debian repository on Debian ''Jessie'' is used in the following example:</translate>
<translate><!--T:32--> Replace <tt><DISTRIBUTION></tt> with your specific Debian distribution in lower case. The Debian repository on Debian ''Jessie'' is used in the following example:</translate>


deb {{DDL|linux/repositories/debian/}} <span style="color:darkred">'''jessie'''</span> main
<pre> deb https://download.sep.de/linux/repositories/debian/ jessie main</pre>


{{<translate><!--T:33--> tip</translate>|<translate><!--T:34--> Instead of modifying the file {{Path|/etc/apt/sources.list}} you can create a separate repository file {{Path|/etc/apt/sources.list.d/sepsesam.list}} by using the same syntax as described in this step.</translate>}}
{{tip|<translate><!--T:34--> Instead of modifying the file {{Path|/etc/apt/sources.list}} you can create a separate repository file {{Path|/etc/apt/sources.list.d/sepsesam.list}} by using the same syntax as described in this step.</translate>}}


<li><translate><!--T:35--> ''This step is only required if you are running Ubuntu 16.04 or 14.04. Skip this step for Debian and other than listed Ubuntu Linux distributions and if you only want to install the package sesam-cli.''</translate> <br />
<li><translate><!--T:35--> ''This step is only required if you are running Ubuntu 16.04 or 14.04. Skip this step for Debian and other than listed Ubuntu Linux distributions and if you only want to install the package sesam-cli.''</translate> <br />
<translate><!--T:36--> {{anchor|add-apt-repository}}With Ubuntu 16.04 or 14.04, you have to install the required Openjfx and Java packages before a SEP sesam Server can be installed:</translate>
{{anchor|add-apt-repository}}<translate><!--T:36--> With Ubuntu 16.04 or 14.04, you have to install the required Openjfx and Java packages before a SEP sesam Server can be installed:</translate>


<ol style="list-style-type:lower-alpha">
<ol style="list-style-type:lower-alpha">
<li><translate><!--T:37--> First install the packages <tt>openjfx, openjdk-8-jre</tt>:</translate></li>  
<li><translate><!--T:37--> First install the packages <tt>openjfx, openjdk-8-jre</tt>:</translate></li>  
apt-get install -t xenial openjfx openjdk-8-jre  
<pre> apt-get install -t xenial openjfx openjdk-8-jre </pre>


<li><translate><!--T:38--> Then use apt to install the SEP sesam Server:</translate></li>
<li><translate><!--T:38--> Then use apt to install the SEP sesam Server:</translate></li>
<pre> apt-get install sesam-srv</pre>


apt-get install sesam-srv
<translate><!--T:39--> Once you installed the missing PPA, use the <tt>update</tt> command (see next step) to get the latest list of software from each archive it knows about, including the PPA you just added. Note that JRE will be installed as part of the ''sesam-srv''/''sesam-gui'' package), as described in [[#install|Installing SEP sesam components]].</translate></ol>  
 
<translate><!--T:39--> Once you installed the missing PPA, use the <tt>update</tt> command (see next step) to get the latest list of software from each archive it knows about, including the PPA you just added. Note that JRE will be installed as part of the ''sesam-srv''/''sesam-gui'' package), as described in [[Special:MyLanguage/Debian_Repository#install|Installing SEP sesam components]].</translate></ol>  


<li><translate><!--T:40--> To download the information about the packages in your new repository, update the package lists by running:</translate></li>
<li><translate><!--T:40--> To download the information about the packages in your new repository, update the package lists by running:</translate></li>


apt-get update
<pre> apt-get update</pre>


</ol>
</li></ol>


<translate>== {{anchor|search}}Searching for SEP sesam components == <!--T:41-->
== {{anchor|search}}<translate><!--T:41-->
Searching for SEP sesam components ==


<!--T:42-->
<!--T:42-->
Line 108: Line 92:
  sesam-gui - <translate><!--T:44--> SEP sesam GUI for Linux</translate>
  sesam-gui - <translate><!--T:44--> SEP sesam GUI for Linux</translate>
  sesam-rts - <translate><!--T:45--> SEP sesam remote device server for Linux</translate>
  sesam-rts - <translate><!--T:45--> SEP sesam remote device server for Linux</translate>
  sesam-srv - <translate><!--T:46-->
  sesam-srv - <translate><!--T:46--> SEP sesam server for Linux</translate>
SEP sesam server for Linux


== {{anchor|install}}Installing SEP sesam components  == <!--T:47-->
== {{anchor|install}}<translate><!--T:47-->
Installing SEP sesam components  ==


<!--T:48-->
<!--T:48-->
Line 118: Line 102:
  apt-get install <span style="color:darkred">sesam-cli</span>
  apt-get install <span style="color:darkred">sesam-cli</span>


{{<translate><!--T:49--> Note</translate>|<translate><!--T:50--> All needed dependencies will be automatically installed. In case of any errors, you may have to install the missing PPAs manually. Make sure that <tt>add-apt-repository</tt> is present on your system and proceed as described in [[Special:MyLanguage/Debian_Repository#add-apt-repository|step 5]].</translate>}}
{{Note|<translate><!--T:50--> All needed dependencies will be automatically installed. In case of any errors, you may have to install the missing PPAs manually. Make sure that <tt>add-apt-repository</tt> is present on your system and proceed as described in [[#add-apt-repository|step 5]].</translate>}}


<translate>== {{anchor|update}}Updating SEP sesam components == <!--T:51-->
== {{anchor|update}}<translate><!--T:51-->
Updating SEP sesam components ==


<!--T:52-->
<!--T:52-->
Line 130: Line 115:
If you are not sure which Debian repository you have to use, the following commands can help you identify your Debian distribution:</translate>
If you are not sure which Debian repository you have to use, the following commands can help you identify your Debian distribution:</translate>


<ul><li><translate><!--T:55--> If the package ''lsb-release'' is installed, the following command will show your system codename:</translate></li>
<ul><li><translate><!--T:55--> If the package ''lsb-release'' is installed, the following command will show your system code name:</translate></li>


user@system:~$ lsb_release -c
<pre> user@system:~$ lsb_release -c
  Codename:    <span style="color:darkred">jessie</span>
  Codename:    jessie</pre>


<li><translate><!--T:56--> This regular command shows the Debian revision:</translate></li>
<li><translate><!--T:56--> This regular command shows the Debian version:</translate></li>


user@system:~$ cat /etc/debian_version
<pre> user@system:~$ cat /etc/debian_version
  <span style="color:darkred">8.3</span>
  8.3</pre>


<translate><!--T:57--> Revisions are listed as follows:</translate>
<translate><!--T:57--> Versions are listed as follows:</translate>


* Debian 12 ('''bookworm''')
* Debian 11 ('''bullseye''')
* Debian 10 ('''buster''')
* Debian 10 ('''buster''')
* Debian 9 ('''stretch''')
* Debian 9 ('''stretch''')
Line 150: Line 137:
</ul>
</ul>


<translate><div class="noprint">
<noinclude><div class="noprint">{{Copyright}}</div></noinclude>
== See also == <!--T:58-->
[[Special:MyLanguage/4_4_3:SEP_sesam_Quick_Install_Guide#linux|SEP sesam Quick Install Guide]] – [[Special:MyLanguage/Troubleshooting_Guide#Debian_repository|Troubleshooting Guide – Debian repository]] – [https://wiki.debian.org/DebianReleases Debian Releases] – [https://wiki.ubuntu.com/Releases Ubuntu Releases]</div></translate>

Latest revision as of 10:57, 4 December 2023

For Debian-based distributions (Debian/Ubuntu/UCS) SEP sesam provides signed Debian repositories for easier package installation, verification and update of the SEP sesam software. This manual describes how to use these repositories.

Supported Systems

Debian-based systems

  • Debian Lenny
  • Debian Wheezy
  • Debian Jessie
  • Debian Stretch
  • Debian Buster
  • Debian Bullseye
  • Debian Bookworm

Ubuntu-based systems

  • Ubuntu 14.04 LTS (use the Debian Wheezy packages)
  • Ubuntu 16.04 LTS (use the Debian Jessie packages)
  • Ubuntu 18.04 LTS (use the Debian Stretch packages)
  • Ubuntu 20.04 LTS (use the Debian Buster packages
  • Ubuntu 22.04 LTS (use the Debian Bullseye packages)

For details on supported systems, check SEP sesam OS and Database Support Matrix.

Configuring Debian repositories

SEP sesam provides packages for installation on Debian and Ubuntu. APT (Advanced Packaging Tool) is used to handle SEP sesam installation, configuration and upgrade on Debian/Ubuntu Linux distributions.

Information sign.png Note
You have to run commands as the root user or by prefixing the commands you want to run with sudo if you use a different user.

Steps

  1. Download the SEP GPG public key to the system where SEP sesam will be installed:
  2. https://www.sep.de/downloadportal/linux/repositories/debian/key.asc
  3. On Debian systems version 11 or lower, use apt-key (Debian tool for managing package authentication keys) to install the key and add it to the system keyring. In the following example, the key is downloaded via the command line tool curl and automatically passed to the apt-key tool for the import:
  4.  curl https://download.sep.de/linux/repositories/debian/key.asc | sudo apt-key add -

    On newer Debian systems (version 12 or higher) the apt-key tool is deprecated. Use the following command to install the key:

    wget -qO- https://download.sep.de/linux/repositories/debian/key.asc | sudo tee /etc/apt/trusted.gpg.d/sepsesam.asc
  5. Use the following command sequence to check if the key has been installed accordingly:
  6.  apt-key list | grep SEP
     uid                  SEP AG (SEP sesam Repository key) <support@sep.de>
  7. Edit the sources.list file. The system configuration file /etc/apt/sources.list has to be expanded to include the SEP sesam repository, as shown below:
  8.  deb https://download.sep.de/linux/repositories/debian/ <DISTRIBUTION> main

    Replace <DISTRIBUTION> with your specific Debian distribution in lower case. The Debian repository on Debian Jessie is used in the following example:

     deb https://download.sep.de/linux/repositories/debian/ jessie main
    SEP Tip.png Tip
    Instead of modifying the file /etc/apt/sources.list you can create a separate repository file /etc/apt/sources.list.d/sepsesam.list by using the same syntax as described in this step.
  9. This step is only required if you are running Ubuntu 16.04 or 14.04. Skip this step for Debian and other than listed Ubuntu Linux distributions and if you only want to install the package sesam-cli.
    With Ubuntu 16.04 or 14.04, you have to install the required Openjfx and Java packages before a SEP sesam Server can be installed:
    1. First install the packages openjfx, openjdk-8-jre:
    2.  apt-get install -t xenial openjfx openjdk-8-jre 
    3. Then use apt to install the SEP sesam Server:
    4.  apt-get install sesam-srv
      Once you installed the missing PPA, use the update command (see next step) to get the latest list of software from each archive it knows about, including the PPA you just added. Note that JRE will be installed as part of the sesam-srv/sesam-gui package), as described in Installing SEP sesam components.
  10. To download the information about the packages in your new repository, update the package lists by running:
  11.  apt-get update

Searching for SEP sesam components

If the configuration finishes successfully, you should be able to see the following SEP sesam components as install sources:

user@system:~$ apt-cache search sesam
sesam-cli - SEP sesam Client for Linux
sesam-gui - SEP sesam GUI for Linux
sesam-rts - SEP sesam remote device server for Linux
sesam-srv - SEP sesam server for Linux

Installing SEP sesam components

This example shows how to install the SEP sesam Client (sesam-cli); if using a different SEP sesam package (server/rts or gui package), modify the following command accordingly:

apt-get install sesam-cli
Information sign.png Note
All needed dependencies will be automatically installed. In case of any errors, you may have to install the missing PPAs manually. Make sure that add-apt-repository is present on your system and proceed as described in step 5.

Updating SEP sesam components

During the system update, the most recent SEP sesam packages will be retrieved and automatically updated to the latest version.

How to check what Debian version you are running

If you are not sure which Debian repository you have to use, the following commands can help you identify your Debian distribution:

  • If the package lsb-release is installed, the following command will show your system code name:
  •  user@system:~$ lsb_release -c
     Codename:    jessie
  • This regular command shows the Debian version:
  •  user@system:~$ cat /etc/debian_version
     8.3

    Versions are listed as follows:

    • Debian 12 (bookworm)
    • Debian 11 (bullseye)
    • Debian 10 (buster)
    • Debian 9 (stretch)
    • Debian 8 (jessie)
    • Debian 7 (wheezy)
    • Debian 6.0 (squeeze)
    • Debian 5.0 (lenny)
Copyright © SEP AG 1999-2024. All rights reserved.
Any form of reproduction of the contents or parts of this manual is allowed only with the express written permission from SEP AG. When compiling and designing user documentation SEP AG uses great diligence and attempts to deliver accurate and correct information. However, SEP AG cannot issue a guarantee for the contents of this manual.