Sauvegarder une base de données de manière codée (ARIS Server Administrator)

Le plus simple est de coder les bases de données lors de la sauvegarde.

Vous pouvez également enregistrer des bases de données de manière codée avec l'ARIS Server Administrator.

Condition préalable

Au moins le droit de fonction Administrateur de base de données a été affecté à votre utilisateur dans l'Administration ARIS.

Procédure

  1. Lancez l'ARIS Server Administrator puis établissez une connexion à un serveur ARIS.

    Vous pouvez lancer l'ARIS Server Administrator en mode interactif ou en mode lignes de commande depuis tout ordinateur sur lequel un client ARIS est installé. En mode lignes de commande, vous pouvez exécuter automatiquement certaines actions, car ce mode ne propose aucune invite de commande. Si vous vous connectez à l'Administration ARIS en tant qu'un utilisateur système disposant au moins du droit de fonction Administrateur de base de données, vous pouvez administrer toutes les bases de données de ce locataire.

    Vous lancez le mode interactif en cliquant sur Démarrer > Programmes > ARIS > Administration > ARIS Server Administrator 10.0.

    Vous lancez le mode lignes de commande en ouvrant l'invite de commande à partir du répertoire <ARIS installation directory>\tools\ArisAdm.

    Utilisez les commandes et les options suivantes pour la syntaxe du mode lignes de commande :

    <_arisadm><version>.exe [<option>] <commande> [<argument de commande 1>]

    ou pour la syntaxe du mode interactif :

    <commande> [<argument de commande 1>]

    • Si vous utilisez des valeurs avec des caractères spéciaux (exemple : & dans le mot de passe), vous devez mettre la valeur entre guillemets. Pour plus d'informations, reportez-vous au centre d'aide et de support de votre système d'exploitation.

    • Sur le serveur, les messages système dans l'ARIS Server Administrator sont toujours affichés dans la langue d'installation d'ARIS.

    • Si vous utilisez par exemple des scripts pour vos sauvegardes quotidiennes, nous vous recommandons instamment de protéger ces scripts au niveau système d'exploitation ou d'entrer les mots de passe de manière cryptée.

    Option

    Description

    -s <server[:<port>]>

    Serveur sur lequel la commande doit être exécutée.

    -u <user> <password>

    Nom d'utilisateur et mot de passe d'un utilisateur système avec des autorisations suffisantes.

    -l <file name>

    Active la journalisation de toutes les opérations du programme dans le fichier journal indiqué. Le fichier vous permet de savoir quand une opération a été exécutée et avec quel résultat.

    -enc IBM<code page number>

    Spécifie une page de code pour afficher correctement les caractères diacritiques. Si vous ne saisissez pas de paramètre d'option, le jeu de caractères original d'IBM PC 437 est utilisé.

    Si les caractères diacritiques, tels que é, ó ou ñ utilisés en espagnol, en portugais ou en français sont affichés sous la forme é, ó ou ñ, entrez l'option -enc IBM850.

    Si le problème survient dans d'autres langues, essayez d'autres numéros de page de code, par exemple :

    850 Multilingue (DOS-Latin-1), Europe de l'Ouest

    720 alphabet arabe

    737 alphabet grec

    775 alphabet estonien, lituanien et letton

    852 Langues slaves (Latin-2), Europe centrale et de l'Est

    855 alphabet cyrillique

    857 alphabet turc

    -cf <command file>

    Lance un fichier de commande contenant des commandes exécutables.

    -sc <schema context>

    Contexte utilisé par le schéma. ARIS est défini par défaut.

    -t <tenant>

    Locataire pour lequel la commande doit être exécutée. Par défaut, aucun locataire.

    -ssl

    Utilise la connexion SSL.

    Remplacez le texte entouré de <chevrons> par vos valeurs individuelles. Les parties de la commande qui sont entourées par des [crochets] sont optionnelles. Vous pouvez les utiliser si nécessaire. Les commandes par défaut sont indiquées ci-dessous. Les commandes avancées sont décrites dans les documents s'y rapportant si nécessaire.

    Commande

    Description et syntaxe

    backup

    Enregistre une base de données <nomBD> sous forme de fichier adb dans un répertoire <dossierarchive>.

    Si la sauvegarde est lancée avec l'option -c, l'enregistrement de la base de données dans le fichier de sauvegarde commence uniquement une fois les opérations en cours (une procédure de fusion ou une importation XML, par exemple) sont terminées.

    Syntaxe

    backup <nomBD>|-c |all <dossierarchive> [-p <mot de passe pour le cryptage>] [<autrenom>]

    backupasn

    Extrait l'état correspondant au niveau de liste des modifications <asn> d'une base de données versionnée <dbname> vers un fichier adb dans le répertoire <archivedir>. Vous pouvez sélectionner soit un numéro de liste des modifications <asn> ou 'head' en tant qu'état des données. 'head' représente le dernier état versionné.

    Syntaxe

    backupasn <dbname>|all <archivedir> <asn>|head [-p <password for encryption>] [<alternatename>]

    backupsystemdb

    Enregistre en tant que fichier adb la base de données système centrale contenant des données telles que des filtres, des modèles de représentation ou des scripts dans un répertoire <archive>.

    Syntaxe

    backupsystemdb <archivedir> [<alternatename>]

    backupunversioned

    Sauvegarde une base de données <dbname> sous forme de fichier non versionné ADB dans un répertoire <archivedir>.

    Syntaxe

    backupunversioned <dbname> <archivedir>

    clearchartdata

    Supprime les données statistiques qui sont utilisées, par exemple, pour générer les graphiques affichés dans Administration ARIS > Graphiques > Modélisation. Vous pouvez supprimer les données statistiques pour une ou toutes les bases de données entièrement ou avant une certaine date. La date doit être indiquée sous la forme jj/mm/aaaa.

    Syntaxe

    clearchartdata <dbname> [date]

    <dbname> : Si vous saisissez le nom d'une base de données, seules les données statistiques de cette base de données spécifique sont supprimées.

    all : Supprime les données statistiques de toutes les bases de données de ce locataire.

    date : Supprime les données statistiques à partir d'une certaine date [jj/mm/aaaa].

    copy

    Copie une base de données de <fromdbname> vers <todbname>.

    Syntaxe

    copy <fromdbname> <todbname>

    createdb

    Crée une nouvelle base de données ARIS portant le nom <dbname>.

    Syntaxe

    createdb <dbname> [versioned]

    delete

    Supprime la base de données <dbname>. Si vous avez choisi l'option force, la base de données sera supprimée même si des utilisateurs y sont connectés.

    Syntaxe

    delete <dbname>|all [force]

    dropversions

    Supprime toutes les versions d'une base de données <dbname> jusqu'à la version <new min version>.

    Syntaxe

    dropversions <dbname> <new min version>

    encrypt

    Encode les mots de passe <password> pour une utilisation dans des fichiers batch.

    Syntaxe

    encrypt <password>

    exit

    Quitte le mode interactif.

    exportscript

    Exporte un script du type <MACRO|REPORT|REPORTTEMPLATE|SEMCHECK|PROFILE> avc l'identificateur <scriptid> dans un répertoire d'exportation <exportdirectory>.

    Syntaxe

    <MACRO|REPORT|REPORTTEMPLATE|SEMCHECK|PROFILE> <scriptid> <exportdirectory>

    help

    help retourne une vue d'ensemble de toutes les commandes avec description de syntaxe et paramètres possibles. help <command> retourne cette aide pour la commande saisie.

    Syntaxe

    help [<commande>]

    importfilter

    Importe un filtre de méthode <importfile>.

    Syntaxe

    importfilter <importfile>

    importscript

    Importe un script <importfile> du type <MACRO|REPORT|REPORTTEMPLATE|SEMCHECK|PROFILE> dans la catégorie indiquée <categoryname>.

    Syntaxe

    importscript <MACRO|REPORT|REPORTTEMPLATE|SEMCHECK|PROFILE> <importfile> <categoryname>

    indexstate

    Affiche l'état de l'index de données interne de recherche dans le cloud.

    Syntaxe

    indexstate <Nom de base de données>

    interactive

    Lance le programme en mode interactif.

    kill

    Met fin à la connexion <sessionid> du locataire actuel.

    Syntaxe

    kill <sessionid>|all

    killtask

    Arrête l'activité du serveur <IDtâche> sur l'instance <IDinstance> (par exemple, un rapport qu'il est impossible de terminer).

    Syntaxe

    killtask <instance id> <task id> [force]

    Pour obtenir les identifiants <instanceid> et <taskid>, utilisez la commande surveiller.

    list

    Répertorie toutes les bases de données enregistrées du locataire. Par défaut, seules les bases de données du contexte de schéma actuel seront répertoriées. Lorsque vous sélectionnez l'option all, toutes les bases de données sont affichées (p. ex. également les bases de données BO).

    Syntaxe

    list [all]

    lockdb

    Verrouille la base de données portant le nom <dbname> ou toutes les bases de données. Aucun utilisateur ne peut plus se connecter.

    Syntaxe

    lockdb <dbname>|all

    maintain

    Lance la recréation des indices de recherche (Cloud Search) pour la base de données ARIS indiquée ou toutes les bases de données ARIS. Étant donné que l'exécution de cette commande peut être très longue, il est recommandé de ne l'exécuter que si une erreur se produit et que vous prévoyez une période de maintenance correspondante.

    Syntaxe

    maintain <dbname>|all

    maintainancemode

    Indique le mode de maintenance actuel. maintenancemode on empêche serveur ARIS de mettre à jour automatiquement les bases de données. Cela peut vous aider à réduire le temps d'arrêt après une mise à jour d’serveur ARIS, car les travaux de maintenance qui prennent du temps sont automatiquement arrêtés pour toutes les bases de données. Si vous utilisez cette option, veillez à exécuter manuellement la commande maintain pour les bases de données liées, si nécessaire. Si vous sélectionnez maintenancemode off, tous les travaux de maintenance de la base de données sont exécutés à nouveau.

    Lance la recréation des indices de recherche (Cloud Search) pour la base de données ARIS indiquée ou toutes les bases de données ARIS. Étant donné que l'exécution de cette commande peut être très longue, il est recommandé de ne l'exécuter que si une erreur se produit et que vous prévoyez une période de maintenance correspondante.

    Syntaxe

    maintain <dbname>|all

    Syntaxe

    maintainacemode on|off

    no parameter : Signale le mode actuel.

    on : Active le mode de maintenance et empêche serveur ARIS d’effectuer la maintenance des bases de données.

    off : Désactive le mode de maintenance et permet à serveur ARIS d’effectuer automatiquement la maintenance des bases de données.

    migrate

    Migre une base de données ARIS 7.1 ou 7.2 <dbname> à partir d'un fichier ADB <archive> ou migre tous les fichiers ADB dans un répertoire <archivedir>. Pour migrer une seule base de données, vous avez besoin du mot de passe de l'utilisateur système system. Pour migrer plusieurs bases de données, les mots de passe doivent être transmis en mode lignes de commande pour chaque base de données. Utilisez l'option -fv (forward versioning) pour stocker les versions de la base de données uniquement pour les versions d'ARIS antérieures à 10.0.14.

    Syntaxe

    migrate [<archive>|<archivedir>]|<systempassword> [-fv]

    monitor

    Affiche toutes les activités du locataire en cours, comme la sauvegarde, l'exportation XML etc.

    rename

    Renomme la base de données <olddbname> en <newdbname>. Si vous avez choisi l'option force, la base de données sera supprimée même si des utilisateurs y sont connectés.

    Syntaxe

    rename <olddbname> <newdbname> [force]

    reorg

    Réorganise sémantiquement la base de données <dbname> ou toutes les bases de données, c.-à-d. supprime tous les objets et les définitions de liaisons qui n'apparaissent dans aucun modèle.

    Les options disponibles :

    • CXNDEFS_IN_MATRIX_MODELS

      Les définitions de liaison pour lesquelles il n'existe pas de valeur ne sont pas supprimées lorsqu'elles sont utilisées dans des modèles de type Modèle de matrice.

    • USERDEF_CONTENT_SYMBOLS

      Les symboles personnalisés qui ne sont pas autorisés par Méthode ARIS sur le serveur actuel sont remplacés par un symbole par défaut basé sur la méthode.

    • USERDEF_CONTENT_MODELS

      Les modèles personnalisés qui ne sont pas autorisés par Méthode ARIS sur le serveur actuel sont supprimés.

    • USERDEF_CONTENT_ATTRS

      Les attributs personnalisés qui ne sont pas autorisés par Méthode ARIS sur le serveur actuel sont supprimés.

    • NO_DEFS

      Si vous ne définissez pas une option, les définitions d'objets pour lesquelles aucune valeur n'existe sont supprimées par défaut.

    Syntaxe

    <dbname>|toutes [options]

    restore

    Restaure une base de données <dbname> à partir d'un fichier adb <archive> ou restaure tous les fichiers adb/bdb d'un répertoire. Utilisez l'option -fv (forward versioning) pour stocker les versions de la base de données uniquement pour les versions d'ARIS antérieures à 10.0.14.

    Syntaxe

    restore <archive>|<archivedir> [<dbname>] [-p <password for decryption>] [-b <bucket ID>] [-fv]

    restoresystemdb

    Restaure la base de données système centrale contenant des données telles que des filtres, des modèles de représentation et des scripts à partir d'un fichier de sauvegarde de base de données système (ADB) <archive>. Vous pouvez également mettre à jour la base de données système avec la commande updatesystemdb.

    Après avoir installé une mise à jour, mettez à jour la configuration système de chaque locataire opérationnel (filtres, modèles de représentation et scripts) en prenant pour base la base de données système fournie (<package d'installationARIS>..\Content\SystemDB\*.adb). Tout contenu que vous avez créé est conservé.

    Syntaxe

    updatesystemdb <archive>

    Vous pouvez exécuter la commande pour plusieurs locataires en même temps.

    Syntaxe

    restoresystemdb <archive>

    restoreunversioned

    Génère une base de données non versionnée <dbname> à partir d'un fichier adb <archive> d'une base de données versionnée. Restaure également des bases de données d'après plusieurs fichiers ADB/BDB dans un répertoire.

    Syntaxe

    restoreunversioned <archive>|<archivedir> [<dbname>] [-p <password for decryption>]

    restoreversioned

    Génère une base de données versionnée <dbname> à partir d'un fichier adb <archive> d'une base de données non versionnée. Restaure également des bases de données d'après plusieurs fichiers ADB/BDB dans un répertoire. Si l'option -no_baseline est spécifiée, aucune initiale n'est créée dans l'archive. Utilisez l'option -fv (forward versioning) pour stocker les versions de la base de données uniquement pour les versions d'ARIS antérieures à 10.0.14.

    Syntaxe

    restoreversioned <archive>|<archivedir> [<dbname>] [-p <password for decryption>] [-no_baseline] [-fv]

    schemacontext

    Modifie le contexte de schéma du locataire actuel. Il est donc possible d'enregistrer des bases de données ARIS Optimizer. Les valeurs possibles sont aris et bo.

    Syntaxe

    schemacontext <new schema context>

    server

    Modifie le serveur ARIS actuel.

    Syntaxe

    server <server[:<port>]> <tenant> <user> [<password>] [-ssl]

    sessions

    Affiche toutes les connexions de base de données du locataire actuel.

    Syntaxe

    sessions [byuser|bydatabase]

    set

    Affiche ou modifie les paramètres du locataire. Si aucun paramètre n'est entré, toutes les configurations sont affichées. Si seul le mot <key> est entré, toutes les configurations sont supprimées. Si <key> est entré avec <value>, les configurations sont modifiées en conséquence.

    Syntaxe

    set [<key>] [<value>]

    setindexbucket

    Précise l'ID de bucket pour une base de données.

    Syntaxe

    setindexbucket <dbname> <bucket ID>

    setindexrank

    Définit la plage d'index initiale pour une base de données <dbname>. Plus la plage <rank> est élevée, plus l'index est démarré tôt pendant le démarrage de Cloud Search. La plage est un chiffre, par exemple 5.

    Syntaxe

    setindexrank <dbname> <rank>

    statistic

    Retourne le nombre de tous les objets de la base de données.

    Syntaxe

    statistic <dbname>|all

    threaddump

    Déclenche un thread dump sur l'instance <IDinstance>. Un ID d'instance peut faire référence à un exécutable, comme abs <s, m ou l> ou report <s, m ou l>, voire à un type d'exécutable, comme abs ou report.

    Le thread dump est consigné dans le journal threaddump.log.

    Syntaxe

    threaddump <IDinstance>

    unlockdb

    Déverrouille la base de données portant le nom <dbname> ou toutes les bases de données.

    Syntaxe

    unlockdb <dbname>|all

    updatesystemdb

    Après avoir installé une mise à jour, mettez à jour la configuration système de chaque locataire opérationnel (filtres, modèles de représentation et scripts) en prenant pour base la base de données système fournie (<package d'installationARIS>..\Content\SystemDB\*.adb). Tout contenu que vous avez créé est conservé.

    Syntaxe

    updatesystemdb <archive>

    Vous pouvez exécuter la commande pour plusieurs locataires en même temps.

    userwipeout

    Efface l'identification utilisateur d'un ou plusieurs utilisateurs supprimés d'une ou de toutes les bases de données. Les attributs Last modifier (dernier modificateur), Créateur et le nom de l'utilisateur dans les descriptions de la liste des modifications sont définis à inconnu.

    Syntaxe

    userwipeout <dbname>|all [<user>][,<user>]

    version

    Affiche les versions des programmes et bibliothèques en cours d'utilisation.

    Dans l'exemple suivant, une base de données est réorganisée, en supprimant tous les objets et toutes les liaisons sans valeur qu'elle contient.

    Avertissement

    Si vous utilisez une bibliothèque d'objets, vous ne devriez réorganiser des bases de données que lorsque chaque définition d'objet possède au moins une valeur dans un modèle de vue d'ensemble. Si des éléments déjà créés pour une utilisation ultérieure ne sont pas présents dans les modèles, il seront supprimés lors de la consolidation.

    Réorganisation en mode interactif

    1. Cliquez sur Démarrer > Programmes > ARIS > Administration > ARIS Server Administrator 10.0. La fenêtre de commande MS-DOS s'affiche et l'ARIS Server Administrator est lancé en mode interactif.

    2. Avec la commande server, établissez une connexion à l'serveur ARIS pertinent :

      Syntaxe

      server <server name>[:<port number>] <tenant> <user name>

      Les éléments de la commande qui apparaissent entre crochets sont facultatifs, ce qui signifie que vous pouvez les utiliser en cas de besoin.

      Exemple

      server arissrv.eur.ag:80 default system

      Le système demande le mot de passe.

    3. Saisissez le mot de passe de l'utilisateur. Dans cet exemple, c'est manager. La connexion est établie.

    4. Entrez la commande pour la réorganisation de la base de données United Motor Group :

      reorg "United Motor Group"

    La base de données est réorganisée. Les éléments supprimés sont répertoriés.

    Réorganisation en mode lignes de commande

    1. Ouvrez l'invite de commande à partir du répertoire <ARIS installation directory>\tools\ArisAdm.

    2. Entrez le paramètre de ligne de commande :

      Syntaxe

      arisadm<version> -s <server name> -t <tenant> -u <user name> <password> reorg <database name>

      Exemple

      arisadm.bat -s arissrv.eur.ag -t default -u system manager reorg "United Motor Group"

    La base de données est réorganisée. Les éléments supprimés sont répertoriés.

  2. Entrez la commande suivante :

    Syntaxe : backup <Nom de base de données> <Chemin vers le répertoire d'archives> -p <Mot de passe> [<Nom de base de données>]

    Exemple : backup base de données1 "c:\ARIS 9.0" -p DBADMIN base de données2

La base de données est restaurée dans le répertoire indiqué sous le nom facultatif indiqué.

Vous pouvez restaurer des bases de données sauvegardées sur chaque locataire et ainsi rétablir la base de données à son état avant les modifications.

Le mot de passe défini lors de la sauvegarde doit être entré lors de la restauration de bases de données codées.