Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

...

Was kann TIM für Sie tun?

TIM is a piece of software on your IBM i designed to make installing and keeping up-to-date of Toolmaker's software on your IBM i as simple and easy as it is on your smartphone.So, once you have TIM up and running you can let it manage the installation and updates of these Toolmaker productsist eine Software auf Ihrer IBM i, die die Installation und Aktualisierung von Toolmaker-Software auf Ihrer IBM i so einfach und bequem macht wie auf Ihrem Smartphone.

Wenn Sie TIM einmal eingerichtet haben, können Sie die Installation und Aktualisierung dieser Toolmaker-Produkte von TIM verwalten lassen:

  • directfax
  • directmail & directspool
  • directarchiv
  • RPG Web Experience - formerly known as früher bekannt als WOPiXX
  • directdial
  • directsync4i
  • infostore App

...with successively more to come in the future.

Installing a software

All you have to do is to select a software from the list above and assign an order to TIM to install it. You may also tell TIM to install the software on a specific day and time. TIM will then automatically retrieve all necessary objects from our server and place the software on your IBM i. Then you can simply install the licence and configure the software to your individual needs.

Automatic update

If you let it, TIM can periodically check the Toolmaker Software Distribution Server for updates and install them.

You can configure whether this shall happen automatically or with some amount of human intervention.

How do I work with TIM?

You assign orders to TIM. The most popular orders are

  • INSTALL_PRODUCT - Installs either a product completely new or a major of an already installed product
  • INSTALL_PTF - Installs a PTF for an already installed product
  • REMOVE_ORDER - Deletes all "transport"-libraries that were needed for the installation of a product or a PTF

You start by going to TIM's main menu:

GO TIMENG

The main menu lets you execute all tasks with and for TIM. (On a German system you would GO TIM).

Image Removed

The most important options here are:

1. Display status -  find out, what's going on

2. Create TIM order - start a task for TIM

26. Start TIM SBS - run the tasks created in subsystem TMSTIM

Also, when asked for your system's information for the creation of a license file you will use

6. Display system values + products - this gives you a nice summary of all important system values, etc.

INSTALL_PRODUCT - A new product or a major version

The version numbers of Toolmaker products generally follow this namingund es werden in Zukunft sukzessive weitere hinzukommen.

Installieren einer Software

Alles, was Sie tun müssen, ist, eine Software aus der obigen Liste auszuwählen und TIM einen Auftrag zu erteilen, sie zu installieren. Sie können TIM auch anweisen, die Software an einem bestimmten Tag und zu einer bestimmten Uhrzeit zu installieren. TIM ruft dann automatisch alle erforderlichen Objekte von unserem Server ab und platziert die Software auf Ihrer IBM i. Dann können Sie einfach die Lizenz installieren und die Software nach Ihren individuellen Bedürfnissen konfigurieren.

Automatische Aktualisierung

Wenn Sie es zulassen, kann TIM in regelmäßigen Abständen den Toolmaker Software Distribution Server auf Updates überprüfen und diese installieren.

Sie können konfigurieren, ob dies automatisch oder mit einem gewissen Maß an menschlichem Zutun geschehen soll.

Wie arbeite ich mit TIM?

Sie weisen TIM Aufträge zu. Die am häufigsten verwendeten Aufträge sind

  • INSTALL_PRODUCT - Installiert entweder ein komplett neues Produkt oder eine Hauptversion eines bereits installierten Produkts
  • INSTALL_PTF - Installiert ein PTF für ein bereits installiertes Produkt
  • REMOVE_ORDER - Löscht alle "Transport"-Bibliotheken, die für die Installation eines Produkts oder eines PTFs benötigt wurden

Sie beginnen, indem Sie das Hauptmenü von TIM aufrufen:

GO TIMENG

Über das Hauptmenü können Sie alle Aufgaben mit und für TIM ausführen. (Auf einem deutschen System würden Sie GO TIM).

Image Added

Die wichtigsten Optionen hier sind:

1.status anzeigen - finden Sie heraus, was vor sich geht

2. TIM-Auftrag erstellen - eine Aufgabe für TIM starten

26. TIM SBS starten - die im Subsystem TMSTIM erstellten Aufgaben ausführen

Wenn Sie nach den Informationen zu Ihrem System für die Erstellung einer Lizenzdatei gefragt werden, verwenden Sie außerdem

6. Systemwerte + Produkte anzeigen - damit erhalten Sie eine schöne Zusammenfassung aller wichtigen Systemwerte usw.

