Repository navigation
Expand file tree
/
Copy pathcache-scripts.php
More file actions
35 lines (35 loc) · 8.56 KB
/
Copy pathcache-scripts.php
File metadata and controls
35 lines (35 loc) · 8.56 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
<?php
require_once __DIR__.'/inc/site.php';
begin_page('Moteurs de scripts : fichiers d\'exécution et caches','Script engines: runtime files and caches','YEngine, ScriptEngines, compilation et précautions avant toute suppression de fichiers.','YEngine, ScriptEngines, compilation and precautions before deleting any files.');
callout('Référence : OpenSimulator 0.9.3.1. Vérifier le moteur réellement chargé. Les fichiers ScriptEngines et les assets persistants ne sont pas nécessairement des caches jetables.','Reference: OpenSimulator 0.9.3.1. Check the actual loaded engine. ScriptEngines files and persistent assets are not necessarily disposable caches.');
echo '<nav class="install-toc"><strong>'.e(t('Sur cette page','On this page')).'</strong><ul>';
echo '<li><a href="#topic-1">'.e(t('Il faut distinguer cache et état de script','Distinguish cache from script state')).'</a></li>';
echo '<li><a href="#topic-2">'.e(t('Le répertoire ScriptEngines de YEngine','YEngine ScriptEngines directory')).'</a></li>';
echo '<li><a href="#topic-3">'.e(t('Compilation et ressources de calcul','Compilation and compute resources')).'</a></li>';
echo '<li><a href="#topic-4">'.e(t('Commandes yeng et rôle du module','yeng commands and module scope')).'</a></li>';
echo '<li><a href="#topic-5">'.e(t('Données des objets et scripts dans les autres stockages','Script assets and region data elsewhere')).'</a></li>';
echo '<li><a href="#topic-6">'.e(t('Maintenance recommandée','Recommended maintenance')).'</a></li>';
echo '</ul></nav>';
echo '<section class="install-entry" id="topic-1">';sec('Il faut distinguer cache et état de script','Distinguish cache from script state');p('Les moteurs de scripts utilisent des structures mémoire, des résultats de compilation et parfois des fichiers persistants. Tous ces fichiers ne sont pas des copies jetables. Une donnée d\'état de script peut être nécessaire pour reprendre correctement l\'exécution après redémarrage.','Script engines use in-memory structures, compilation results and sometimes persistent files. Not all these files are disposable copies. Script state may be required to resume execution correctly after restart.');echo '</section>';
echo '<section class="install-entry" id="topic-2">';sec('Le répertoire ScriptEngines de YEngine','YEngine ScriptEngines directory');p('Le code de XMREngine.cs lit ScriptEnginesPath, ou à défaut ScriptBasePath, puis utilise ScriptEngines par défaut. YEngine crée un sous-répertoire Yengine suivi de l\'UUID de région. Il y conserve notamment les fichiers nécessaires au fonctionnement des instances de scripts. Ce dossier n\'est pas l\'équivalent de Flotsam assetcache.','XMREngine.cs reads ScriptEnginesPath, falling back to ScriptBasePath and then ScriptEngines. YEngine creates a Yengine subdirectory followed by the region UUID. It stores files used by script instances there. This directory is not equivalent to Flotsam\'s assetcache.');echo '</section>';
echo '<section class="install-entry" id="topic-3">';sec('Compilation et ressources de calcul','Compilation and compute resources');p('Après certaines modifications, la recompilation de scripts peut mobiliser CPU et I/O. Supprimer un répertoire de scripts sans procédure adaptée peut aussi détruire des fichiers d\'état utilisés au redémarrage. Une action de purge ne doit pas être proposée comme remède automatique à une région lente.','Recompiling scripts after changes can consume CPU and I/O. Deleting script folders without an appropriate procedure can also destroy state files used on restart. Deletion should never be recommended as an automatic fix for a slow region.');echo '</section>';
echo '<section class="install-entry" id="topic-4">';sec('Commandes yeng et rôle du module','yeng commands and module scope');p('XMREngine.cs enregistre une famille de commandes console yeng. Cela ne signifie pas que toute commande yeng est une commande de purge de cache. Vérifiez l\'aide de la version du moteur avant de lancer des opérations ; ne substituez pas ces commandes à un diagnostic des scripts et événements.','XMREngine.cs registers a yeng console-command family. This does not mean every yeng command clears a cache. Check help on the deployed engine version before operations; console commands do not replace diagnosing scripts and event queues.');echo '</section>';
echo '<section class="install-entry" id="topic-5">';sec('Données des objets et scripts dans les autres stockages','Script assets and region data elsewhere');p('Le texte d\'un script et ses références d\'inventaire appartiennent aux systèmes d\'assets, d\'objets et d\'inventaire, tandis que la compilation et l\'exécution relèvent du moteur. Ne confondez pas le répertoire YEngine avec la base des prims, la base d\'assets ou les archives OAR/IAR.','Script source and inventory references belong to assets, objects and inventory systems; compilation and execution belong to the engine. Do not confuse the YEngine directory with the prim database, asset store or OAR/IAR archives.');echo '</section>';
echo '<section class="install-entry" id="topic-6">';sec('Maintenance recommandée','Recommended maintenance');p('Avant de toucher au répertoire YEngine, identifiez le moteur actif, examinez les logs, sauvegardez les scènes et l\'état nécessaire puis testez hors production. Aucune commande universelle « clear script cache » n\'est ici établie à partir du code consulté.','Before touching YEngine directories, identify the active engine, inspect logs, back up scenes and needed state, then test outside production. The reviewed code does not establish a universal clear script cache command.');echo '</section>';
sample('ScriptEngines/
Yengine/
<UUID_DE_REGION>/
...fichiers du moteur et états de scripts...','Arborescence conceptuelle : ne supprimez pas ce répertoire en le prenant pour un simple cache d\'assets.','Conceptual directory tree: do not delete this as though it were an asset cache.');
sec('Gérer ce cache : méthode pratique','Managing this cache: practical steps');
subheading('Comment administrer sans supprimer les états ?','Managing without deleting script state');p('Commencez par les logs YEngine, l\'état du moteur, le nombre de scripts actifs et les ressources CPU/RAM. Les commandes yeng sont spécifiques au moteur et doivent être découvertes avec l\'aide de la version réellement lancée ; aucune commande universelle de purge du dossier ScriptEngines n\'a été vérifiée. Un redémarrage ou une recompilation globale peut générer une forte charge.','Start with YEngine logs, engine health, active script count and CPU/RAM. yeng commands are engine-specific and must be checked using help for the deployed version; no universal ScriptEngines purge command was verified. Restarting or mass recompilation can create significant load.');
subheading('Risque de perte de données de script','Risk of losing script state');p('Avant de changer ScriptEnginesPath, ScriptBasePath ou le répertoire Yengine, sauvegardez l\'état pertinent et testez la restauration. Le fait qu\'un fichier soit généré par YEngine ne signifie pas qu\'on peut l\'effacer sans altérer la reprise du script. Ne proposez pas rm -rf ScriptEngines comme opération d\'entretien périodique.','Before changing ScriptEnginesPath, ScriptBasePath or the Yengine directory, preserve relevant state and test restoration. Files generated by YEngine are not necessarily safe to delete without affecting script resume. Never suggest rm -rf ScriptEngines as routine maintenance.');
sec('Sources du code OpenSimulator','OpenSimulator source references');echo '<ul>';
echo '<li><a href="https://github.com/Vlad-BloodMoon/opensim/blob/master/OpenSim/Region/ScriptEngine/YEngine/XMREngine.cs" target="_blank" rel="noopener">'.e('XMREngine.cs').'</a></li>';
echo '<li><a href="https://github.com/Vlad-BloodMoon/opensim/blob/master/OpenSim/Region/ScriptEngine/YEngine/XMRInstMain.cs" target="_blank" rel="noopener">'.e('XMRInstMain.cs').'</a></li>';
echo '</ul>';sec('Autres guides','Related guides');echo '<ul>';
echo '<li><a href="cache-overview.php?lang='.e($lang).'">'.e(t('Comprendre tous les niveaux de cache','Understanding cache layers')).'</a></li>';
echo '<li><a href="cache-flotsam.php?lang='.e($lang).'">'.e(t('Flotsam : cache d’assets','Flotsam asset cache')).'</a></li>';
echo '<li><a href="cache-console.php?lang='.e($lang).'">'.e(t('Commandes fcache','fcache commands')).'</a></li>';
echo '<li><a href="cache-internal.php?lang='.e($lang).'">'.e(t('Caches internes','Internal caches')).'</a></li>';
echo '<li><a href="cache-diagnostics.php?lang='.e($lang).'">'.e(t('Diagnostic des caches','Cache troubleshooting')).'</a></li>';
echo '</ul>';end_page();