Source:Debian Repository: Difference between revisions
(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> | |||
{|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] | |||
|} | |||
=== | {|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]]. | |||
|} | |||
==== | {|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. | |||
|} | |||
==== | {|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 | ||
'''''Ubuntu-based systems''''' | |||
* Ubuntu 16.04 | * Ubuntu 16.04 (use the Debian Jessie packages) | ||
* Ubuntu 14.04 | * Ubuntu 14.04 (use the Debian Wheezy packages) | ||
For the details on supported systems, check [[Special:MyLanguage/SEP_sesam_OS_and_Database_Support_Matrix#Linux|SEP sesam OS and Database Support Matrix]]. | |||
{{ | == {{anchor|configuration}}Configuring Debian repositories == | ||
Note that all commands have to be executed as ''root'' user or ''administrator'', with the ''sudo'' command prefixed. | |||
=== 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 | |||
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> | |||
<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> | |||
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 | ||
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> | |||
<li>Run <tt>apt</tt> by using the command:</li> | |||
apt-get update | apt-get update | ||
to update the package lists. | to update the package lists. | ||
</ol> | |||
== | == {{anchor|components}}Searching and installing SEP sesam components == | ||
After successful configuration the system should be able to search/install and remove packages via | After successful configuration, the system should be able to search/install and remove packages via standard Debian package tools. | ||
=== | === {{anchor|search}}Searching for SEP sesam components === | ||
If the | 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 - | 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 | ||
=== | === {{anchor|install}}Installing SEP sesam components === | ||
This example shows how to install the sesam | 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> | ||
{{Note|All needed dependencies will be automatically installed.}} | |||
=== | === {{anchor|update}}Updating SEP sesam components === | ||
During | 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: | |||
<ul><li>If the package ''lsb-release'' is installed, the following command will show your system codename:</li> | |||
If the package | |||
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 | '''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 | '''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 | '''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]]. | |||
== | == 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.
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
- 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>
- Edit the sources list file.
- The system configuration file
/etc/apt/sources.list
has to be modified, as shown in the example below:
deb http://download.sep.de/linux/repositories/debian/ <DISTRIBUTION> main
Replace <DISTRIBUTION> 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/ jessie main
- Run apt by using the command: 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
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.