Installation it

From CaisisWiki

Revision as of 07:12, 26 October 2007 by 83.190.8.229 (Talk)
Jump to: navigation, search

Caisis è un'applicazione web in ASP.NET. Gira su un application server; il browser web fornisce l'interfaccia utente di front-end ed un database fa da backed storage. Questa pagina ti guiderà nell'installazione e parametrizzazione del web server e della configurazione del database.

Contents

Requisiti

Sistema Operativo

  • Microsoft Windows 2000
  • Microsoft Windows 2003
  • Microsoft Windows XP Professional

Database Server

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

Web Server

  • Microsoft Internet Information Services (IIS) 5 o superiore

Pre-Installazione

Prima di iniziare l'installazione, è meglio assicurarsi di aver soddisfatto i requisiti di cui sopra e che SQL Server e IIS siano in esecuzione. Questo è necessario quando durante l'installazione gira l'installer e lo script SQL.

Distribuzione ZIP

Caisis 4.0 può essere scaricato come file zip, che contiene i files necessari per il setup e l'avvio dell'applicazione. Ci sono 3 distribuzioni disponibili per il download:

Caisis 4.0 - Nuova installazione

  • WebApp: contiene i files dell'applicazione web necessari per installare manualmente l'applicazione.
  • Installer: contiene il Windows Installer per una installazione standard guidata.
  • Database: contiene i files di script SQL per il Database e il database necessario per installare il databsae Caisis 4.0.

Caisis 4.0 - Upgrade da Caisis 3.5

  • WebApp: contiene i files dell'applicazione web necessari per installare manualmente l'applicazione.
  • Installer: contiene il Windows Installer per una installazione standard guidata.
  • Database: contiene i files di script SQL per l'upgrade del Database Caisis dalla versione 3.5 alla versione 4.0

Caisis 4.0 File sorgenti

Contiene i file Visual Studio Solution ed i sorgenti utilizzati per creare e modificare Caisis 4.0.

Setup del Database

E' necessario loggarsi nell'SQL Server per far girare o installare o upgradare gli scripts.

Setup Scripts

Per una installazione facilitata si raccomanda di avviare SQL server in modalità mista di sicurezza. Dovrai aprire il file SetupDB.sql presente nella cartella Database della distribuzione e compilare i campi seguenti richiesti nella sezione user input:

Required Values

  • @BackupFile: questo è il file database incluso nel download da Caisis.org.
  • @WebPassword: questa è la password che il website userà per connettersi al database

I seguenti valori di default funzionano per molti casi e non è necessario modificarli.

  • @DataFilePath: path dove sarà installato il file del database (MDF).
  • @LogFilePath: path dove sarà installato il file di log del database (LDF).
  • @SecurityMode: impostazione di sicurezza di SQL o Windows. Per usare la sicurezza SQL security accertati che il tuo server stia girando in modalità mista.
  • @WebUserName: l'account per la web application. Questo consente all'applicazione webdi comunicare con il database.
  • @DatabaseName: il nome del database.
  • @DatabaseOwner: il proprietario del database, normalmente sa.

Upgrade Caisis 3.5 Database to 4.0

Prima di iniziare con l'upgrade del database dalla versione 3.5 alla 4.0 si raccomanda di fare un backup del database corrente. Si consiglia di far girare il processo di upgrade su una copia per vedere che non ci siano problemi.

Il processo di upgrade consiste di tre passi sequenziali:

  • Upgrade del database usando il file 3.5_to_4.0_upgrade_script.sql
  • Concessione delle autorizzazioni ai nuovi oggetti introdotti da 4.0 usando il file GrantPermissions.sql
  • Importazione dei nuovi dati di sistema nel database usando il file ImportMetadata.sql

Devi essere connesso al database corrente per far girare questi tre files. Se tutti i passi girano senza errori allora l'upgrade ha avuto successo.

NOTA 1: Se si verificano errori durante il primo passo, ripristina il database ed invece di usare il file 3.5_to_4.0_upgrade_script.sql usa il file nella cartella IndividualScriptFiles fino ad individuare il file esatto che causa il problema. Resolvi i problemi sui dati prima di procedere.

NOTA 2: Il file ImportMetadata.sql provvederà a rimuovere i tuoi vecchi codici di lookup e descrizioni dell'help sostituendoli con nuovi dati. Quindi, se hai fatto cambiamenti, assicurati di backuppare almeno queste tabelle.

Nuove installazioni di SQL Server

Il database server deve essere installato prima di lanciare l'applicazione. L'applicazione accede al Server tramite un account di SQL Server. Dopo aver installato il SQL Server procedi con il passo successivo.

Setup del Database dello User Account

Se hai già installato il SQL Server o se è già in esecuzione, dovrai ora attaccare il database minimo di Caisis e impostare l'account SQL Server usato dall'applicazione web per connettersi al database. Lo script fornito installerà il database sul tuo server e creerà l'account SQL Server necessario.

Web Server Setup

Windows Installer

Caisis viene distribuito con un file di Windows Installer che facilità l'installazione dell'applicazione attraverso una serie di passi. Ogni passo chiederà alcune informazioni specifiche sull'Istituzione, quali il nome, i parametri del database e del log. L'installer troverà automaticamente il server IIS e creerà la Virtual Directory in cui ospitare Caisis. Inoltre nel wizard, c'è una utility chiamata Caisis Configuration Utility, che ti consente di modificare successivamente i parametri della tua applicazione e di testare la connessione al database e al web server.

NOTA: devi loggarti nella macchina come amministratore per installare Caisis usando il Windows Installer distribuito.

Installazione manuale

Se devi configurare l'applicazione manualmente, puoi creare una virtual directory in IIS e depositarvi i files contenuti nella cartella WebAppFolder. Devi anche assicurarti che la tua applicazione stia girando sotto ASP.NET 2.0.

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