Guide d'installation du serveur Coriolis Unix/Windows


1/ Cdrom

2/  Installation du serveur

2.0 / Etape 0 : Installation de la V4.2  ( Ne pas installer la version V4.2 sur une version précédente) 

2.1 / Etape 1 : Vérification de l'environnement

2.2 / Etape 2 : Installation du serveur

2.3 / Etape 3 : Mise à jour du .profile (manuelle)

2.4 / Vérification de la reprise de l'environnement

3/ Migration des tables  

ATTENTION : il est conseillé d'effectuer une sauvegarde de la base de données avant la migration

                    3.1 /  Migration depuis un Systeme Windows ( cygwin )

                    3.2 /  Migration depuis un Systeme Unix

                    3.3 / Migration de la base Postgresql 7.2

     

        4/ Compilation des batchs


1/ Cdrom 


 Attention: Avant toute chose, veuillez procéder à une sauvegarde de votre environnement Coriolis, ainsi qu'une sauvegarde des bases Oracle.

Se connecter avec l’utilisateur root :

Créer le système de fichier du cdrom par la commande :

crfs -v cdrfs -p ro -d cd0 -m /cdrom -A yes -t no


Si le système de fichier existe déjà, cette commande échouera avec comme message :
crfs: le système de fichier /cdrom existe déjà

Monter le cdrom par la commande :

mount -rv cdrfs /dev/cd0 /cdrom

2/ Installation du serveur

Se connecter avec l’utilisateur propriétaire du serveur Coriolis (e.g. oracle),
Si vous désirez récupérer les fichiers paramètres d'une version déjà installée, exécuter l'environnement de cette version de Coriolis.
Lancer le script d'installation par la commande :

sh  /cdrom/instcori.sh

Le programme d'installation demande alors l'emplacement du cdrom (par défaut /cdrom).

NB: Lors de la demande de confirmation des répertoires d'installation, si le répertoire mentionné n'existe pas, le script propose de le créer.
Le script teste si le volume nécessaire est disponible sur le filesystem du répertoire choisi avant la descente de l'archive.

        2.0 / Etape 0 : Installation de la version 4.2

Si vous n'avez jamais installé de version V4.2, répondre "non" (N) a la première question et passer au paragraphe 2.1 "Etape1" .

La question suivante vous est posée :   

Avez vous déjà installe une VERSION 4.2 de Coriolis sur ce serveur ? (O/N)

- Si vous n'êtes pas concerné, répondre non (N) et passer au paragraphe 2.1 "Etape 1"
- Répondre oui (O) si vous avez déjà installé une version précédente de la V4.0

Voulez vous installer la version 4.2 de Coriolis au MEME ENDROIT ? (O/N)

- Si vous répondez  Non vous pouvez passer au paragraphe 2.1 "Etape 1"
- Si vous répondez  Oui  l'écran suivant  apparaît :

       ===> ATTENTION :
        1/ Vous devez arrêter le listener de cette version avant de poursuivre


        2/ Les fichiers appartenant à Coriolis seront écrasés !
        Si vous avez modifié ces fichiers pour des besoins spécifiques,
        EN FAIRE UNE SAUVEGARDE avant de continuer

        Voulez vous continuer ? (O/N)

En effet L'installation au même endroit va écraser les anciens fichiers de Coriolis.
Vos répertoires personnels ne faisant pas partie de la livraison de Coriolis ne seront pas écrasés.
Cependant, si vous avez modifié certains fichiers de la livraison Coriolis, ces modifications seront perdues. Il est donc préférable de faire une copie de sauvegarde des modifications sous un nom ou un répertoire personnel.

- Si vous répondez non (N), vous sortez du shell d'installation. Vous pouvez faire vos sauvegardes et relancer  l'installation.
- Si vous répondez oui (O), L'installation se poursuit comme suit :

L'environnement actuel (ROOT=/coriolis/GFV3/Coriolis) est-il l'environnement V4.1 a écraser ? (O/N)

Le shell repère l'environnement actuel et demande confirmation. Cet environnement est - il l'environnement V4.1 ?
Remarque : Vous êtes dans cette configuration si vous vous êtes connecté avec l'utilisateur ou l'environnement  V4.1

- Si vous répondez  non (N), l'écran suivant apparaît :

 Donner le ROOT de la version V4.1 a écraser :
(exemple : /fscoriolis/V401/Coriolis)

Donner le répertoire $ROOT de votre V4.1 que vous désirez écraser.
Une confirmation vous est demandée : 

