Changes between Version 24 and Version 25 of Documentatie/Beheerder/Scripts


Ignore:
Timestamp:
Mar 30, 2016 1:59:12 PM (10 years ago)
Author:
thomas
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • Documentatie/Beheerder/Scripts

    v24 v25  
    55= Scripts = 
    66 
    7 OpenAC heeft, naast de gewone functionaliteit van het programma, 
    8 ook ''scripts'' die ongewone acties uitvoeren of die bijzondere 
    9 queries op de database loslaten. Deze scripts staan bij de 
    10 OpenAC programmatuur en kunnen [#handmatig met de hand] of 
    11 [#gepland als geplande taak] worden uitgevoerd. 
    12  
    13 Scripts doen speciale dingen met OpenAC. Hierdoor is het 
    14 van belang om de scripts met de nodige voorzichtigheid 
    15 te draaien. 
     7OpenAC heeft, naast de gewone functionaliteit van het programma, ook ''scripts'' die ongewone acties uitvoeren of die bijzondere queries op de database loslaten. Deze scripts staan bij de OpenAC programmatuur en kunnen [#handmatig met de hand] of [#gepland als geplande taak] worden uitgevoerd. 
     8 
     9Scripts doen speciale dingen met OpenAC. Hierdoor is het van belang om de scripts met de nodige voorzichtigheid te draaien. 
    1610 
    1711== Scripts Draaien == 
    1812 
    19 Voor het uitvoeren van een script zijn er drie stukken 
    20 informatie nodig: 
    21  - Waar is OpenAC geinstalleerd? Dit scrijven we verder 
    22    als ''<OpenAC Map>''. Als OpenAC op een reguliere 
    23    manier is geinstalleerd zou dit {{{C:\Program Files\OpenAC}}} 
    24    kunnen zijn. 
    25  - Welke versie van de [Documentatie/Beheershandleiding/Runtime OpenAC runtime] 
    26    wordt er gebruikt? Sinds OpenAC v2.010 gebruikt iedereen Python 2.7. 
    27  - Welk script moet er worden uitgevoerd? Een lijst van 
    28    beschikbare scripts staat op deze pagina [#scripts hieronder], 
    29    of kijk in ''<OpenAC Map>/scripts/'' voor de namen van 
    30    alle scripts die met OpenAC geinstalleerd zijn. Elke adaptatie kan ook zijn eigen scripts hebben, die in de adaptatiemap staan. 
    31  
    32 Scripts worden het beste vanaf de ''command-line'' uitgevoerd. 
    33 Deze is op te starten als {{{cmd.exe}}}. Instructies voor 
    34 specifieke Windows versies staan hieronder. Als de command-line 
    35 is opgestart, dan kunt u met het commando {{{cd }}}''<OpenAC Map>'' 
    36 naar de juiste map gaan. 
    37  
    38 Eenmaal in de juiste map, gebruik het juiste commando van de 
    39 [Beheershandleiding/Runtime runtime], een spatie, {{{script.py}}} 
    40 en de naam van het script om uit te voeren. Indien geen  
    41 script wordt opgegeven klaagt het programma dat er geen 
    42 script opgegeven is en doet verder niks. 
    43  
    44 In de screenshot hieronder worden de volgende twee opdrachten 
    45 uitgevoerd (merk op, dit gaat om een oude versie van OpenAC met een oude versie van Python; vanaf OpenAC v2.010 is het `Python27\python.exe`): 
     13Voor het uitvoeren van een script zijn er drie stukken informatie nodig: 
     14 - Waar is OpenAC geinstalleerd? Dit scrijven we verder als ''<OpenAC Map>''. Als OpenAC op een reguliere manier is geinstalleerd zou dit {{{C:\Program Files\OpenAC}}} kunnen zijn. 
     15 - Welke versie van de [wiki:Documentatie/Beheerder/Installeren/Runtime OpenAC runtime] wordt er gebruikt? Sinds OpenAC v2.010 gebruikt iedereen Python 2.7. 
     16 - Welk script moet er worden uitgevoerd? Een lijst van beschikbare scripts staat op deze pagina [#scripts hieronder], of kijk in ''<OpenAC Map>/scripts/'' voor de namen van alle scripts die met OpenAC geinstalleerd zijn. Elke adaptatie kan ook zijn eigen scripts hebben, die in de adaptatiemap staan. 
     17 
     18Scripts worden het beste vanaf de ''command-line'' uitgevoerd. Deze is op te starten als {{{cmd.exe}}}. Instructies voor specifieke Windows versies staan hieronder. Als de command-line is opgestart, dan kunt u met het commando {{{cd }}}''<OpenAC Map>'' naar de juiste map gaan. 
     19 
     20Eenmaal in de juiste map, gebruik het juiste commando van de [Beheershandleiding/Runtime runtime], een spatie, {{{script.py}}} en de naam van het script om uit te voeren. Indien geen  script wordt opgegeven klaagt het programma dat er geen script opgegeven is en doet verder niks. 
     21 
     22In de screenshot hieronder worden de volgende twee opdrachten uitgevoerd (merk op, dit gaat om een oude versie van OpenAC met een oude versie van Python; vanaf OpenAC v2.010 is het `Python27\python.exe`): 
    4623 
    4724{{{ 
    … …  
    5027}}} 
    5128 
    52 Het eerste commando zorgt ervoor dat het commando op de 
    53 juiste plek wordt uitgevoerd (op deze machine is OpenAC op een ongewone plek geinstalleerd). De tweede voert het script uit 
    54 (zonder naam van een script, dus we verwachten ook dat 
    55 het klaagt). 
     29Het eerste commando zorgt ervoor dat het commando op de juiste plek wordt uitgevoerd (op deze machine is OpenAC op een ongewone plek geinstalleerd). De tweede voert het script uit (zonder naam van een script, dus we verwachten ook dat het klaagt). 
    5630 
    5731[[Image(script-geen.PNG)]] 
    … …  
    8862=== Instellingen voor Scripts === 
    8963 
    90 Scripts gebruiken dezelfde instellingen als de laatste OpenAC-sessie. 
    91 Het is dus zaak om OpenAC minimaal één keer op de reguliere manier te 
    92 starten en te controleren of alle instellingen correct zijn. 
     64Scripts gebruiken dezelfde instellingen als de laatste OpenAC-sessie. Het is dus zaak om OpenAC minimaal één keer op de reguliere manier te starten en te controleren of alle instellingen correct zijn. 
    9365 
    9466Om een ander configuratiebestand te gebruiken (bijvoorbeeld voor een testdatabase) kan de parameter ''config_dir'' worden opgegeven, net als bij OpenAC zelf. Voer het script uit met een parameter (dus '''na''' de naam van het script) {{{config_dir=C:\pad\naar\configuratiemap}}}, bijvoorbeeld zo: 
    … …  
    10274== Een geplande taak aanmaken ==#cron 
    10375 
    104 Controleer eerst dat het script met de hand gedraaid kan worden 
    105 zoals hierboven omschreven staat. De runtime en parameters 
    106 zijn hierbij in het bijzonder van belang. 
    107  
    108  
    109  * Open "Geplande taken" vanuit het configuratiescherm. De wizard "Taak 
    110    plannen" zal worden gestart. 
     76Controleer eerst dat het script met de hand gedraaid kan worden zoals hierboven omschreven staat. De runtime en parameters zijn hierbij in het bijzonder van belang. 
     77 
     78 
     79 * Open "Geplande taken" vanuit het configuratiescherm. De wizard "Taak plannen" zal worden gestart. 
    11180 * Blader naar `Python27\python.exe` in de runtime map van OpenAC. 
    11281 * Geef de taak een naam. 
    11382 * Geef aan wanneer de taak moet worden uitgevoerd. 
    114  * Voltooi de wizard. Vink op de laatste pagina moet de optie 
    115    "Geavanceerde eigenschappen voor deze taak openen wanneer ik op 
    116    Voltooien klik" aan. Dit is nodig om de argumenten en de werkdirectory 
    117    in te stellen. 
     83 * Voltooi de wizard. Vink op de laatste pagina moet de optie "Geavanceerde eigenschappen voor deze taak openen wanneer ik op Voltooien klik" aan. Dit is nodig om de argumenten en de werkdirectory in te stellen. 
    11884 * Vul de opdrachtregel achter "Uitvoeren" aan met {{{script.py}}} ''<naam van script>'' ''<parameters voor script>''. 
    119  * Het is belangrijk dat achter "Beginnen in" de ''<OpenAC Map>'' wordt 
    120    ingevuld. Dit is de werkdirectory. 
     85 * Het is belangrijk dat achter "Beginnen in" de ''<OpenAC Map>'' wordt ingevuld. Dit is de werkdirectory. 
    12186 
    12287== Beschikbare Scripts == 
    12388 
    124 Deze lijst met scripts omvat alleen de scripts die voor alle AC's van belang zijn. 
    125 De individuele adaptaties kunnen nog meer scripts bevatten die alleen 
    126 op de lokale situatie van die adaptatie of dat AC van toepassing zijn. 
    127  
    128 Scriptnamen worden in dit lijstje zonder "{{{.py}}}" weergegeven. Die kan 
    129 je bij de scriptnaam ook weglaten (maar ''niet'' bij {{{script.py}}}!). 
     89Deze lijst met scripts omvat alleen de scripts die voor alle AC's van belang zijn. De individuele adaptaties kunnen nog meer scripts bevatten die alleen op de lokale situatie van die adaptatie of dat AC van toepassing zijn. 
     90 
     91Scriptnamen worden in dit lijstje zonder "{{{.py}}}" weergegeven. Die kan je bij de scriptnaam ook weglaten (maar ''niet'' bij {{{script.py}}}!). 
    13092 
    13193 
    … …  
    13496De naam van dit script is {{{backup}}}. 
    13597 
    136 Dit script schrijft een actuele backup naar de verzameldirectory. 
    137 De verzameldirectory is degene die is ingesteld bij het maken van  
    138 een OpenAC backup. Om die in te stellen of te controleren,  
    139 start OpenAC gewoon op als admin en kies Bestand -> Backup Maken. 
    140 Het invulveld dat daar verschijnt bevat de instelling voor het maken van backups. 
     98Dit script schrijft een actuele backup naar de verzameldirectory. De verzameldirectory is degene die is ingesteld bij het maken van een OpenAC backup. Om die in te stellen of te controleren, start OpenAC gewoon op als admin en kies Bestand -> Backup Maken. Het invulveld dat daar verschijnt bevat de instelling voor het maken van backups. 
    14199 
    142100Zie ook script [#Restore restore] om backups terug te zetten.