Source:Debian Repository: Difference between revisions

From SEPsesam
m (Links to FAQ)
(37 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<translate><!--T:1-->
<div class="noprint"><languages />
{{Copyright SEP AG|en}}
{{Copyright SEP AG|en}}
== Overview ==


As with sesam version '''>= 4.4.2-83''' SEP offers signed Debian repositories for easier package installation, verification and update of the SEP sesam software. This manual describes on how to use these repositories.
<!--T:2-->
{{Navigation_latest|release=[[Special:MyLanguage/SEP_sesam_Release_Versions|4.4.3 ''Beefalo V2''/5.0.0 ''Jaglion'']]|link=[[Special:MyLanguage/SEP_sesam_Documentation#previous|Documentation archive]]}}</div></translate><br />


=== Signed Repository Manual ===
<translate>== Overview == <!--T:3--></translate>
<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>


===== <span style="color:darkgreen">Supported Systems</span> =====
{|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/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/4_4_3_Beefalo:FAQ|FAQ]]</translate>
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | <translate><!--T:10--> Check [[Special:MyLanguage/4_4_3_Beefalo: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.
 
===Supported Systems=== <!--T:14-->
 
<!--T:15-->
'''''Debian-based systems'''''</translate>


* Debian Lenny
* Debian Lenny
Line 12: Line 41:
* Debian Jessie
* Debian Jessie
* Debian Stretch
* Debian Stretch
* Debian Buster
* Debian Bullseye


===== <span style="color:darkgreen">Configuration</span> =====
<translate><!--T:16--> '''''Ubuntu-based systems'''''</translate>


{{Box Attention|Attention:|All commands have to be executed as '''root''' user or as an administrative user with the ''sudo'' command prefixed.}}
* Ubuntu 14.04 LTS (<translate><!--T:17--> use the Debian Wheezy 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 20.04 LTS (<translate><!--T:59--> use the Debian Buster packages</translate>
* Ubuntu 22.04 LTS (<translate><!--T:60--> use the Debian Bullseye packages (client only)</translate>)


====== Key installation ======
<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]].


In the first step the SEP GPG Public key has to be downloaded to the system which should be able to install Debian packages. This step is needed for the system to be able to verify SEP Debian packages. The key is placed at the following URL:
== {{anchor|configuration}}Configuring Debian repositories == <!--T:21-->


http://download.sep.de/linux/repositories/debian/key.asc
<!--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>


In order to install the key use the Debian tool '''apt-key''' to add the key to the systems keyring. This example will download the key via the command-line tool '''curl''' and automatically passes it to the <tt>apt-key</tt> tool for import:
{{<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>}}


curl http://download.sep.de/linux/repositories/debian/key.asc | apt-key add -
<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>
{{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>


Use the following command sequence to check if the key has been installed accordingly:
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>


  apt-key list | grep SEP
  apt-key list | grep SEP
  <span style="color:darkred">uid                  SEP AG (SEP Sesam Repository key) <support@sep.de></span>
  <span style="color:darkred">uid                  SEP AG (<translate><!--T:29--> SEP sesam Repository key</translate>) <support@sep.de></span>
<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>


====== Edit sources list file ======
deb {{DDL|linux/repositories/debian/}} <span style="color:darkred"><translate><!--T:31--> <DISTRIBUTION></translate></span> main


In the second step the system configuration file {{Path|/etc/apt/sources.list}} has to be modified by adding a line like this:
<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 http://download.sep.de/linux/repositories/debian/ <span style="color:darkred"><DISTRIBUTION></span> main
  deb {{DDL|linux/repositories/debian/}} <span style="color:darkred">'''jessie'''</span> main


Please replace <span style="color:darkred"><DISTRIBUTION></span> with your according Debian distribution. If one wants to use the Debian repository on Debian '''jessie''' the line has to look like this:
{{<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>}}


deb http://download.sep.de/linux/repositories/debian/ <span style="color:darkred">'''jessie'''</span> main
<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>


====== Run '''APT''' ======
<ol style="list-style-type:lower-alpha">
<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


After adding the needed contents to {{Path|/etc/apt/sources.list}} run the command:
<li><translate><!--T:38--> Then use apt to install the SEP sesam Server:</translate></li>


  apt-get update
  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 [[Special:MyLanguage/Debian_Repository#install|Installing SEP sesam components]].</translate></ol>


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


===== <span style="color:darkgreen">Searching and installing sesam components</span> =====
apt-get update


After successful configuration the system should be able to search/install and remove packages via the standard Debian package tools.
</ol>


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


If the update process finishes successfully one should find the SEP sesam components as install sources:
<!--T:42-->
If the configuration finishes successfully, you should be able to see the following SEP sesam components as install sources:</translate>


  user@system:~$ apt-cache search sesam
  user@system:~$ apt-cache search sesam
  sesam-cli - SEP sesam Client for Linux
  sesam-cli - <translate><!--T:43--> SEP sesam Client for Linux</translate>
  sesam-gui - SEPsesam GUI for Linux
  sesam-gui - <translate><!--T:44--> SEP sesam GUI for Linux</translate>
  sesam-rts - SEP sesam remote device server for Linux
  sesam-rts - <translate><!--T:45--> SEP sesam remote device server for Linux</translate>
  sesam-srv - SEP sesam server for Linux
  sesam-srv - <translate><!--T:46-->
SEP sesam server for Linux


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


This example shows how to install the sesam client, the command can be adjusted to install the server/rts or gui packages too:
<!--T:48-->
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:</translate>


  apt-get install <span style="color:darkred">sesam-cli</span>
  apt-get install <span style="color:darkred">sesam-cli</span>


all needed dependencies will be automatically installed.
{{<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>}}


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


During update of the system the most recent sesam packages will be pulled and automatically updated to the latest version.
<!--T:52-->
During the system update, the most recent SEP sesam packages will be retrieved and automatically updated to the latest version.


== Troubleshooting ==
== How to check what Debian version you are running == <!--T:53-->


=== How to find out system version  ===
<!--T:54-->
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 to identify your Debian distribution:
<ul><li><translate><!--T:55--> If the package ''lsb-release'' is installed, the following command will show your system code name:</translate></li>
 
If the package '''lsb-release''' is installed, the following executable will show your systems codename:


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


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


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


Revisions are listed as follows:
<translate><!--T:57--> Versions are listed as follows:</translate>
 
8.x: Debian '''jessie'''
7.x: Debian '''wheezy'''
6.x: Debian '''squeeze'''
5.x: Debian '''lenny'''
 
=== GPG error ===
 
After running '''apt-get update''' the following error is shown:
 
W: GPG error: http://download.sep.de jessie InRelease: The following signatures couldn't be verified because the public key is not available: NO_PUBKEY 68111EBBD273917B
 
Cause of this error is the missing SEP GPG Key in the systems keyring, please install the key as shown in step  '''[[Debian_Repository#Key_installation]]'''
 
=== Verification error ===
 
During package installation the following warning occurs:
 
WARNING: The following packages cannot be authenticated!
  sesam-<package>
Install these packages without verification? [y/N]


Cause of this error is the missing SEP GPG Key in the systems keyring, please install the key as shown in step '''[[Debian_Repository#Key_installation]]'''
* Debian 11 ('''bullseye''')
* Debian 10 ('''buster''')
* Debian 9 ('''stretch''')
* Debian 8 ('''jessie''')
* Debian 7 ('''wheezy''')
* Debian 6.0 ('''squeeze''')
* Debian 5.0 ('''lenny''')
</ul>


== References ==
<translate><div class="noprint">
https://wiki.debian.org/DebianReleases
== See also == <!--T:58-->
[[Special:MyLanguage/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>

Revision as of 15:18, 2 June 2022

Other languages:

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.

Docs latest icon.png Welcome to the latest SEP sesam documentation version 4.4.3 Beefalo V2/5.0.0 Jaglion. For previous documentation version(s), check Documentation archive.


Overview

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

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 (client only))

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. 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://www.sep.de/downloadportal/linux/repositories/debian/key.asc | apt-key add -
  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://www.sep.de/downloadportal/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://www.sep.de/downloadportal/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 11 (bullseye)
    • Debian 10 (buster)
    • Debian 9 (stretch)
    • Debian 8 (jessie)
    • Debian 7 (wheezy)
    • Debian 6.0 (squeeze)
    • Debian 5.0 (lenny)