| | 206 | |
| | 207 | === Migratie === |
| | 208 | |
| | 209 | (''vanaf OpenAC v2.006'') Om de overgang van een OpenAC versie naar de volgende te versoepelen is er een ''migratie-script''. Dit is het OpenAC script `migratie`, dat als een gewoon OpenAC script te gebruiken is. Je moet eerst OpenAC bijwerken naar de '''nieuwe''' versie (zodat je de nieuwste versie van het migratie-script krijgt). Voor elke versie van OpenAC (vanaf v2.006) is er een ''migratie-module'' die de migratie van de vorige versie, naar die versie uitvoert. De migratie-modules zijn genoemd naar de versie waar ze bij horen (`v2_006` voor versie v2.006, die de migratie van v2.004 naar v2.006 uitvoert; `v2_008` voor versie v2.008, die de migratie van v2.006 naar v2.008 uitvoert; enzovoort). |
| | 210 | |
| | 211 | Een migratie-module definieert op zijn beurt weer migratie-stappen die uitgevoerd worden. Deze stappen worden doorgaans in de release-notes van de bijbehorende versie uitgelegd. |
| | 212 | |
| | 213 | Het migratie-script geef je een of meer parameters. De eerste is de naam van de migratie-module (`v2_006`). Daarna '''moet''' je een of meer opties meegeven die aangeven wat de module moet doen. Met `--all` worden alle migratie-stappen opeenvolgend uitgevoerd, maar het is ook mogelijk om de migratie-stappen een-voor-een uit te voeren. Gebruik `--help` voor een overzicht van de uit-te-voeren migratiestappen. Gebruik optie `-v` om (nog) meer te loggen dan het anders zou doen. |
| | 214 | |
| | 215 | Dit commando laat zien welke stappen er zijn: |
| | 216 | |
| | 217 | {{{ |
| | 218 | Python25\python.exe script.py migratie v2_006 --help |
| | 219 | }}} |
| | 220 | |
| | 221 | Elke stap heeft een naam (zoals ''bijwerken'' en er horen twee opties bij deze stap: `--bijwerken` om de stap uit te voeren, en `--no-bijwerken` om de stap juist '''niet''' uit te voeren. De speciale optie `--all` voert alle stappen uit, maar in combinatie met een of meer `--no-<iets>` opties kunnen specifieke stappen worden onderdrukt. Om een enkele stap uit te proberen, gebruik alleen de optie die bij die stap hoort. |
| | 222 | |
| | 223 | Een gewone migratie gebruikt `--all` en is verder niet ingewikkeld. |
| | 224 | |
| | 225 | Het volgende commando voert alle stappen uit en maakt een (extra) logbestand `migratie.log` ter controle. Het logbestand komt bij de andere OpenAC logbestanden te staan, in de configuratie-directory (vaak `.openac`). Het migratie-logbestand wordt bij elke migratie overschreven. |
| | 226 | |
| | 227 | {{{ |
| | 228 | Python25\python.exe script.py migratie v2_006 -v --all |
| | 229 | }}} |
