Changes between Version 4 and Version 5 of Documentatie/Beheerder/Scripts


Ignore:
Timestamp:
04/26/11 10:30:12 (15 years ago)
Author:
adriaan
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • Documentatie/Beheerder/Scripts

    v4 v5  
    11= Scripts = 
     2 
     3[[TOC(heading=Inhoudsopgave)]] 
     4[[TOC(heading=Beheershandleiding, compact, depth=1, Documentatie/Beheershandleiding/*)]] 
     5[[TOC(heading=Hoofdstukken, titleindex, compact, Documentatie, Releases, ImplementatieBladen, Events)]] 
    26 
    37OpenAC heeft, naast de gewone functionaliteit van het programma, 
    … …  
    2529   beschikbare scripts staat op deze pagina [#scripts hieronder], 
    2630   of kijk in ''<OpenAC Map>/scripts/'' voor de namen van 
    27    alle scripts die met OpenAC geinstalleerd zijn. 
     31   alle scripts die met OpenAC geinstalleerd zijn. Elke adaptatie kan ook zijn eigen scripts hebben, die in de adaptatiemap staan. 
    2832 
    2933Scripts worden het beste vanaf de ''command-line'' uitgevoerd. 
    3034Deze is op te starten als {{{cmd.exe}}}. Instructies voor 
    3135specifieke Windows versies staan hieronder. Als de command-line 
    32 is opgestart, dan kunt u met het commando {{{cd }}}''<OpenAC Map> 
     36is opgestart, dan kunt u met het commando {{{cd }}}''<OpenAC Map>'' 
    3337naar de juiste map gaan. 
    3438 
    … …  
    7074  - (''optioneel'') een of meer parameters voor het script 
    7175 
    72 == Achtergrond == 
     76Hieronder volgen vier voorbeelden met verschillende combinaties van parameters. In alle gevallen draaien we 
     77het script {{{svn.py}}} (beschikbaar vanaf v1.224). We kiezen optioneel om de adaptatie op die van Nijmegen 
     78in te stellen, om de resultaten naar de helpdesk te sturen, om zowel de adaptatie als het mailadres in te stellen (''en let op dat hier de volgorde belangrijk is! '') en om het script {{{svn.py}}} zelf een parameter te geven (nl. "info", waardoor het script iets nuttigs afdrukt). 
    7379 
    74 (''verouderd'') 
     80{{{ 
     81Python25\python.exe adaptatie:ac_nijmegen script.py  
     82Python25\python.exe mailto:tickets@fenac.nl script.py 
     83Python25\python.exe adaptatie:ac_nijmegen mailto:tickets@fenac.nl script.py 
     84Python25\python.exe script.py info 
     85}}} 
    7586 
    76 OpenAC kan worden gescript door gebruik te maken van script.py met als 
    77 argument het uit te voeren script. Eventuele verdere argumenten zijn 
    78 argumenten voor het uit te voeren script. 
    79  
    80 Zorg ervoor dat een script altijd wordt uitgevoerd vanuit de map waar 
    81 OpenAC is geïnstalleerd. Vanuit deze map is de opdrachtregel: 
    82 python25\python.exe script.py <naam en argumenten uit te voeren script>. 
    83  
    84 Door als eerste argument van het uit te voeren script mailto:e-mailadres op te geven, dan wordt het sessielog na het uitvoeren van het script gestuurd aan het opgegeven e-mailadres. 
     87=== Instellingen voor Scripts === 
    8588 
    8689Scripts gebruiken dezelfde instellingen als de laatste OpenAC-sessie. 
    … …  
    8891starten en te controleren of alle instellingen correct zijn. 
    8992 
    90 == Een geplande taak aanmaken in Windows == 
     93== Een geplande taak aanmaken == 
     94 
     95Controleer eerst dat het script met de hand gedraaid kan worden 
     96zoals hierboven omschreven staat. De runtime en parameters 
     97zijn hierbij in het bijzonder van belang. 
     98 
    9199 
    92100 * Open "Geplande taken" vanuit het configuratiescherm. De wizard "Taak 
    93101   plannen" zal worden gestart. 
    94  
    95  * Blader naar python.exe in <OpenAC map>\python24. 
    96  
     102 * Blader naar python.exe in de runtime map (Python25 of Python24) in de ''<OpenAC map>''. 
    97103 * Geef de taak een naam. 
    98  
    99104 * Geef aan wanneer de taak moet worden uitgevoerd. 
    100  
    101105 * Voltooi de wizard. Vink op de laatste pagina moet de optie 
    102106   "Geavanceerde eigenschappen voor deze taak openen wanneer ik op 
    103107   Voltooien klik" aan. Dit is nodig om de argumenten en de werkdirectory 
    104108   in te stellen. 
    105  
    106  * Vul de opdrachtregel achter "Uitvoeren" aan met script.py <naam en 
    107    argumenten uit te voeren script>. Zie voor de naam en argumenten van 
    108    het script het lijstje scripts hieronder. De volledige opdrachtregel 
    109    wordt: <OpenAC map>\python24\python.exe script.py <naam en argumenten 
    110    uit te voeren script>. 
    111  
    112  * Het is belangrijk dat achter "Beginnen in" de OpenAC map wordt 
     109 * Vul de opdrachtregel achter "Uitvoeren" aan met {{{script.py}}} ''<naam van script>'' ''<parameters voor script>''. 
     110 * Het is belangrijk dat achter "Beginnen in" de ''<OpenAC Map>'' wordt 
    113111   ingevuld. Dit is de werkdirectory. 
    114  
    115 == Scripts Draaien == 
    116112 
    117113== Beschikbare Scripts == 
    118114 
    119 === Script backup === 
     115Deze lijst met scripts omvat alleen de scripts die voor alle AC's van belang zijn. 
     116De individuele adaptaties kunnen nog meer scripts bevatten die alleen 
     117op de lokale situatie van die adaptatie of dat AC van toepassing zijn. 
    120118 
    121 Aanroep vanaf de command line: "'''Python25\python.exe script.py backup'''". 
     119Scriptnamen worden in dit lijstje zonder "{{{.py}}}" weergegeven. Die kan 
     120je bij de scriptnaam ook weglaten (maar ''niet'' bij {{{script.py}}}!). 
     121 
     122TODO: '''verstuur herinneringen script''' 
     123TODO: '''switches script''' 
     124TODO: '''andere scripts''' 
     125TODO: '''lijstje van adaptatie scripts''' 
     126 
     127=== Backup === 
     128 
     129De naam van dit script is {{{backup}}}. 
    122130 
    123131Dit script schrijft een actuele backup naar de verzameldirectory. 
     132De verzameldirectory is degene die is ingesteld bij het maken van  
     133een OpenAC backup. Om die in te stellen of te controleren,  
     134start OpenAC gewoon op als admin en kies Bestand -> Backup Maken. 
     135Het invulveld dat daar verschijnt bevat de instelling voor het maken van backups. 
    124136 
     137=== SVN Cleanup === 
    125138 
    126 === Script svn_cleanup === 
    127  
    128 Aanroep vanaf de command line: "'''Python25\python.exe script.py svn_cleanup'''". 
     139De naam van dit script is {{{svn_cleanup}}}. 
    129140 
    130141Dit script kan problemen met het versiebeheer van OpenAC oplossen. 
     142Als het niet lukt om OpenAC op te starten omdat het over versiebeheerproblemen klaagt, 
     143kan dit script een oplossing bieden. Voor een meer rigoreuze oplossing zie script [#svn_client SVN Client]. 
    131144 
    132 === Script periodieke TOREN-import === 
     145=== SVN Client === 
    133146 
    134 Aanroep vanaf de command line: "'''Python25\python.exe script.py 
    135 periodiek_toren_import import'''". 
     147De naam van dit script is {{{svn}}}. Beschikbaar vanaf v1.224. 
    136148 
    137 Het script periodiek_toren_import doet het volgende: 
     149Dit script voert algemene versiebeheertaken uit, al dan niet met de instellingen 
     150van OpenAC. Dit script heeft een parameter nodig om aan te geven welke bewerking 
     151het uit moet voeren. Als er geen parameters meegegeven worden dan drukt het script 
     152een volledige handleiding af op het scherm. 
    138153 
     154Sommige mogelijke parameters voor dit script: 
     155  - {{{info}}} geef informatie over de huidige OpenAC versie. 
     156  - {{{server}}} geef informatie over de versie van OpenAC beschikbaar op de server van de FENAC. Hierbij worden de proxy-instellingen van OpenAC gebruikt. Zorg ervoor dat die goed ingesteld staan bij instellingen. 
     157  - {{{serverc}}} geef informatie over de versie van OpenAC beschikbaar op de server van de FENAC. Maak hierbij ''geen'' gebruik van de proxy instellingen van OpenAC. In combinatie met {{{server}}} is het mogelijk om hiermee netwerkproblemen veroorzaakt door proxy-instellingen uit te zoeken. 
     158  - {{{status}}} laat de status van de OpenAC versie zien. Hierbij worden regels afgedrukt met een letter of symbool vooraan om aan te geven wat de status is. ''?'' geeft een bestand aan dat onbekend is bij versiebeheer; dat zou normaal gesproken niet voor moeten komen. ''M'' geeft een bestand aan dat veranderd is in de lokale versie; die kunnen via versiebeheer ingeleverd worden. Andere letters (''A'' en ''C'') kunnen voorkomen maar geven een probleem met de installatie aan. 
     159  - {{{scrub}}} is een stoomwals die over alle versiebeheer problemen heen walst door dingen lukraak weg te gooien. Als OpenAC niet wil opstarten vanwege versiebeheerproblemen en ook niet bijgewerkt kan worden en script {{{svn_cleanup}}} biedt geen soelaas, dan kan ''scrub'' helpen. Omdat dit een paardemiddel is moet ook nog de dag van de week (eerste twee letters) als parameter meegegeven worden, al is het maar om te voorkomen dat je dit per ongeluk draait en alle veranderingen aan sjablonen en codetabellen kwijtraakt. 
     160 
     161=== Periodieke TOREN-import === 
     162 
     163De naam van dit script is {{{periodiek_toren_import}}}. Geef het script 
     164een parameter, {{{import}}}. 
     165 
     166Het script doet het volgende: 
    139167 * Alle bestanden uit de TOREN-importmap met een bepaalde 
    140168   bestandsextensie worden ingelezen. De TOREN-importmap en de 
    141169   bestandextensie kunnen worden ingesteld via '''Beheer->Instellingen''' 
    142170   in OpenAC. 
    143  
    144171 * Als er een structuurfout zit in het importbestand, of als de import 
    145172   voortijdig wordt afgebroken, dan wordt het importbestand verplaatst 
    … …  
    148175   wordt verwerkt, dus een bestand kan zonder gevaar op dubbele 
    149176   verrichtingen meerdere keren worden geïmporteerd. 
    150  
    151177 * Verrichtingen die niet kunnen worden verwerkt worden weggeschreven 
    152178   als een kommagescheiden bestand in de map "'''fouten'''". 
    153  
    154179 * Nadat een TOREN-bestand is geïmporteerd wordt het verplaatst naar de 
    155180   map "'''behandeld'''". 
    156  
    157181 * Bestanden uit de map "mislukt" kunnen worden teruggezet naar de 
    158182   TOREN-importmap met "'''script.py periodiek_toren_import herstel'''". 
    159183 
    160 === Script verstuur DBC's === 
     184=== Verstuur DBC's === 
    161185 
    162 Aanroep vanaf de command line: "'''Python25\python.exe script.py verstuur_dbcs'''". 
     186De naam van dit script is {{{verstuur_dbcs}}}. 
    163187 
    164 Het script verstuur_dbcs voert de acties uit het scherm DBC's versturen automatisch uit. 
     188Het script voert de acties uit het scherm DBC's versturen automatisch uit. 
    165189 
    166190