User Tools

Site Tools


k11:k11.10:k11.10.2:start

11.10.2 Installing the installation package on the target computer

11.10.2.1 Information about the target computer

The target computer was realized by cloning a virtual Mint-Master machine under VirtualBox on the author's development computer. As a result, the target computer always had a freshly installed Mint 17.1 system (Rebecca) for all installation experiments.

11.10.2.2 Necessary work on the target computer

A generated installation package contains only your Gambas project. In addition, it lists all dependencies that must be installed by the package manager on the target computer (recursively) before your installation package can be installed.

Here is a section of the DEBIAN/control file in an installation package with the list of dependencies:

Depends: 
gambas3-runtime (>= 3.6), 		' Gambas dependencies
gambas3-runtime (<< 3.99.0), 
gambas3-gb-args (>= 3.6), 
gambas3-gb-args (<< 3.99.0), 
gambas3-gb-image (>= 3.6), gambas3-gb-image (<< 3.99.0), 
ambas3-gb-qt4 (>= 3.6), gambas3-gb-qt4 (<< 3.99.0), 
gambas3-gb-form (>= 3.6), gambas3-gb-form (<< 3.99.0), 
gambas3-gb-settings (>= 3.6), 
gambas3-gb-settings (<< 3.99.0), 
gambas3-gb-qt4-ext (>= 3.6), 
gambas3-gb-qt4-ext (<< 3.99.0), 
bluefish (>= 2.2.5)			' Extra dependence

An advantage of installation packages is that you do not have to search for and resolve the dependencies yourself. These dependencies are automatically installed when they are available through the system's Package Manager. The package manager solves what is missing and gets exactly that from the repositories it knows. In order to resolve a Gambas package and automatically download missing packages, it is only necessary to specify a suitable Gambas package source and the target computer is online.

A first attempt to install a Gambas installation package with the gdebi package installer ended with this error message:

ERROR

Figure 11.10.2.2.2.1: Error message

A look at application management showed that

  • Gambas packages in MINT 17.1 are present in the package sources,
  • the gambas packages are only available in one version < 3.6 (? version: 3.1.1-2.2ubuntu4)

The simplest way - under Ubuntu and Mint - to add the matching Gambas packages in the stable version on the target computer is to use the PPA maintained by the 'Gambas Ubuntu Maintainers' team (→ chapter 2.3 Installation from Alternative Sources - PPA):

mint@linux ~ $ sudo add-apt-repository ppa:gambas-team/gambas3

You must then update the package sources absolutely:

mint@linux ~ $ sudo apt-get update

Here you can see the result: The Gambas package source is entered in the package manager of MINT:

B

Figure 11.10.2.2.2.2: PPA in the package manager

11.10.2.3 Installing the installation package on the target computer

Copy the IP_StructDB folder with the generated installation package from the development host into the home directory of the user of the database application StructDB on the target host:

IP

Figure 11.10.2.3.3.1: Contents of the installation package

In MINT 17, gdebi is a graphical installer for single packages installed, which can be used independently of the desktop. The program has the big advantage - in contrast to the dpgk program - that it reloads and installs dependencies from the package sources.

Start the gdebi package installer by double-clicking on the deb.file:

B

Figure 11.10.2.3.2: GUI package installer

Under Details (marked in red) look at the 11 packages (dependencies) that must be installed before installing StructDB.

Start the installation by clicking Install Package with the required root privileges.

First additional packages are downloaded, then the dependencies are installed and finally the program StructDB is installed:

B

Figure 11.10.2.3.3.3: Step 1: Download additional packages

B

Figure 11.10.2.3.3.4: Step 2: Install dependencies

B

Figure 11.10.2.3.3.5: Step 3: Installing the StructDB program

11.10.2.4 Performance monitoring

If you open the menu, you will see the StructDB program under the menu item “Office” (office), which you can start after double-clicking:

GUI

Figure 11.10.2.4.1: GUI program StructDB

To call up program help, press function key F1. With the Escape button you can close the help window, with the last button after the navigation you can call up information about the program developers, immediately start entering new data sets and saving them in a structure array and exporting this structure array with all data sets (serialized) to a file with the extension. sdb in a folder of your choice. Alternatively, you can import the database file example. sdb in the ~/StructDB folder:

Daten-Import

Figure 11.10.2.4.2: Data import

