Installation fr

From CaisisWiki

(Difference between revisions)
Jump to: navigation, search
Line 74: Line 74:
</ul>
</ul>
-
==== Upgrade Caisis 3.5 Database to 4.0 ====
+
==== Mise à jour de la base de données de Caisis 3.5 vers 4.0 ====
-
Before attempting to upgrade the database from 3.5 to 4.0 it is recommended to make a backup of your current database. It is advisable to run the database upgrade process on a copy to see if any problems may occur.
+
Avant de faire une mise à jour officielle de la base de donnée de 3.5 vers 4.0, il est recommendé de faire une copie de votre base de données. Il est ensuite optimal d'essayer le script de mise à jour sur cette copie pour déceler les problèmes potentiels.
-
The upgrade process consists of three sequential steps:
+
La mise à jour comprend trois étapes successives:
<ul>
<ul>
-
<li>Upgrade the database using the file 3.5_to_4.0_upgrade_script.sql</li>
+
<li>Exécuter le script "3.5_to_4.0_upgrade_script.sql" pour mettre à jour la base de données.</li>
-
<li>Grant permissions to new objects introduced in 4.0 using the file GrantPermissions.sql</li>
+
<li>Exécuter le script "GrantPermissions.sql" qui attribue les permissions d'accès aux nouveaux objets introduits dans la version 4.0.</li>
-
<li>Import new system data into the database using the file ImportMetadata.sql</li>
+
<li>Exécuter le script "ImportMetadata.sql" pour importer les nouvelles données de la version 4.0.</li>
</ul>
</ul>
-
You must be connected to the correct database to run these files. If all steps run without error then the upgrade is successful.
+
Vous devez vous assurer de vous connecter à la bonne base de données pour exécuter ces fichiers. Si l'exécution se comptète sans erreur, la mise à jour est réussie.
NOTE 1:
NOTE 1:
-
If errors occur during the first step then restore your database and instead of using
+
Si une erreur se produit lors de l'étape 1, il faut alors recommencer le processus avec une nouvelle copie de la base de données. Au lieu du script "3.5_to_4.0_upgrade_script.sql", il faudra utiliser de façon séquentielle  les scripts dans le répertoire "IndividualScriptFiles" jusqu'à ce que le script fautif soit identifié. Il faudra alors modifier la base de données avant de poursuivre.
-
3.5_to_4.0_upgrade_script.sql run the files in the folder IndividualScriptFiles until the
+
-
exact file is found that is causing a problem. Resolve data errors before proceeding.
+
NOTE 2:
NOTE 2:
-
The ImportMetadata.sql file will remove your old lookup codes and help descriptions and replace it with the new data. So if you have made many changes to your own data be sure to backup at least those tables.
+
Le script "ImportMetadata.sql" détruira les "lookup codes" de la version 3.5 et les notes d'aide (que vous auriez pu modifier) et les remplacera avec ceux de la version 4.0. Si vous avez fait des changements, veuillez vous assurez de faire une copie de ces tables.
== Web Application Setup ==
== Web Application Setup ==

Revision as of 15:43, 24 January 2008

En travail...

Version 4.0 - Notes de version

Caisis est une application web ASP.NET supportée par une base de données (BD) SQL Server. Les utilisateurs interagissent avec l'application à travers un furteur web. La version 4.0 est compatible avec Internet Explorer version 7.0 (et précédente), FireFox, et Safari 3.0 (Mac).

Caisis a été développé avec la possibilité de passer de un à un millier d'utilisateurs sans problème. Bien évidemment, le nombre d'utilisateurs anticipés devra guider le choix du serveur et de ses caractéristiques. Au minimum, le système Caisis requière 5 GB d'espace disque et 512 MB de mémoire vive (RAM). Caisis requière l'engin SQL pour fonctionner mais on peut utiliser SQL Server 2005 Express (disponible gratuitement sur le site web de Microsoft) - au lieu de la version Enterprise - pour tester Caisis et débuter avec quelques utilisateurs. Il faut tout de même s'assurer d'avoir accès a un serveur avec Windows Server et IIS installés.

Cette présente les étapes nécessaires à l'installation de la base de données et de l'application web.


Contents

Prérequis Système

Système d'exploitation

  • Microsoft Windows 2000
  • Microsoft Windows 2003
  • Microsoft Windows XP Professionel

Serveur de base de données

  • Microsoft SQL Server 2000
  • Microsoft SQL Server 2005
  • Microsoft SQL Server Express Edition

Serveur Web

  • Microsoft Internet Information Services (IIS) 5 ou subséquent

Avant l'installation

Assurez-vous de remplir tous les prérequis ci-haut. Vous devez aussi vous assurer que la strucutre .NET 2.0 Framework est installée sur votre serveur et que SQL server ainsi que Internet Information Services (IIS) sont démarrés.

La structure .NET 2.0 Framework est disponible gratuitement ici.

L'exécution de ces étapes préparatoires permet une exécution sans problème de l'utilitaire d'instalation de Caisis et du script d'installation SQL.

Téléchargement

Caisis 4.0 peut-être téléchargé en format "zip" qui contient les fichiers pour l'installation de la base de donnée et de l'application web. Trois différents fichiers zip sont disponibles:

Caisis 4.0 - Nouvelle Installation

  • Database: Contient les différents fichiers script SQL et les fichiers base de données nécessaires à l'installation de la BD de Caisis 4.0.
  • Installer: Contient l'utilitaire d'installation Windows.

