IceBreak Erste Schritte

Transkript

1 IceBreak Erste Schritte ( 2018 Markus A. Litters) Inhaltsverzeichnis 1. Voraussetzungen und Download Installation Aufruf des Administrationsservers Via 5250 Green Screen Via Browser Erstellen einer eigenen Serverinstanz Hallo IceBreak Öffnen IFS Freigabe Erstellen hallo.rpgle Aufruf hallo.rpgle Nächste Schritte Seite 1/13

2 1. Voraussetzungen und Download Vielen Dank, dass Sie sich für IceBreak interessieren. Bei IceBreak handelt es sich um den einzigen, nativen Web- und Applikationsserver für das Betriebssystem IBM i, der ohne Hilfe von Java, PASE oder Apache direkt als ILE Objekt im Betriebssystem IBM i läuft und daher unglaublich schnell ist. Damit Sie IceBreak verwenden können, benötigen Sie natürlich einen IBM POWER Server mit dem Betriebssystem IBM i. Grundsätzlich empfehle ich allen meinen Kunden eine Version einzusetzen, die noch mittels Technology Refreshs aktualisiert wird und auch die neuesten Technology Refreshs zu installieren. Derzeit wären dies die Versionen 7.2 und 7.3. IceBreak läuft aber auch mit älteren Versionen bis hin zur V5R4 von OS/400. Bevor Sie mit IceBreak beginnen können, müssen Sie sich das Produkt herunterladen und installieren. Auf dieser Seite finden Sie die jeweils aktuellste, frei gegebene Version von IceBreak. Laden Sie sie auf einen Windows PC herunter und führen dort das Programm IceBreakSetupxxxx.exe aus. Die Installation wird durch einen Assistenten begleitet, der Sie zunächst nach einem Verzeichnis frägt, in welches er die IBM i Sicherungsdatei uns das Installationsprogramm entpacken soll: Seite 2/13

3 2. Installation Hat der Download und das Entpacken, wie unter 1 Beschrieben, funktioniert, sehen Sie nun folgendes Bild, In welchem Sie noch einmal erfahren, was genau passiert. 1. Die Bibliothek IceBreak wird installiert 2. Ein gleichlautendes Subsystem 3. Ein Auto Start Job im kontrollierenden Subsystem, der dafür sorgt, dass IceBreak nach einem Neustart des Servers, automatisch neu gestartet wird. Mit Klick auf Next erhalten Sie die Lizenzinformationen und müssen bestätigen, dass Sie sie gelesen haben und damit einverstanden sind, um mit der Installation fortzufahren. Ein weiterer Klick auf Next zeigt Ihnen Eingabefelder, in welche Sie Ihren Namen, Adresse und Firmennamen bitte eintragen, um dann mit einem weiteren Klick auf Next auf die Seite zu kommen, in welche Sie die IP Adresse bzw. den DNS Namen Ihres IBM I Servers, sowie einen Benutzernamen mit Kennwort eintragen, der die Berechtigung haben muss, FTP Transfer durchzuführen, sowie Bibliotheken zu erstellen. Idealerweise ein Benutzer mit QSECOFR bzw. *ALLOBJ Rechten. Zumindest aber mit *IOSYSCFG Berechtigung. Seite 3/13

4 Ein weiterer Klick auf Next bringt Sie in dieses Bild: Hier geben Sie die Portnummer für den IceBreak Administrationsserver an. Der Standardwert lautet Ein weiterer Klick auf Next zeigt Ihnen eine Zusammenfassung Ihrer Eingaben und wartet darauf, dass Sie nun auf den Button Install klicken. Dieser startet die Installation. Via FTP werden die IceBreak Programme auf Ihren IBM i Server übertragen und dort installiert. Hat alles geklappt, erhalten Sie folgendes Bild: Seite 4/13

5 3. Aufruf des Administrationsservers Herzlichen Glückwunsch! Sie haben IceBreak erfolgreich auf Ihrem IBM i Server installiert. Wie Sie IceBreak administrieren können, erfahren Sie hier. 3.1 Via 5250 Green Screen Geben Sie in einer IBM i Befehlszeile folgendes ein und drücken die Datenfreigabe / Enter Taste: GO ICEBREAK Sie sehen nun folgendes Menü: Mit Auswahl 12 sehen Sie nun alle Serverinstanzen, die auf Ihrem System via IceBreak angelegt wurden. Nach Neuinstallation ist das lediglich die Admin Instanz. Mit der Funktionstaste F6 können Sie hier nun neue Instanzen erstellen. Dies zeige ich Ihnen jedoch unter Punkt 4 über die Weboberfläche von IceBreak. Seite 5/13