You can also call the program in the console; in the second case, with the (pattern) database file example. sdb in the ~/StructDB folder as an argument:

mint@linux ~ $ StructDB
mint@linux ~ $ StructDB -- /home/mint/StructDB/example.sdb

Icon

A double click on the file symbol starts the program StructDB with the database file example. sdb as argument.

11.10.2.5 Additions and alternatives

Local package sources

In paragraph 11.10.2.2.2 you will find the requirement that you must be online to reload missing packages. If this is not possible for the target computer, then use a local package source. These are package sources on data carriers (CD/DVD, USB stick, external hard disk) or in the local network (LAN). Under the link http://wiki.ubuntuusers.de/Lokale_Paketquellen you will find suggestions on how to create a local package source. Then specify your local package source in the Package Manager. Usually DVD/CD are already registered as default package source in the Package Manager, so no special action is required.

Start of the English program version

With this call you can start the program temporarily in the English version:

mint@linux ~ $ LC_ALL=en_GB.utf8 StructDB

EN

Figure 11.10.2.5.1: Program in the original English version

Alternative installation installation setup package

To successfully install the installation package in the ~/StructDB folder via the console, this quatrain is sufficient:

mint@linux ~ $ sudo add-apt-repository ppa:gambas-team/gambas3
mint@linux ~ $ sudo apt-get update
mint@linux ~ $ sudo dpkg --install ~/IP_StructDB/structdb_1.1.51-0ubuntu1_all.deb
mint@linux ~ $ sudo apt-get install --fix-broken 

Since the program dpkg does not automatically resolve the dependencies of the packages to be installed, you must call the 4th command with the option –fix-broken or -f - without specifying package names - to install missing dependencies.

Program start variant

Programmstart

Figure 11.10.2.5.2: Program start by double-clicking on the file icon

Gambas on the development computer

The package manager, which installs the .deb-package on the target computer, checks whether all dependencies are fulfilled. The manager only knows the packages he has installed himself! Even if you compiled and successfully installed Gambas → chapters 2.1 to 2.5 on the target computer yourself, for example, and successfully installed it - but this does not mean that you can't successfully install a Gambas installation package! When creating the installation package on the development computer, only the package names are entered as dependencies, for example “gambas3-gb-settings”, if the project uses the component gb. settings. Since these names are standardized, the entries can be made independently of the locally installed packages on the development computer. Therefore, there are no requirements as you have installed Gambas on the development computer (!) - but the recommendation is that you always uninstall an existing Gambas installation before installing.

Download

11.10.2 Installationspaket auf dem Zielrechner installieren

11.10.2.1 Informationen zum Zielrechner

Der Zielrechner wurde durch das Klonen einer virtuellen Mint-Master-Maschine unter VirtualBox auf dem Entwicklungsrechner des Autors realisiert. Dadurch verfügte der Zielrechner für alle Installations-Experimente stets über ein frisch installiertes System Mint 17.1 (Rebecca).

11.10.2.2 Notwendige Arbeiten auf dem Ziel-Rechner

Ein generiertes Installationspaket enthält nur Ihr Gambas-Projekt. Zusätzlich listet es alle Abhängigkeiten auf, die notwendigerweise vom Paket-Manager auf dem Ziel-Rechner (rekursiv) installiert werden müssen, bevor Ihr Installationspaket installiert werden kann.

Hier ein Ausschnitt aus der Datei /DEBIAN/control in einem Installationspaket mit der Liste der Abhängigkeiten:

Depends: 
gambas3-runtime (>= 3.6), 		' Gambas-Abhängigkeiten
gambas3-runtime (<< 3.99.0), 
gambas3-gb-args (>= 3.6), 
gambas3-gb-args (<< 3.99.0), 
gambas3-gb-image (>= 3.6), gambas3-gb-image (<< 3.99.0), 
ambas3-gb-qt4 (>= 3.6), gambas3-gb-qt4 (<< 3.99.0), 
gambas3-gb-form (>= 3.6), gambas3-gb-form (<< 3.99.0), 
gambas3-gb-settings (>= 3.6), 
gambas3-gb-settings (<< 3.99.0), 
gambas3-gb-qt4-ext (>= 3.6), 
gambas3-gb-qt4-ext (<< 3.99.0), 
bluefish (>= 2.2.5)			' Extra-Abhängigkeit