Répertoire d'installation de Coriolis /fscoriolis/V420
Voulez vous continuer ? (O/N)

En répondant oui (O), l'installation est lancée.
Vous pouvez passer au paragraphe 2.4 "Vérification de la reprise de l'environnement"

- Si vous répondez oui (O)  

Une confirmation vous est demandée : 

Répertoire d'installation de Coriolis /fscoriolis/V420
Voulez vous continuer ? (O/N)

En répondant oui (O), l'installation est lancée.
Vous pouvez passer au paragraphe 2.4 "Vérification de la reprise de l'environnement"

        2.1 / Etape 1 : Vérification de l'environnement


CAS 1: Si vous avez un user n'ayant pas d'environnement Coriolis initialisé  vous obtiendrez l'écran suivant :

Installation du serveur Coriolis.
===================================
1 - Vérification de l'environnement
===================================
Vous installez Coriolis sous l’utilisateur : coriolis4

Cet utilisateur n'a pas d'environnement Coriolis initialisé
Voulez vous récupérer les fichiers paramètres d'un ancien environnement ?


=> Si C'est la première installation de Coriolis sur cette machine, Répondez N pour Non
      Puis répondez O à la question : Voulez vous continuer ? (O/N)
      Et passez à l'étape suivante.
      Après l'installation se référer à la documentation pour initialiser les fichiers :
      licence.txt, ficparam, <instance>param.sh

=> Si une ancienne installation est déjà présente sur la machine,  Répondez O pour Oui
     Donner le ROOT de l'ancienne version Coriolis désirée :
     (Exemple : /coriolis/V401/Coriolis)
      Les fichiers  "licence.txt, ficparam, <instance>param.sh" seront repris de la version donnée.

CAS 2: Vous utilisez un user qui possède un environnement Coriolis déjà initialisé sur une ancienne version. 
Vous obtiendrez alors l'écran suivant :

===================================
1 - Vérification de l'environnement
===================================
Vous installez Coriolis sous l’utilisateur : coriolis
Cet utilisateur a déjà un environnement Coriolis :
 _______________________________________________
ROOT=/coriolis/GFV38/Coriolis
SRC=/coriolis/GFV38/Coriolis/Src
EXEC=/coriolis/GFV38/Coriolis/Exe
TOOLS=/coriolis/GFV38/Coriolis/Tools
CORIOLIS_USER=coriolis
CORIOLIS_PASSWD=coriolis
 _______________________________________________
Voulez vous récupérer les fichiers paramètres de cet environnement ? (O/N)
Répondre Oui

      2.2 / Etape 2 : Installation du serveur

L'étape 2 s’enchaîne, vous obtenez l’écran suivant :

===========================
2 - Installation du serveur
===========================
Espace nécessaire: 173452K
Répertoire d'installation de Coriolis ?
(/coriolis/GFV4/Coriolis):


Donner le répertoire d'installation désirée pour la nouvelle version
S'il n'y a pas assez de place, un autre répertoire sera demandé.
Si le répertoire n'existe pas, il sera créer.

      2.3 / Etape 3 : Mise à jour du .profile (manuelle)

Une fois l'installation terminée. Il faut mettre à jour :
            - /<répertoire d'installation de Coriolis>/profile_coriolis si vous avez besoin de rajouter des spécificités.
Afin de faciliter la mise à jour, l'ancien profile_coriolis de la version précédente à été copié dans le même répertoire avec l’extension .old_version

    - le fichier .profile de l'utilisateur coriolis  afin qu'il exécute profile_coriolis
Ajouter par exemple la ligne suivante dans le . profile :
 .   <PATH de Coriolis>/Coriolis/profile_coriolis

Attention : Pour la suite de l'installation, exécuter cette commande en ligne de commande ou sortir de la session et se relogger.
     

      2.4 / Vérification de la reprise de l'environnement

Si au début de l'installation vous avez demandé de reprendre les fichiers paramètres de l'environnement de la version précédente, on doit avoir les éléments suivants :

- Les fichiers liens  <PATH de Coriolis>/Coriolis/Tools/Oracle/Coridba/<ORACLE_SID>param.sh  ( 1 par base)
- Le fichier <PATH de Coriolis>/Coriolis/Src/Batch/Exploit/Script/ficparam
- Le fichier de licences <PATH de Coriolis>/Coriolis/Exe/licences.txt