6 3.2 Via Browser Gehen Sie in den Browser Ihrer Wahl. Grundsätzlich funktioniert IceBreak mit jedem beliebigen Browser, genauso, wie die Anwendungen, die Sie nachher mit IceBreak erstellen. Sollte es in einer Browserversion, die Sie verwenden, irgendwelche Probleme geben, melden Sie diese bitte an mich, damit ich mir die Probleme mit meinen Kollegen zusammen anschauen kann. Geben Sie in der Browseradresseingabe ein: Die IP oder DNS Namen Ihres IBM i Servers, sowie die Portnummer, die Sie bei der Installation für die Admin Instanz angegeben haben. Standardmäßig ist das die Portnummer Hat alles geklappt, sollten Sie folgendes Anmeldebild sehen: Hierbei handelt es sich um ein IBM i Anmeldefenster. D.h. Sie geben hier Ihren IBM i Benutzernamen und Kennwort ein für den Benutzer, mit welchem Sie IceBreak verwalten wollen. Idealerweise ist dies der QSECOFR bzw. ein Benutzer mit ähnlichen Berechtigungen. Melden Sie sich also an und klicken auf Login. Seite 6/13

7 Sie sehen nun ein Bild, ähnlich diesem hier: Bei Ihnen wird unterhalb des Menüpunkts Active Servers jedoch nur die Admin Serverinstanz angezeigt. Wie Sie sich sicher vorstellen können, wurde auch diese Administrationsoberfläche mit IceBreak entwickelt. D.h. hier sehen Sie ein ganz normales RPG Programm, welches mittels IceBreak aus dem Browser heraus bedient wird. Da Sie mittels IceBreak jedes beliebige HTML/CSS/JavaScript verbinden können, sind Ihrer Oberflächengestaltungsphantasie keine Grenzen gesetzt. Seite 7/13

8 4. Erstellen einer eigenen Serverinstanz Damit Sie nun endlich los legen können, sollten Sie sich zunächst eine eigene IceBreak Serverinstanz erstellen. Dies können Sie entweder über den 5250 Green Screen oder über die Browseroberfläche. Damit Sie schon einmal einen Vorgeschmack auf die Möglichkeiten bekommen, die Ihnen IceBreak bietet, zeige ich Ihnen in dieser Anleitung den Weg über die Browseroberfläche. Sie starten den IceBreak Administrator in Ihrem Browser, wie unter Punkt 3.2 beschrieben. Klicken Sie nun links im Menü auf das Plus Zeichen vor Administration Klicken Sie nun auf Work with Servers Es öffnet sich im rechten Bereich ein neuer Tab, der die vorhandenen Serverinstanzen (bei Neuinstallation nur der Admin) anzeigt. In der nun dargestellten Anzeige klicken Sie bitte auf das Pluszeichen in der Überschriftzeile (im Bild blau umrahmt) Nun erscheint ein neues Fenster mit der Überschrift Create a IceBreak server Füllen Sie die Felder bitte entsprechend aus und vergeben Sie eine freie Portnummer für die Instanz. In meinem Beispiel ist es die 7400 für die Instanz mit dem Namen HUGO. Standardmäßig erstellt IceBreak eine Bibliothek mit dem gleichen Namen und ein IFS Verzeichnis unterhalb des /www Verzeichnisses. Diese Namen können Sie natürlich anpassen bzw. bereits vorhandene Bibliotheken verwenden. Wir empfehlen dennoch die Bibliothek, als auch das IFS Verzeichnis mit dem gleichen Namen wie die IceBreak Server Instanz zu versehen und idealerweise den vorgegebenen Standard zu Seite 8/13

9 verwenden Mit Klick auf den Create Button wird alles erstellt und Sie kehren in die Work with servers Anzeige zurück. Klicken Sie im Kopfbereich der Anzeige auf den aktualisieren Button (oder drücken Sie die F5 Taste) und Sie sehen Ihre soeben neu erstellte Server Instanz. Klicken Sie bitte die neu erstellte Instanz mit der rechten Maustaste an und klicken dort im Kontextmenü auf Start, damit die Serverinstanz startet Seite 9/13