Ein Vorzug von Installationspaketen liegt darin, dass Sie die Abhängigkeiten nicht selbst heraussuchen und auflösen müssen. Diese Abhängigkeiten werden automatisch installiert, wenn sie über den Paket-Manager des Systems verfügbar sind. Der Paketmanager löst auf was fehlt und genau das holt er aus den ihm bekannten Repositories. Um ein Gambas-Paket auflösen zu können und sich fehlende Pakete automatisch herunterladen zu können ist nur erforderlich, dass eine passende Gambas-Paketquelle angegeben wird und der Ziel-Rechner online ist.

Ein erster Installationsversuch eines Gambas-Installationspakets mit dem gdebi-Paket-Installationsprogramm endete mit dieser Fehlermeldung:

ERROR

Abbildung 11.10.2.2.1: Fehlermeldung

Ein Blick in die Anwendungsverwaltung zeigte, dass

  • Gambas-Pakete in MINT 17.1 in den Paket-Quellen vorhanden sind,
  • die Gambas-Pakete nur in einer Version < 3.6 vorliegen (→ Version: 3.1.1-2.2ubuntu4)

Die einfachste Art – unter Ubuntu und Mint – die passenden Gambas-Pakete in der stabilen Version auf dem Ziel-Rechner hinzuzufügen besteht darin, das vom 'Gambas Ubuntu Maintainers'-Team gepflegte PPA (→ Kapitel 2.3 Installation aus alternativen Quellen – PPA) zu verwenden:

mint@linux ~ $ sudo add-apt-repository ppa:gambas-team/gambas3

Anschließend müssen Sie die Paket-Quellen unbedingt aktualisieren:

mint@linux ~ $ sudo apt-get update

Hier sehen Sie das Ergebnis: Die Gambas-Paket-Quelle ist im Paket-Manager von MINT eingetragen:

B

Abbildung 11.10.2.2.2: PPA im Paketmanager

11.10.2.3 Installationspaket auf dem Zielrechner installieren

Kopieren Sie den Ordner IP_StructDB mit dem erzeugten Installationspaket vom Entwicklungsrechner in das Home-Verzeichnis des Benutzers der Datenbank-Anwendung StructDB auf dem Ziel-Rechner:

IP

Abbildung 11.10.2.3.1: Inhalt des Installationspakets

In MINT 17 ist mit gdebi ein grafisches Installationsprogramm für Einzelpakete installiert, das desktop-unabhängig eingesetzt werden kann. Das Programm hat den großen Vorteil – im Gegensatz zum Programm dpgk – dass es benötigte Abhängigkeiten aus den Paket-Quellen nachlädt und installiert.

Starten Sie das gdebi-Paket-Installationsprogramm mit einem Doppelklick auf die deb.Datei:

B

Abbildung 11.10.2.3.2: GUI Paket-Installationsprogramm

Sehen Sie sich unter Details (rot markiert) die 11 Pakete (Abhängigkeiten) an, die vor der Installation des Programms StructDB installiert werden müssen.

Starten Sie die Installation mit einem Klick auf Paket installieren mit den eingeforderten Root-Rechten.

Zuerst werden zusätzliche Pakete heruntergeladen, danach die Abhängigkeiten installiert und abschließend wird das Programm StructDB installiert:

B

Abbildung 11.10.2.3.3: 1. Schritt: Zusätzliche Pakete herunterladen

B

Abbildung 11.10.2.3.4: 2. Schritt: Abhängigkeiten installieren

B

Abbildung 11.10.2.3.5: 3. Schritt: Das Programm StructDB wird installiert

11.10.2.4 Erfolgskontrolle

Öffnen Sie das Menü, so sehen Sie unter dem Menü-Eintrag “Büro” (office) das Programm StructDB, das Sie nach einem Doppelklick starten können:

GUI

Abbildung 11.10.2.4.1: GUI Programm StructDB

Eine Programm-Hilfe rufen Sie mit der Funktionstaste F1 auf. Mit der Escape-Taste schließen Sie das Hilfefenster. Mit dem letzten Button nach der Navigation können Sie Informationen zu den Programmentwicklern aufrufen. Sie können sofort damit beginnen neue Datensätze einzugeben und in einem Struct-Array abzuspeichern sowie dieses Struct-Array mit allen Datensätzen (serialisiert) in eine Datei mit der Extension .sdb in einen Ordner Ihrer Wahl zu exportieren. Alternativ können Sie die mit installierte Datenbank-Datei example.sdb im Ordner ~/StructDB importieren:

