Installation fr
From CaisisWiki
| Line 47: | Line 47: | ||
== Installation de la base de données == | == 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":<br> | ||
| + | 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)<br> | ||
| + | 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''' |
<ul> | <ul> | ||
| - | <li>@BackupFile: | + | <li>@BackupFile: Adresse du fichier "Caisis.bak" mentionné ci-haut.</li> |
| - | <li>@WebPassword: | + | <li>@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)</li> |
</ul> | </ul> | ||
| - | ''' | + | '''Le paramètres suivant sont standards et devraient être appropriés pour la plus part des installations.''' |
<ul> | <ul> | ||
| - | <li>@DataFilePath: | + | <li>@DataFilePath: Endroit ou le fichier de base de données (MDF) sera installé. </li> |
| - | <li>@LogFilePath: | + | <li>@LogFilePath: Endroit ou le fichier de transaction (LDF) sera installé.</li> |
| - | <li>@SecurityMode: SQL | + | <li>@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.</li> |
| - | <li>@WebUserName: | + | <li>@WebUserName: Compte d'utilisateur pour l'Application Web. Ce compte permet à l'application de communiquer avec la base de données.</li> |
| - | <li>@DatabaseName: | + | <li>@DatabaseName: Nom de la base de données.</li> |
| - | <li>@DatabaseOwner: | + | <li>@DatabaseOwner: Propriétaire de la base de données, habituellement "sa".</li> |
</ul> | </ul> | ||
Revision as of 15:01, 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".
Upgrade Caisis 3.5 Database to 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.
The upgrade process consists of three sequential steps:
- Upgrade the database using the file 3.5_to_4.0_upgrade_script.sql
- Grant permissions to new objects introduced in 4.0 using the file GrantPermissions.sql
- Import new system data into the database using the file ImportMetadata.sql
You must be connected to the correct database to run these files. If all steps run without error then the upgrade is successful.
NOTE 1: If errors occur during the first step then restore your database and instead of using 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: 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.
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.