3/ Migration des tables


                    3.1 / Migration depuis un Systeme WINDOWS ( cygwin )

        Quelques petits problèmes de compatibilité avec cygwin sont présents dans les scripts de migration . Il est conseillé , pour eviter tout problème , de migrer les bases sous un serveur windows en lancant les scripts via cygwin .

De la V4.0 à la V4.1

  1.   Se connecter à cygwin dans le nouvel environnement
  2.   Positionner la variable ORACLE_SID à la bonne valeur ( Ex ; export ORACLE_SID=PROD ou CORIOLIS_CONNECT=@PROD si base déportée)
  3.    se mettre sous cd $TOOLS/Migration/Repv40v41/Oracle
  4.    lancer les scripts suivants :
  5. sqlplus $CORIOLIS_USER/$CORIOLIS_PASSWD$CORIOLIS_CONNECT 
    start admin
    start axan
    start apcp
    start bien
    start compta
    start marc
    start prepa
    start oper
    start stock
    start version

  6. cd $TOOLS/Script
    sh crea-table-all.sh

  7. echo "Initialisation des tables de la préparation budgétaire en AP"
    cd $SRC/Batch/Prepa/Script
    sh prepjinit.sh
  8. Chargement des tables d’administration
    1. sh $TOOLS/Build/load_wapi
    2.  sh $TOOLS/Build/load_hbat         
    3. sh $TOOLS/Build/load_web
    4. sh $TOOLS/Script/crea-view-all.sh


De la V4.1 à la V4.2
  1.   Se connecter à cygwin dans le nouvel environnement
  2.   Positionner la variable ORACLE_SID à la bonne valeur ( Ex ; export ORACLE_SID=PROD ou CORIOLIS_CONNECT=@PROD si base déportée)
  3.    se mettre sous cd $TOOLS/Migration/Repv41v42/Oracle
  4.    lancer les scripts suivants :
    1. sh admin.sh
    2. sh apcp.sh
    3. sh bien.sh
    4. sh compta.sh
    5. sh marc.sh
    6. sh mars.sh
    7. sh prepa.sh
  5. Sous sqlplus coriolis/coriolis lancer le script version.sql
  6. Chargement des tables d’administration
    1. sh $TOOLS/Script/crea-table-all.sh
    2. sh $TOOLS/Build/load_wapi
    3.  sh $TOOLS/Build/load_hbat         
    4. sh $TOOLS/Build/load_web
    5. sh $TOOLS/Script/crea-view-all.sh
  1. Lancement du script sous $TOOLS/Migration/Repv41v42/oracle sh tierfin.sh
  2. sh $TOOLS/Script/crea-table-all.sh
  3. sh $TOOLS/Script/crea-view-all.sh

                    3.2 / Migration depuis un Systeme UNIX


Se logger avec l'utilisateur Coriolis V4.
Vérifier que les variables $CORIOLIS_USER, $CORIOLIS_PASSWD sont positionnée.
Lancer la commande :

   sh   /cdrom/migr_cor.sh ou  $TOOLS/Install /migr_cor.sh depuis votre nouvel environnement

Le programme de migration des tables Coriolis rappelle l'environnement utilisé et vous demande si vous désirez continuer.
Répondre Oui.

La liste des bases trouvées est affichée, Donner le chiffre de la base que vous désirez migrer.
Si la base n'a pas été trouvée, vous pouvez choisir l'option 2 (Autre base) et donner l'ORACLE_SID désirée.

=================================
3 - Migration d'une base en V4.2
=================================
 1) quitter
 2) Autre_base
 3) CTEE
 4) CTEF
 5) TBPE
 6) TBPF
Numéro de la base a migrer en V4.2 ? :   6

ORACLE_HOME=/oracle/app/oracle/product/7.3.4/
 BASE CHOISIE = TBPF
Voulez vous continuer ? (O/N) O

----------------------------------
Lancement des shells de migration
----------------------------------
-----------------------------------
Choix de la migration a effectuer
-----------------------------------
1 - Version 400 ou 401 vers 42
2 - Version 410 vers 42
Repondre 1 ou 2 SVP

 

Répondre 1 ou 2 en fonction de la version précédente de votre base coriolis.


Si des listeners tournent sur cette base, Ils seront signalés.
Si vous désirez continuer, Ces listeners seront arrêtés.

Si la base n'est pas démarrée, le mot de passe de SYSTEM est demandé et la base est automatiquement démarrée.

