Source:Debian Repository: Difference between revisions

From SEPsesam
(Rewritten/restructured.)
Line 1: Line 1:
{{Copyright SEP AG|en}}
{{Copyright SEP AG|en}}
{{Navigation_latest|release=[[Special:MyLanguage/SEP_sesam_Release_Versions|4.4.3/4.4.3 ''Grolar'']]|link=[[Special:MyLanguage/SEP_sesam_Documentation#previous|Documentation archive]]}}
== Overview ==
== Overview ==
<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>Additional resources</b></center>


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.
{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
| rowspan="2" style="padding:0px 10px 0px;" |[[File:SEP_next.png|45px|link=Special:MyLanguage/4_4_3:Installing_PostgreSQL|Installing PostgreSQL]]
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | See also: [[Special:MyLanguage/4_4_3:SEP_sesam_Quick_Install_Guide#linux|SEP sesam Quick Install Guide]] – [https://wiki.debian.org/DebianReleases DebianReleases]
|}


=== Signed Repository Manual ===
{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
| rowspan="2" style="padding:0px 10px 0px;" | [[File:support-matrix.png|45px|link=Special:MyLanguage/SEP_sesam_OS_and_Database_Support_Matrix#Linux]]
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" |
Check supported [[Special:MyLanguage/SEP_sesam_OS_and_Database_Support_Matrix#Linux|configurations and versions]].
|}


===== <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;" | [[File:SEP Tip.png|45px|link=Special:MyLanguage/FAQ|FAQ]]
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | Check [[Special:MyLanguage/FAQ|FAQ]] to find the answers to most common questions.
|}


====== <span style="color:darkred">Debian based Systems</span> ======
{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
| rowspan="2" style="padding:0px 10px 0px;" | [[File:SEP Troubleshooting.png|45px|link=Special:MyLanguage/Troubleshooting_Guide|Troubleshooting Guide]]
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | Problems? Check the [[Special:MyLanguage/Troubleshooting_Guide|Troubleshooting Guide]].
|}</div>
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 Lenny
Line 15: Line 36:
* Debian Stretch
* Debian Stretch


====== <span style="color:darkred">Ubuntu based Systems</span> ======
'''''Ubuntu-based systems'''''


* Ubuntu 16.04: please use the Debian Jessie Packages
* Ubuntu 16.04 (use the Debian Jessie packages)
* Ubuntu 14.04: please use the Debian Wheezy Packages
* Ubuntu 14.04 (use the Debian Wheezy packages)


===== <span style="color:darkgreen">Configuration</span> =====
For the details on supported systems, check [[Special:MyLanguage/SEP_sesam_OS_and_Database_Support_Matrix#Linux|SEP sesam OS and Database Support Matrix]].


{{Box Attention|Attention:|All commands have to be executed as '''root''' user or as an administrative user with the ''sudo'' command prefixed.}}
== {{anchor|configuration}}Configuring Debian repositories ==


====== Key installation ======
Note that all commands have to be executed as ''root'' user or ''administrator'', with the ''sudo'' command prefixed.
 
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:


=== Steps ===
<ol><li>{{anchor|key}}Install the SEP GPG public key. With the key the system will be able to verify SEP sesam Debian packages.</li>
<ul><li>Download the SEP GPG public key to the system which should be able to install Debian packages: </li>
  http://download.sep.de/linux/repositories/debian/key.asc
  http://download.sep.de/linux/repositories/debian/key.asc
 
<li>In order to install the key, use the Debian tool ''apt-key'' to add the key 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:</li>
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:


  curl http://download.sep.de/linux/repositories/debian/key.asc | apt-key add -
  curl http://download.sep.de/linux/repositories/debian/key.asc | apt-key add -
 
<li>Use the following command sequence to check if the key has been installed accordingly:</li>
Use the following command sequence to check if the key has been installed accordingly:


  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 (SEP Sesam Repository key) <support@sep.de></span>
 
</ul>
====== Edit sources list file ======
<li>Edit the sources list file.</li>
 
<ul><li>The system configuration file {{Path|/etc/apt/sources.list}} has to be modified, as shown in the example below:</li>
In the second step the system configuration file {{Path|/etc/apt/sources.list}} has to be modified by adding a line like this:


  deb http://download.sep.de/linux/repositories/debian/ <span style="color:darkred"><DISTRIBUTION></span> main
  deb http://download.sep.de/linux/repositories/debian/ <span style="color:darkred"><DISTRIBUTION></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:
Replace <tt><DISTRIBUTION></tt> with your specific Debian distribution. The Debian repository on Debian ''Jessie'' is shown in the following example:


  deb http://download.sep.de/linux/repositories/debian/ <span style="color:darkred">'''jessie'''</span> main
  deb http://download.sep.de/linux/repositories/debian/ <span style="color:darkred">'''jessie'''</span> main
 
</ul>
====== Run '''APT''' ======
<li>Run <tt>apt</tt> by using the command:</li>
 
After adding the needed contents to {{Path|/etc/apt/sources.list}} run the command:


  apt-get update
  apt-get update


to update the package lists.
to update the package lists.
</ol>


===== <span style="color:darkgreen">Searching and installing sesam components</span> =====
== {{anchor|components}}Searching and installing SEP sesam components ==


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


====== Searching for sesam components  ======
=== {{anchor|search}}Searching for SEP sesam components  ===


If the update process finishes successfully one should find the SEP sesam components as install sources:
If the configuration finishes successfully, you should find the SEP sesam components as install sources:


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


====== Installing sesam components  ======
=== {{anchor|install}}Installing SEP sesam components  ===


This example shows how to install the sesam client, the command can be adjusted to install the server/rts or gui packages too:
This example shows how to install the SEP sesam Client. You can adjust the command to install the ''server/rts'' or ''gui'' packages:


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


====== Updating sesam components  ======
=== {{anchor|update}}Updating SEP sesam components  ===


During update of the system the most recent sesam packages will be pulled and automatically updated to the latest version.
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 ==


=== How to find out system version  ===
If you are not sure which Debian repository you have to use, the following commands can help you identify your Debian distribution:


If you are not sure which Debian repository you have to use, the following commands can help to identify your Debian distribution:
<ul><li>If the package ''lsb-release'' is installed, the following command will show your system codename:</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>This regular command shows the Debian revision:</li>


  user@system:~$ cat /etc/debian_version
  user@system:~$ cat /etc/debian_version
Line 106: Line 122:
  6.x: Debian '''squeeze'''
  6.x: Debian '''squeeze'''
  5.x: Debian '''lenny'''
  5.x: Debian '''lenny'''
</ul>
== {{anchor|troubleshooting}}Troubleshooting ==


=== GPG error ===
=== GPG error ===


After running '''apt-get update''' the following error is shown:
'''Problem'''
 
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
  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]]'''
'''Cause'''
 
The SEP GPG key is missing in the system keyring.
 
'''Solution'''
 
Install the key, as shown in the above section [[Special:MyLanguage/Debian_Repository#key|Configuring Debian repositories]].


=== Verification error ===
=== Verification error ===
'''Problem'''


During package installation the following warning occurs:
During package installation the following warning occurs:
Line 123: Line 151:
  Install these packages without verification? [y/N]  
  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]]'''
'''Cause'''
 
The SEP GPG key is missing in the system keyring.
 
'''Solution'''
 
Install the key, as shown in the above section [[Special:MyLanguage/Debian_Repository#key|Configuring Debian repositories]].


== References ==
== See also ==
https://wiki.debian.org/DebianReleases
[[Special:MyLanguage/4_4_3:SEP_sesam_Quick_Install_Guide#linux|SEP sesam Quick Install Guide]] – [https://wiki.debian.org/DebianReleases DebianReleases]

Revision as of 13:30, 4 September 2018

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/4.4.3 Grolar. 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

Ubuntu-based systems

  • Ubuntu 16.04 (use the Debian Jessie packages)
  • Ubuntu 14.04 (use the Debian Wheezy packages)

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

Configuring Debian repositories

Note that all commands have to be executed as root user or administrator, with the sudo command prefixed.

Steps

  1. Install the SEP GPG public key. With the key the system will be able to verify SEP sesam Debian packages.
    • Download the SEP GPG public key to the system which should be able to install Debian packages:
    • http://download.sep.de/linux/repositories/debian/key.asc
    • In order to install the key, use the Debian tool apt-key to add the key 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:
    • curl http://download.sep.de/linux/repositories/debian/key.asc | apt-key add -
    • Use the following command sequence to check if the key has been installed accordingly:
    • apt-key list | grep SEP uid SEP AG (SEP Sesam Repository key) <support@sep.de>
  2. Edit the sources list file.
  3. Run apt by using the command:
  4. apt-get update to update the package lists.

Searching and installing SEP sesam components

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

Searching for SEP sesam components

If the configuration finishes successfully, you should find the 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. You can adjust the command to install the server/rts or gui packages:

apt-get install sesam-cli
Information sign.png Note
All needed dependencies will be automatically installed.

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 codename:
  • user@system:~$ lsb_release -c Codename: jessie
  • This regular command shows the Debian revision:
  • user@system:~$ cat /etc/debian_version 8.3 Revisions are listed as follows: 9.x: Debian stretch 8.x: Debian jessie 7.x: Debian wheezy 6.x: Debian squeeze 5.x: Debian lenny

Troubleshooting

GPG error

Problem

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

The SEP GPG key is missing in the system keyring.

Solution

Install the key, as shown in the above section Configuring Debian repositories.

Verification error

Problem

During package installation the following warning occurs:

WARNING: The following packages cannot be authenticated!
 sesam-<package>
Install these packages without verification? [y/N] 

Cause

The SEP GPG key is missing in the system keyring.

Solution

Install the key, as shown in the above section Configuring Debian repositories.

See also

SEP sesam Quick Install GuideDebianReleases