Caisis 4.0 - Mise à jour à partir de Caisis 3.5

  • WebApp: Contient les fichiers de l'application web pour une installation manuelle. Il faut alors copier ses fichiers sur le serveur IIS manuellement au lieu d'utiliser l'utilitaire d'installation
  • Installer: (recommandé) Contient l'utilitaire d'installation Windows pour une installation régulière. Avant de l'utiliser, il est recommandé de désintaller les versions antérieures de Caisis en utilisant le panneau de controle: Ajouter/Enlever des applications. *** Assurez-vous d'avoir fait une copie de sauvegarde si vous avez fait des modifications à l'application web.
  • Database: Contient les différents fichiers script SQL et les fichiers base de données nécessaires à la mise à jour de Caisis 3.5 vers Caisis 4.0.

Caisis 4.0 Fichiers sources

Contient les fichiers Visual Studio Solution pour modifier et recompiler Caisis 4.0.

Installation de la base de données

Vous devrez vous authentifier sur votre serveur SQL pour exécuter les scripts d'installation ou de mise à jour.

Scripts d'installation

Nouvelle intallation de Caisis 4.0 (Base de données)

Deux fichiers se trouve dans le répertoire "Caisis_v4.0_NewInstall/Database":
1) SetupDB.sql : le script SQL qui, exécuté avec "SQL Server Management Studio" va installer la base de données Caisis. Vous devez avant ouvrir le script "SetupDB.sql" dans le répertoire Database des fichiers téléchargés et compléter la section "input section". (Voir liste des paramètres ci-bas)
2) Caisis.bak : il est recommendé de mettre ce fichier dans un répertoire nommé "Downloads" sur votre disque C: (C:\Downloads\Caisis.bak). Autrement, il faut s'assurer de modifier le paramètre @BackupFile dans le script "SetupDB.sql" pour pointer vers le répertoire de votre copie de "Caisis.bak".

SetupDB.sql: Paramètre requis

  • @BackupFile: Adresse du fichier "Caisis.bak" mentionné ci-haut.
  • @WebPassword: Mot de passe que l'Application Web va devoir utiliser pour se connecter à la base de données (le script créera le mot de passe lors de son exécution)

Le paramètres suivant sont standards et devraient être appropriés pour la plus part des installations.

  • @DataFilePath: Endroit ou le fichier de base de données (MDF) sera installé.
  • @LogFilePath: Endroit ou le fichier de transaction (LDF) sera installé.
  • @SecurityMode: Mode de sécurité SQL ou Windows. Pour utiliser le mode "SQL security", veillez vous assurer que votre serveur fonctionne en mode de sécurité mixte.
  • @WebUserName: Compte d'utilisateur pour l'Application Web. Ce compte permet à l'application de communiquer avec la base de données.
  • @DatabaseName: Nom de la base de données.
  • @DatabaseOwner: Propriétaire de la base de données, habituellement "sa".

Mise à jour de la base de données de Caisis 3.5 vers 4.0

Avant de faire une mise à jour officielle de la base de donnée de 3.5 vers 4.0, il est recommendé de faire une copie de votre base de données. Il est ensuite optimal d'essayer le script de mise à jour sur cette copie pour déceler les problèmes potentiels.

La mise à jour comprend trois étapes successives:

  • Exécuter le script "3.5_to_4.0_upgrade_script.sql" pour mettre à jour la base de données.
  • Exécuter le script "GrantPermissions.sql" qui attribue les permissions d'accès aux nouveaux objets introduits dans la version 4.0.
  • Exécuter le script "ImportMetadata.sql" pour importer les nouvelles données de la version 4.0.

Vous devez vous assurer de vous connecter à la bonne base de données pour exécuter ces fichiers. Si l'exécution se comptète sans erreur, la mise à jour est réussie.

NOTE 1: Si une erreur se produit lors de l'étape 1, il faut alors recommencer le processus avec une nouvelle copie de la base de données. Au lieu du script "3.5_to_4.0_upgrade_script.sql", il faudra utiliser de façon séquentielle les scripts dans le répertoire "IndividualScriptFiles" jusqu'à ce que le script fautif soit identifié. Il faudra alors modifier la base de données avant de poursuivre.

NOTE 2: Le script "ImportMetadata.sql" détruira les "lookup codes" de la version 3.5 et les notes d'aide (que vous auriez pu modifier) et les remplacera avec ceux de la version 4.0. Si vous avez fait des changements, veuillez vous assurez de faire une copie de ces tables.

Web Application Setup

Windows Installer File

Before beginning the installation, please make sure IIS is running and that you have permissions to the modify settings. Caisis comes packed in a Windows Installer file which will install the application through a series of steps. The installer will setup your virtual directory in IIS for hosting Caisis and then launch the Caisis Configuration Utility, a desktop application which will allow you to to modify various settings in your application, such as Institution settings, Email settings, Database settings and Error Handling. It will also allow you to test your connection to the Database, ensuring that you can connect using your settings. Once your have confirmed the settings, you can then save your configuration and the installer will end and launch the application in a new window.

The Caisis Configuration Utility will be located in the user's program files directory and can be launched anytime to mange the settings in your web.config file.

NOTE: You will need to log in to the server as an administrator to install Caisis using the provided Windows Installer.

Manual Installation

If you need to manually configure the application, you can create a virtual directory in IIS and place the files contained in the Upgrade/WebApp Folder in there. You will also need to verify that your application is running under ASP.NET 2.0. You can check this, and other web site properties, by opening IIS, find the Caisis web site, right clicking on it and choose properties. When the dialogue box opens select the "ASP.NET" tab and check that 2.0 appears in the drop down box.

Confirm Application Running

After running the Setup file, a web page will launch to your application. The typical URL of your application will be http://machine_name/virtual_directory/Login.aspx If you application was installed on machine ONYX in the virtual directory Caisis, your application would be located at http://onyx/Caisis/Login.aspx. If you receive any errors, you can consult the Troubleshooting page for help diagnosing the issues.

Personal tools