Par la suite, une série de shells de migration des tables est lancée automatiquement.
A la fin de chaque shell, le fichier résultat (/tmp/<nom du shell>.result ) est vérifié.
(Les fichiers de redirection ne sont pas effacés à la sortie, vous pouvez donc les consulter a titre d'information.)
- Si aucune erreur est trouvée, le shell suivant est lancé.
- Si des erreurs sont trouvées, on vous propose de regarder le fichier résultat.
   En répondant "oui" (O)  à la proposition, un vi s'ouvre sur le fichier résultat vous permettant de le parcourir.
   En sortant du vi (<Esc>:q!) , Vous pouvez faire le choix de continuer la migration ou d’arrêter.

Rappel vi :

    En avant d’une page      => Ctrl + F   ou Ctrl + D
    En arrière d’une page    => Ctrl + B  ou Ctrl + U
    Recherche                     => Esc  /<mot recherché>   ( Puis "n" pour  le mot suivant)
    Nom du fichier               => Esc + :f
    Sortir sans sauvegarder  => Esc + :q!
 
A titre d’information, la liste des shells lancés par ce script est la suivante :

si Migration depuis Coriolis V40x

# Migration des tables

cd $TOOLS/Migration/Repv40v41/Oracle

sh migrv410.sh

cd $TOOLS/Migration/Repv41v42/Oracle

sh migrv420.sh


si Migration depuis Coriolis V41

        # Migration des tables

cd $TOOLS/Migration/Repv41v42/Oracle

sh migrv420.sh

 

Dans tous les cas

<> # Chargement des tables d’administration

<>            sh $TOOLS/Script/crea-table-all.sh
<>            sh $TOOLS/Build/load_wapi
<>            sh $TOOLSScript/loadncmp-all.sh
<>            sh $TOOLS/Build/load_hbat
                  sh $TOOLS/Build/load_web
                  sh $TOOLS/Migration/Repv41v42/Oracle/tierfin.sh
# Chargement des vues Oracle

sh $TOOLS/Script/crea-view-all.sh

# Chargement des commentaires Oracle
sh $TOOLS/Script/crea-comments-all.sh

sh $TOOLS/Migration/Repv41v42/Oracle/tierfin.sh

sh  $TOOLS/Script/crea-table-all.sh

                    3.3 / Migration d'une base V 4.2 en Postgresql 7.2

     
  1.   Se connecter à cygwin dans le nouvel environnement
  2.   Positionner la variable ORACLE_SID à la bonne valeur ( Ex ; export ORACLE_SID=PROD )
  3.    se mettre sous cd $TOOLS/Migration/Repv41v42/Postgresql
  4.    lancer le script suivant :
    1. sh migrv420.sh
  5. Chargement des tables d’administration
    1. sh $TOOLS/Script/crea-table-all.sh
    2. sh $TOOLS/Build/load_wapi
    3.  sh $TOOLS/Build/load_hbat         
    4. sh $TOOLS/Build/load_web
    5. sh $TOOLS/Migration/Repv41v42/Oracle/tierfin.sh
    6. sh $TOOLS/Script/crea-view-all.sh

4/ Compilation des batchs


Se logger avec l'utilisateur Coriolis.
Vérifier que l'environnement Coriolis est présent.
Lancer la commande :

sh  /cdrom/compilbatch.sh

A la question :
Voulez vous récupérer les FORMAT*-U d'une version précédente (O/N) ?
Répondre O
Et donner le chemin des fichiers de format d’édition a récupérer
ex: /CORIOLIS3.8/Coriolis/Src/Batch/Exploit/Copy

La compilation de l’ensemble des répertoires suivants est lancée automatiquement :
    $ROOT/Src/Batch/Exploit/Src
    $ROOT/Src/Batch/Admin/Src
    $ROOT/Src/Batch/Bien/Src
    $ROOT/Src/Batch/Compta/Src
    $ROOT/Src/Batch/Stock/Src
    $ROOT/Src/Batch/Apcp/Src
    $ROOT/Src/Batch/Prepa/Src

Dans le répertoire $ROOT/Src/Batch/Exploit/Src, le shell exécute les commandes suivantes :

makeMakefile .
make -f install.mk

Dans tous les répertoires suivants les commandes ci-dessous sont executées par le shell :

makeMakefile .
make all


Si la compilation n'arrive pas à terme vous pouvez voir le fichier résultat et décider d’arrêter la compilation ou de continuer.

Compilation des batchs sous windows :

    Par la commande:
        $SRC/Batch/Admin/Src/
        make -f MakefileNT all