.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt =========================== EXT: Name of your Extension =========================== :Author: Christopher :Created: 2010-12-18T19:57:23 :Changed by: Christian Nölle :Changed: 2012-03-12T14:25:48.490000000 :Classification: extension key :Description: The keywords help with categorizing and tagging of the manuals. You can combine two or more keywords and add additional keywords yourself. Please use at least one keyword from both lists. If your manual is NOT in english, see next tab "language" ---- forEditors (use this for editors / german "Redakteure") forAdmins (use this for Administrators) forDevelopers (use this for Developers) forBeginners (manuals covering TYPO3 basics) forIntermediates (manuals going into more depth) forAdvanced (covering the most advanced TYPO3 topics) see more: http://wiki.typo3.org/doc_template#tags ---- :Keywords: keywords comma-separated :Author: Christopher :Email: Chrissitopher@gmx.de :Language: en .. _img-1-img-2-EXT-Signaling-system-for-caretaker: |img-1| |img-2| EXT: Signaling system for caretaker =================================================== Extension Key: buw\_caretakersignal Language: en Version: 0.1.4 Keywords: signal system, monitoring, caretaker Copyright 2012, Christian Nölle, This document is published under the Open Content License available from http://www.opencontent.org/opl.shtml The content of this document is related to TYPO3 \- a GNU/GPL CMS/Framework available from www.typo3.org .. _Table-of-Contents: Table of Contents ----------------- **`EXT: Signaling system for caretaker 1 <#1.EXT:%20Signaling%20system%20for%20caretaker%20|outline>`_** **`Introduction 3 <#1.1.Introduction|outline>`_** `What does it do? 3 <#1.1.1.What%20does%20it%20do_|outline>`_ `Screenshots 3 <#1.1.2.Screenshots|outline>`_ **`Users manual 4 <#1.2.Users%20manual|outline>`_** `Available fields 4 <#1.2.1.Available%20fields|outline>`_ **`Administration 5 <#1.3.Administration|outline>`_** **`Configuration 6 <#1.4.Configuration|outline>`_** `Installation 6 <#1.4.1.Installation|outline>`_ `Preperation for usage 6 <#1.4.2.Preperation%20for%20usage|outline>`_ `Reference 6 <#1.4.3.Reference|outline>`_ **`Known problems 8 <#1.5.Known%20problems|outline>`_** **`To-Do list 9 <#1.6.To-Do%20list|outline>`_** .. _Introduction: Introduction ------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ Provides a boiled down status of your caretaker monitored servers for your website. In a normal monitoring setup you will have your caretaker server within a controlled network, which is not accessible from outside. Thus the nice graphs caretaker is painting are only visible to yourself ;). With this extension you can easily add a “status page” to your public website, providing your customers the state of certain machines / tests. Uses the caretaker eID mechanism to retrieve the data. So make sure that caretaker is configured to provide information via eID and you webserver can access the eID interface of your caretaker server. .. _Screenshots: Screenshots ^^^^^^^^^^^ |img-3| |img-4| Users manual ------------ Insert the extension as page content element “Plugin” on a page of your choice. After that, you will have to fill out the fields “Instance” and “Test” properly, otherwise you will get an error, as the extension is not able to retrieve the results from your caretaker server. .. _Available-fields: Available fields ^^^^^^^^^^^^^^^^ **Name** Name of the content element that will be displayed as header (e.g. server identifier). **Instance** Number of the instance as defined in your caretaker server. **Test** Number of the specific test you would like to show. Must be assigned to the instance! **Text** Some free text field. You can enter any information you like. For example, if you have a scheduled downtime, here is the place to announce this to your users. Please note, that the fields “Instance” and “Test” are numerical and must be retrieved from the caretaker server. If they are not properly defined or wrong, you will not be able to display proper results. .. _Administration: Administration -------------- In case that your editors should be able to work with this extension as well, please make sure, that the exclude fields of the extension in the user groups access list are enabled. |img-5| Configuration ------------- .. _Installation: Installation ^^^^^^^^^^^^ Import and install via the extension manager. Nothing special, no database queries or configuration needed. .. _Preperation-for-usage: Preperation for usage ^^^^^^^^^^^^^^^^^^^^^ Before you and your editors can use this extension, make sure that the static template record for buw\_caretakersignal is added to your TypoScript page template (or extension template). Please define the URL of the caretaker server afterwards in the setup section of your template. .. _Reference: Reference ^^^^^^^^^ **plugin.tx\_buwcaretakersignal\_pi1** .. ### BEGIN~OF~TABLE ### .. _server: server """""" .. container:: table-row Property server Data type string Description Address of your caretaker server. Default .. ###### END~OF~TABLE ###### [tsref:plugin.tx\_buwcaretakersignal\_pi1] **plugin.tx\_buwcaretakersignal\_pi1.state** .. ### BEGIN~OF~TABLE ### .. _due: due """ .. container:: table-row Property due Data type wrap Description Wraps the due item. Default \| .. _ack: ack """ .. container:: table-row Property ack Data type wrap Description Wraps the ack item. Default \| .. _undef: undef """"" .. container:: table-row Property undef Data type wrap Description Wraps the undef item. Default \| .. _ok: ok "" .. container:: table-row Property ok Data type wrap Description Wraps the ok item Default \| .. _warn: warn """" .. container:: table-row Property warn Data type wrap Description Wraps the warn item Default \| .. _err: err """ .. container:: table-row Property err Data type wrap Description Wraps the err item Default \| .. ###### END~OF~TABLE ###### [tsref:plugin.tx\_buwcaretakersignal\_pi1.state] **plugin.tx\_buwcaretakersignal\_pi1.timestamp** .. ### BEGIN~OF~TABLE ### .. _allWrap: allWrap """"""" .. container:: table-row Property allWrap Data type wrap Description Wraps the timestamp objekt Default \| .. _strftime: strftime """""""" .. container:: table-row Property strftime Data type wrap Description Defines the output format of the timestamp Default %d.%m.%Y %T .. ###### END~OF~TABLE ###### [tsref:plugin.tx\_buwcaretakersignal\_pi1.timestamp] .. _Known-problems: Known problems -------------- None so far. .. _To-Do-list: To-Do list ---------- Thinking about it. Let me know, what you would like to see... .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. :border: 0 .. :height: 44 .. :id: graphics5 .. :name: graphics5 .. :vspace: 57 .. :width: 161 .. |img-2| image:: img-2.png .. :align: left .. |img-3| image:: img-3.jpeg .. :align: left .. :border: 0 .. :height: 324 .. :id: Grafik1 .. :name: Grafik1 .. :width: 343 .. |img-4| image:: img-4.jpeg .. :align: left .. :border: 0 .. :height: 265 .. :id: Grafik2 .. :name: Grafik2 .. :width: 319 .. |img-5| image:: img-5.jpeg .. :align: left .. :border: 0 .. :height: 275 .. :id: Grafik3 .. :name: Grafik3 .. :width: 565