INSTALL_PRODUCT - Ein neues Produkt oder eine Hauptversion

Die Versionsnummern von Toolmaker-Produkten folgen im Allgemeinen dieser Benennung: version.release.ptf.

For exampleZum Beispiel: 5.50.12 means version bedeutet Version 5, release Release 50, PTF-level Level 12

A change in the version- or release number is considered a major update. So, when you go from Eine Änderung der Versions- oder Versionsnummer wird als großes Update betrachtet. Wenn Sie also von 5.50.12 to auf 5.51 you will need an wechseln, benötigen Sie ein INSTALL_PRODUCT.

Of course, when the product is not yet installed on your IBM i, you need an INSTALL_PRODUCT, too.

Start the INSTALL_PRODUCT order

Use option 2 (or F11 from the TIM Status Screen) and select INSTALL_PRODUCT to start the installation of a new product or a major update:

Image Removed

TIM will download the most current info files and let you select one:

Image Removed

Now, TIM downloads some documentation that might be handy.

Finally you are asked when to install the software:

Image Removed

When you select option 3=Immediately,TIM will start installing (or updating) the software right away. In this case you must make sure that none of the software's resources are blocked, i.e. by a user using it.

When you select option 1 or 2 and start the subsystem, TIM will download the files that it needs for the installation immediately but delay the installation until the time that you give.

Note
iconfalse
titleTIM subsystem must be active

Remember: regardless of the option you use, you must start the TIM subsystem. As long as the subsystem is inactive, nothing will happen.

Now, go back to TIM's main menu and select option 1=Display status TIM

Image Removed

Image Removed

You will find your order in status "NEW" but in the lower section the three "Current Work" lines are yet empty.

Also, TIM informs you in the upper part that "The sub system TMSTIM is not started". So, we need to start the subsystem.

Start the TIM subsystem ("TMSTIM")

In order to do this go back to TIM's main menu and select option 26:

Image Removed

This will start the subsystem and TIM will start working.

Now, select option 1 again to get back into the status display.

Image Removed

Now the message in the upper sections says SBS TIM is active, which is, what we want:

Image Removed

First, the still is no activity to be observed in the lower Current Work section. Please be patient.

After a couple of minutes press F5.

If you have waited long enough, you will see some activity go on. If not, wait longer and press F5 again.

Image Removed

Now the Remark column has gone to -active- and in the lower section you see that the activity has started.

By pressing F5 every now and then you will see changes in this progress information.

...

Wenn das Produkt noch nicht auf Ihrer IBM i installiert ist, benötigen Sie natürlich auch ein INSTALL_PRODUCT.

Starten Sie den INSTALL_PRODUCT-Auftrag

Verwenden Sie Option 2 (oder F11 auf dem TIM-Statusbildschirm) und wählen Sie INSTALL_PRODUCT, um die Installation eines neuen Produkts oder eines größeren Updates zu starten:

Image Added

TIM lädt die aktuellsten Infodateien herunter und lässt Sie eine auswählen:

Image Added

Nun lädt TIM einige Dokumentationen herunter, die Ihnen nützlich sein könnten.

Schließlich werden Sie gefragt, wann Sie die Software installieren möchten:

Image Added

Wenn Sie Option 3=Sofort wählen, beginnt TIM sofort mit der Installation (oder Aktualisierung) der Software. In diesem Fall müssen Sie sicherstellen, dass keine Ressourcen der Software blockiert sind, z.B. durch einen Benutzer, der sie benutzt.

Wenn Sie Option 1 oder 2 wählen und das Subsystem starten, wird TIM herunterladen die Dateien, die es für die Installation benötigt, sofort, aber verzögern Sie die installation bis zu der von Ihnen angegebenen Zeit.


Note
iconfalsch
titleTIM-Subsystem muss aktiv sein

Denken Sie daran: Unabhängig davon, welche Option Sie wählen, müssen Sie das TIM-Subsystem starten. Solange das Subsystem nicht aktiv ist, wird nichts passieren.


Gehen Sie nun zurück zum Hauptmenü von TIM und wählen Sie die Option 1=Status TIM anzeigen

Image Added

Image Added

Sie finden Ihre Bestellung im Status "NEU", aber im unteren Bereich die die drei Zeilen "Aktuelle Arbeit" sind noch leer.

Außerdem informiert Sie TIM im oberen Teil darüber, dass "Das Subsystem TMSTIM ist nicht gestartet". Wir müssen also das Subsystem starten.

