Installation fr

From CaisisWiki

(Difference between revisions)
Jump to: navigation, search
Line 47: Line 47:
== Installation de la base de données ==
== Installation de la base de données ==
-
You will need to log into your SQL Server in order to run the install or upgrade scripts.
+
Vous devrez vous authentifier sur votre serveur SQL pour exécuter les scripts d'installation ou de mise à jour.
-
=== Setup Scripts ===
+
-
==== New Caisis 4.0 Database ====
+
=== Scripts d'installation ===
-
You will find two files in the Caisis_v4.0_NewInstall/Database folder:<br>
+
==== Nouvelle intallation de Caisis 4.0 (Base de données) ====
-
1) '''SetupDB.sql''' : the SQL script that when executed within SQL Server Management Studio will restore the Caisis database.  
+
-
You will need to open the SetupDB.sql file located in the '''Database''' folder of the package and fill in the required fields in the user input section. Below is a list of parameters.<br>
+
-
2) '''Caisis.bak''' : by default you should put this database backup file in a "Downloads" folder on your C drive (C:\Downloads\Caisis.bak). Otherwise, update the @BackupFile parameter in the above .sql file to point to your copy of Caisis.bak.
+
 +
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".
-
'''Required Values'''
+
'''SetupDB.sql: Paramètre requis'''
<ul>
<ul>
-
<li>@BackupFile: This is the database file included in the download at Caisis.org.</li>
+
<li>@BackupFile: Adresse du fichier "Caisis.bak" mentionné ci-haut.</li>
-
<li>@WebPassword: this is the password that the website will use to connect to the database</li>
+
<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>
-
'''The following default values work for most cases and don't need to be edited.'''
+
'''Le paramètres suivant sont standards et devraient être appropriés pour la plus part des installations.'''
<ul>
<ul>
-
<li>@DataFilePath: This is the path where the database file (MDF) will be installed. </li>
+
<li>@DataFilePath: Endroit ou le fichier de base de données (MDF) sera installé. </li>
-
<li>@LogFilePath: This is the path where the transaction log file (LDF) will be installed.</li>
+
<li>@LogFilePath: Endroit ou le fichier de transaction (LDF) sera installé.</li>
-
<li>@SecurityMode: SQL or Windows mode security setting. To use SQL security make sure your server is running in mixed mode.</li>
+
<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: The web application account. This allows the webserver application to communicate with the database.</li>
+
<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: The name of the database.</li>
+
<li>@DatabaseName: Nom de la base de données.</li>
-
<li>@DatabaseOwner: The owner of the database, usually sa.</li>
+
<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.

Personal tools