Daten-Import

Abbildung 11.10.2.4.2: Daten-Import

Sie können das Programm auch in der Konsole aufrufen; im zweiten Fall mit der (Muster-)Datenbank-Datei example.sdb im Ordner ~/StructDB als Argument:

mint@linux ~ $ StructDB
mint@linux ~ $ StructDB -- /home/mint/StructDB/example.sdb

Wechseln Sie in den beim ersten Programmstart angelegten Ordner StructDB, so sehen Sie die dorthin kopierte Datei example.sdb mit eigenem Datei-Icon:

Icon

Ein Doppelklick auf das Datei-Symbol startet das Programm StructDB mit der Datenbank-Datei example.sdb als Argument.

11.10.2.5 Ergänzungen und Alternativen

Lokale Paket-Quellen

Im Absatz 11.10.2.2 findet man die Forderung, dass man online sein muss, um fehlende Pakete nachzuladen. Ist das für den Ziel-Rechner nicht zu realisieren, dann nutzen Sie doch eine lokale Paketquelle. Das sind Paketquellen auf Datenträgern (CD/DVD, USB-Stick, externer Festplatte) oder im lokalen Netz (LAN). Unter dem Link http://wiki.ubuntuusers.de/Lokale_Paketquellen finden Sie Anregungen, wie Sie eine lokale Paketquelle anlegen. Geben Sie dann im Paket-Manager Ihre lokale Paketquelle an. Normalerweise sind DVD/CD bereits als Default-Paketquelle im Paket-Manager registriert, so dass hier keine gesonderte Aktion nötig ist.

Start der englischen Programm-Version

Mit diesem Aufruf gelingt es Ihnen das Programm temporär in der englischen Version zu starten:

mint@linux ~ $ LC_ALL=en_GB.utf8 StructDB

EN

Abbildung 11.10.2.5.1: Programm in der englischen Original-Version

Alternative Installation Installationspaket

Um das Installationspaket im Ordner ~/StructDB erfolgreich über die Konsole zu installieren, genügt dieser Vierzeiler:

mint@linux ~ $ sudo add-apt-repository ppa:gambas-team/gambas3
mint@linux ~ $ sudo apt-get update
mint@linux ~ $ sudo dpkg --install ~/IP_StructDB/structdb_1.1.51-0ubuntu1_all.deb
mint@linux ~ $ sudo apt-get install --fix-broken 

Da das Programm dpkg die Abhängigkeiten der zu installierenden Pakete nicht automatisch auflöst, müssen Sie das 4. Kommando mit der Option “–fix-broken” oder -f aufrufen – ohne Angabe von Paketnamen – damit fehlende Abhängigkeiten nachinstalliert werden.

Programm-Start-Variante

Programmstart

Abbildung 11.10.2.5.2: Programmstart mit Doppelklick auf das Datei-Icon

Gambas auf dem Entwicklungsrechner

Der Paketmanager, der das .deb-Paket auf dem Ziel-Rechner installiert prüft, ob alle Abhängigkeiten erfüllt sind. Der Manager kennt nur die Pakete, die er selbst installiert hat! Auch wenn Sie Gambas → Kapitel 2.1 bis 2.5 zum Beispiel auf dem Ziel-Rechner selbst kompiliert und mit Erfolg installiert haben – aber damit an der Paketverwaltung vorbei – gelingt es Ihnen nicht, ein Gambas-Installationspaket erfolgreich zu installieren! Beim Erzeugen des Installationspakets auf dem Entwicklungsrechner werden nur die Paketnamen als Abhängigkeiten eingetragen, zum Beispiel “gambas3-gb-settings”, falls das Projekt die Komponente gb.settings benutzt. Da diese Namen standardisiert sind, können die Eintragungen unabhängig von den lokal installierten Paketen auf dem Entwicklungsrechner vorgenommen werden. Daher gibt es keine Forderungen, wie Sie Gambas auf dem Entwicklungsrechner(!) installiert haben – wohl aber die Empfehlung, vor der Installation stets eine De-Installation einer bestehenden Gambas-Installation vorzunehmen.

Download

The website uses a temporary session cookie. This technically necessary cookie is deleted when the browser is closed. You can find information on cookies in our privacy policy.
k11/k11.10/k11.10.2/start.txt · Last modified: 02.07.2018 (external edit)

Page Tools