Starten Sie das TIM-Subsystem ("TMSTIM")

Gehen Sie dazu zurück zum Hauptmenü von TIM und wählen Sie die Option 26:

Image Added

Dadurch wird das Subsystem gestartet und TIM beginnt zu arbeiten.

Wählen Sie nun erneut die Option 1, um wieder zur Statusanzeige zu gelangen.

Image Added

Die Meldung im oberen Bereich lautet nun SBS TIM ist aktivdas ist, was wir wollen:

Image Added


Zunächst ist im unteren Abschnitt Aktuelle Arbeit noch keine Aktivität zu beobachten Bitte haben Sie etwas Geduld.

Nach ein paar Minuten drücken Sie F5.

Wenn Sie lange genug gewartet haben, werden Sie sehen, dass sich etwas tut. Wenn nicht, warten Sie länger und drücken Sie erneut F5.

Image Added

Jetzt ist die Spalte Bemerkung auf -aktiv- und im unteren Bereich sehen Sie, dass die Aktivität begonnen hat.

Wenn Sie ab und zu F5 drücken, sehen Sie Änderungen in dieser Fortschrittsanzeige.

  • Phase 1 - Produktprüfung läuft
    • Wiederherstellung von Objekten
    • Migration von Objekten
    • ...
  • Phase 2 - Die Installation is in process
    • Checking locks

In "real life" you will probably leave TIM alone at this state and come back after a while to look at the results.

Installation complete

When the installation finishes completely then the status display will show this (this screenshot has been taken after a different installation, so please do not worry about the product name differing from the previous screen shots):

Image Removed

...

  • wird durchgeführt
    • Überprüfung der Sperren

Im "wirklichen Leben" werden Sie TIM in diesem Zustand wahrscheinlich in Ruhe lassen und nach einer Weile zurückkommen, um sich die Ergebnisse anzusehen.

Installation abgeschlossen

Wenn die Installation vollständig abgeschlossen ist, zeigt die Statusanzeige dies an (dieser Screenshot wurde nach einer anderen Installation aufgenommen, also bitte keine Sorge, dass der Produktname von den vorherigen Screenshots abweicht):

Image Added

  • Der Status der einzelnen Aufträge ist auf ABGESCHLOSSEN
  • Die Bemerkung lautet jetzt REMOVE aktiv. Das bedeutet, dass Sie die Bestellung jetzt jederzeit entfernen können (TIM tut dies nicht automatisch).
Note
iconfalsefalsch
titleRollback possible until order removed

As long as the order is not removed you can do a rollback to go back to the previous version. The order RECOVER_PRODINSTALL will accomplish this. So you will probably wait a couple of days before you remove an order, to make sure that the new version works satisfactorily.

This completes a normal installation:

...

möglich, bis die Bestellung entfernt wird

Solange der Auftrag nicht entfernt ist, können Sie ein Rollback durchführen, um zur vorherigen Version zurückzukehren. Der Befehl RECOVER_PRODINSTALL wird dies ermöglichen. Sie werden also wahrscheinlich ein paar Tage warten, bevor Sie einen Auftrag entfernen, um sicherzustellen, dass die neue Version zufriedenstellend funktioniert.

Damit ist eine normale Installation abgeschlossen:

  • neuinstallation eines Produkts, das zuvor nicht auf Ihrer IBM i installiert war
  • update-Installation einer neuen Version, zum Beispiel
    • 4.28 → 5.00
    • 5.50 → 5.51

Next we will look at the installation of a PTF, likeAls nächstes sehen wir uns die Installation eines PTFs an, z.B: 5.51.01 → 5.51.02

...

Installation eines PTFs (d.h. 5.51.01 → 5.51.02)

Installing a PTF for an existing installation is basically the same as installing a product. You only use the order type INSTALL_PTF instead of Die Installation eines PTFs für eine bestehende Installation ist im Grunde dasselbe wie die Installation eines Produkts. Sie verwenden nur die Auftragsart INSTALL_PTF anstelle von INSTALL_PRODUCT.

You start from TIMs main menu. Then you can either start the order directly with option 2-Create TIM order, or you can go to the status display and start the order using F11.

In this example we choose to go via the status display: select option 1-Display status TIM of the main menu Sie starten aus dem Hauptmenü von TIM. Dann können Sie die Bestellung entweder direkt mit der Option 2 - TIM-Bestellung erstellen starten oder Sie gehen zur Statusanzeige und starten die Bestellung mit F11.