10 5. Hallo IceBreak Herzlichen Glückwunsch! Sie haben IceBreak erfolgreich auf Ihrem IBM i Server installiert und eine erste, neue IceBreak Serverinstanz eingerichtet. Jetzt steht der Entwicklung von tollen, modernen und schnellen Web Anwendungen und Web Services in RPG oder Cobol nichts mehr im Weg. Damit Sie sehen, wie einfach es ist, mit IceBreak native IBM i Web Anwendungen zu erstellen, schreiben wir in diesem Kapitel unser erstes Hallo Welt Beispiel in dem Fall Hallo IceBreak. Alle Beispiele, die ich Ihnen in dieser und den anderen Dokumentationen zeige sind in der Programmiersprache RPG verfasst. Sollten Sie Beispiele in Cobol oder C/C++ benötigen, geben Sie mir bitte Bescheid und ich sende Ihnen solche zu. In den folgenden Punkten zeige ich Ihnen, wie Sie ein erstes IceBreak RPG Programm mit einfachen Bordmitteln von Windows erstellen. In einer separaten Dokumentation (inkl. Video Tutorial) erfahren Sie, wie Sie sehr komfortabel Ihre Webanwendungen in einem modernen Entwicklungswerkzeug erstellen können, welches wir für die Entwicklung von Web Anwendungen und Web Services empfehlen. Selbstverständlich können Sie aber auch ihre gewohnten Tools, wie z.b. IBM Rational Developer for i oder andere verwenden. 5.1 Öffnen IFS Freigabe Mit der Erstellung der eigenen IceBreak Serverinstanz unter Punkt 4 wurde auch automatisch eine Netzlaufwerkfreigabe mit dem Namen der Serverinstanz erstellt (in meinem Beispiel hugo). Gehen Sie also in den Windows Explorer (sollten Sie Linux oder einen Apple Mac bzw. Android verwenden und nicht wissen, wie Sie auf eine IBM i Freigabe zugreifen können, melden Sie sich bitte bei mir, damit wir dies gemeinsam durchgehen können) und öffnen Sie die Netzwerkfreigabe hugo. Seite 10/13

11 5.2 Erstellen hallo.rpgle Mit einem Rechtsklick, können Sie im Windows Explorer auf den Menüpunkt Neu gehen und dort auf den Untermenüpunkt Textdokument. Geben Sie nun als Namen ein hallo.rpgle Öffnen Sie dieses Dokument nun mit einem Editor Ihrer Wahl (z.b. Notepad oder Notepad++) und geben folgende Zeilen ein: Speichern Sie die Datei und wechseln Sie nun in den Browser Ihrer Wahl. 5.3 Aufruf hallo.rpgle Im Browser geben Sie nun ein: Vorname Als Beispiel: Der Browser sollte nun folgendes ausgeben: Seite 11/13

12 Ihre neu erstellte IceBreak Serverinstanz sucht nun im zugeordneten IFS Verzeichnis das angegebene RPG Programm. Wird es gefunden, prüft IceBreak, ob in der zugeordneten Bibliothek bereits ein Programmobjekt existiert und falls ja, ob es den gleichen Zeitstempel hat, wie der Quellcode im IFS. Falls es nicht existiert oder der Zeitstempel älter ist, wird ein neues Programmobjekt automatisch erzeugt. Dabei läuft zunächst ein IceBreak Precompiler, der den ggf. enthaltenen HTML/CSS/JavaScript/JSON/XML Code umwandelt und anschließend die normalen IBM RPG Compiler. Deshalb können Sie mit IceBreak auch jegliches RPG schreiben und verwenden, welches die IBM Compiler umwandeln können. Gleiches gilt natürlich auch für Cobol und C bzw. C++. Sollte die Umwandlung fehl schlagen, erhalten Sie im Browser eine entsprechende Anzeige inkl. der Umwandlungsliste und den markierten Fehlern. Komfortabler geht das Ganze noch in dem kostenlosen Editor Microsoft Visual Studio Code. Hierzu existiert eine separate Anleitung. Seite 12/13

13 6. Nächste Schritte Herzlichen Glückwunsch! Sie haben soeben Ihr erstes RPG Web Programm mit IceBreak erstellt und getestet. Sollte etwas nicht funktioniert haben, wie hier beschrieben, melden Sie sich bitte bei mir und teilen mir dies mit. Idealerweise mit einer kurzen , ggf. mit Screenshots und Fehlermeldungen. Wenn alles geklappt hat, schauen Sie sich bitte meine weiteren Anleitungen bzw. Video Tutorials auf meiner Website oder in YouTube an, um weitere Beispiele zu finden bzw. zu sehen, wie Sie sich eine moderne, schnelle und kostenlose Entwicklungsumgebung für Ihre IceBreak Web Anwendungen und Web Services einrichten können. Auch zeige ich Ihnen zahlreiche Beispiele, die ich kostenlos als Quellcode in GitHub veröffentliche. Hierzu lade ich Sie ebenfalls herzlich ein, um weitere Beispiele und Ideen einzubringen. Je mehr sich beteiligen, desto besser für alle. Innerhalb des IceBreak Administrators, können Sie auch auf die englischsprachige Dokumentation, das Programmiererhandbuch, sowie Tutorials zugreifen. Beachten Sie bitte hierzu, dass derzeit noch keine Beispiele für JSON und REST Webservices in dieser Dokumentation zu finden sind. Diese erhalten Sie in Kürze in Deutsch von mir. Seite 13/13