Installation fr

From CaisisWiki

Current revision as of 03:05, 30 January 2008

En travail...

Translations: English - italiano

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.

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.

Installation de l'Application Web

Utilitaire d'installation Windows

Avant de débuter l'installation, assurez-vous que le serveur IIS est fonctionnel et que vous avez les permissions nécessaires pour modifier les paramètres. CAISIS contient un utilitaire d'installation qui installe l'application Web en quelques étapes. L'utilitaire Caisis créera un répertoire virtuel dans IIS puis démarera l'utilitaire de configuration de Caisis Caisis Configuration Utility, un programme qui permet d'ajuster les différents paramètres de l'application: information instituionelles, courriel, information de la base de données, et procédure en cas d'erreurs. Il permet aussi de tester la connection à la base de données, permettant de vérifier que les paramètres inscrit précédement sont fonctionnels. Une fois la connection vérifier, la configuration est sauvegardée et l'utilitaire d'installation lancera Caisis dans une fenêtre de votre furteur web.

L'utilitaire de configuration Caisis sera accessible dans le répertoire "program file" de l'utilisateur et peut être utiliser de nouveau pour modifier les paramètres du fichier web.config.

NOTE: Vous devez vous connecter en tan qu'administrateur sur le serveur pour pouvoir utiliser l'utilitaire d'installation de Caisis.

Installation Manuelle

Si vous devez configurer l'application manuellement, vous devez créer un répertoire virtuel dans IIS et y placer les fichiers contenue dans le répertoire "Upgrade/WebApp" inclus dans le téléchargement. Vous devez aussi vous assurer que l'application utilise ASP.NET 2.0. Vous pouvez le vérifier en ouvrant IIS, en cliquant avec le bouton droit de la souris sur le site web Caisis puis en choisissant "Properties". Sélectionner ensuite l'onglet "ASP.NET" et assurez-vous que "2.0" apparaît dans la liste déroulante. Il vous faudra ensuite modifier les paramètre du fichier "web.config" au besoin.

Confirmation de l'installation réussie

Après avoir terminer l'installation à l'aide de l'utilitaire, une page web s'ouvrira. L'adresse typique de l'application sera http://machine_name/virtual_directory/Login.aspx Si votre application est installée sur une machine nommée "onyx" dasns le répertoire "Caisis" par exemple, l'application serait accessible au http://onyx/Caisis/Login.aspx. Si une erreur se produit, nous vous invitons à consulter la page Troubleshooting pour plus d'information.