In diesem Beispiel entscheiden wir uns für den Weg über die Statusanzeige: Wählen Sie im Hauptmenü die Option 1-Status TIM anzeigen(GO TIMENG)

This will take you to TIM's status display:

Press F11 to start the new orderDadurch gelangen Sie zur Statusanzeige von TIM:

Drücken Sie F11 um den neuen Auftrag zu starten:

Select Wählen Sie INSTALL_PTF from the list of options aus der Liste der Optionen:

From the list of software products select the product for which you want (or have been told by Hotline) to install the PTFWählen Sie aus der Liste der Softwareprodukte das Produkt aus, für das Sie das PTF installieren möchten (oder von der Hotline dazu aufgefordert wurden):

In this example we select INFOSTA, because at the time that this document is written, this system (DEAET03) is in need for a PTF for the Infostore App. This must not necessarily be true for your system.

From the list of available PTFs select the one desired:

Image Removed

You can now see that the system downloads some documentation

Image Removed

The next steps are identical with the ones for a PRODUCT_INSTALL.

You choose when to install (immediately, at a given time, hold until started) - and then you start the subsystem (if not started yet)

After some minutes you will see that TIM starts working:

Image Removed

And when the PTF-installation is completed it will show this accordingly:

Image Removed

...

diesem Beispiel wählen wir INFOSTA, weil dieses System (DEAET03) zum Zeitpunkt der Erstellung dieses Dokuments ein PTF für die Infostore App benötigt. Das muss nicht unbedingt auf Ihr System zutreffen.

Wählen Sie aus der Liste der verfügbaren PTFs das gewünschte aus:

Image Added

Sie können nun sehen, dass das System einige Dokumentationen herunterlädt

Image Added

Die nächsten Schritte sind identisch mit denen für eine PRODUCT_INSTALL.

Sie wählen aus, wann die Installation erfolgen soll(sofort, zu einem bestimmten Zeitpunkt, warten, bis sie gestartet wird) - und dann starten Sie das Subsystem (falls es noch nicht gestartet wurde)

Nach einigen Minuten werden Sie sehen, dass TIM zu arbeiten beginnt:

Image Added

Und wenn die PTF-Installation abgeschlossen ist, wird dies entsprechend angezeigt:

Image Added

Damit ist die PTF-Installation abgeschlossen. Sie können den Auftrag entfernen, indem Sie einen REMOVE_ORDER für diesen Auftrag ausgeben.

Note
iconfalse
titleRollback possible until order removed

As long as the order is not removed you can do a rollback to go back to the previous version. The order RECOVER_PTF will accomplish this. So you will probably wait a couple of days before you remove an order, to make sure that the new version works satisfactorily.

Dealing with issues

What happens, when someone is using the software during installation?

During installation noone can/should use the software, because there are objects that need to be exchanged/deleted, etc. So TIM checks whether any of the objects are in use and if so, tells you about it.

It quits all activity and tells you to press F10 for more information:

Image Removed

Press F10 and see, what's the problem:

Image Removed

TIM will inform you in the Errorcode-column of the nature of the issue that caused the interruption.

...

möglich, bis der Auftrag entfernt wird

Solange der Auftrag nicht entfernt ist, können Sie ein Rollback durchführen, um zur vorherigen Version zurückzukehren. Dies wird durch den Befehl RECOVER_PTF bewerkstelligt. Sie werden also wahrscheinlich ein paar Tage warten, bevor Sie einen Auftrag entfernen, um sicherzustellen, dass die neue Version zufriedenstellend funktioniert.

Umgang mit Problemen

Was passiert, wenn jemand die Software während der Installation benutzt?

Während der Installation kann/sollte niemand die Software verwenden, da es Objekte gibt, die ausgetauscht/gelöscht werden müssen usw. TIM prüft also, ob eines der Objekte in Gebrauch ist, und wenn ja, informiert es Sie darüber.

Es beendet alle Aktivitäten und fordert Sie auf, F10 zu drücken, um weitere Informationen zu erhalten:

Image Added

Drücken Sie F10 und sehen Sie nach, was das Problem ist:

Image Added

TIM informiert Sie in der Fehlercode-Spalte über die Art des Problems, das die Unterbrechung verursacht hat.

Es gibt verschiedene Fehlercodes, in diesem Fall ist es ERR_INUSE, was bedeutet, dass noch Aufträge an Objekten hängen, die ersetzt werden müssen, usw.