MANUAL DE INSTALACIÓN PLATAFORMA PROGRESA AUTOR: ASAC COMUNICACIONES DEPARTAMENTO DE DESARROLLO NOVIEMBRE DE 2007
INDICE 1 INTRODUCCIÓN...2 2 REQUISITOS...3 3 INSTALACIÓN...4 3.1 INSTALACIÓN DEL MICROSOFT.NET FRAMEWORK VERSIÓN 2.0:...4 3.2 INSTALACIÓN DEL CRYSTALREPORT...7 3.2.1 Instalación de CRRedist2005_x86.msi...8 3.2.2 Instalación de CRRedist2005_x86_es.msi...10 3.3 INSTALACIÓN DE HERRAMIENTA PROGRESA...12 4 CONFIGURACIÓN...15 4.1 CREACIÓN DE LAS BASES DE DATOS...15 4.2 CONFIGURACIÓN DEL IOS (SERVIDOR WEB)...15 4.2.1 Como realizar cadena conexión...20 4.3 PERMISOS DE ESCRITURA....22 1
1 INTRODUCCIÓN Este manual contiene las instrucciones de uso de la Herramienta Web Progresa, desarrollada por el Departamento de Desarrollo de ASAC Comunicaciones. En él se explica cómo instalar la aplicación y como realizar la configuración de la misma. Los datos que se muestran en las interfaces de ejemplo son datos creados al azar y no correspondiendo a ninguna persona física involucrada en el proyecto. Se introducen estos datos ficticios para el mejor entendimiento de las pantallas sobre las que interactúa el usuario. En caso de tener alguna duda, sugerencia o reclamación contacte con Asac Comunicaciones en el teléfono 985.265.040 o bien, a través de la dirección de correo electrónico desarrollo@asac.as. Si optase por esta vía de comunicación haga una breve descripción del problema que se le haya planteado. Departamento de Desarrollo Asac Comunicaciones 2
2 REQUISITOS La instalación de la herramienta Progresa debe realizarse sobre un servidor con los siguientes requisitos mínimos: Hardware: Procesador Xeon 2 Gb RAM Discos duros SAS Se trata de una configuración recomendada para que la herramienta funcione de una forma ágil y rápida. Con una configuración menos potente funcionará, pero la velocidad de la aplicación puede verse resentida. Software: Microsoft Windows 2003 Server IIS 6.0 Microsoft Framework.NET 2.0 Microsoft SQL Server 2005 3
3 INSTALACIÓN La instalación de la que dispondrá el usuario está formada por cuatro archivos: Instalación.msi: Fichero propio de la instalación de la aplicación setup.exe: CrystalReports: Además del instalador de la herramienta y del Crystal Reports, también es necesaria la instalación de Microsoft.net Framework versión 2.0, el cual se descarga automáticamente si no se tiene instalado. El archivo es el siguiente: A continuación se describen los pasos a seguir para la instalación de la aplicación: 3.1 INSTALACIÓN DEL MICROSOFT.NET FRAMEWORK VERSIÓN 2.0: La herramienta Progresa se ha desarrollado utilizando Visual Studio 2005, en ASP.NET utilizando C# como lenguaje de programación. Toda aplicación realizada en.net, como es este caso, necesita para su funcionamiento tener instalado el Microsoft.NET Framework. En primer lugar se instalará el Microsoft.NET Framework Versión 2.0, para ello se hace doble clic sobre el archivo dotnetfx.exe. Se abrirá la interfaz siguiente: 4
Se pulsa el botón [Ejecutar] y se empezará la instalación: Cuando termina el proceso de extracción, se abre el asistente de la instalación: Se pulsa el botón [Siguiente] y aceptamos los términos del contrato: 5
Se pulsa el botón [Instalar] y comenzará la instalación del.net Framework: Se mostrarán varias pantallas de generación e instalación como la siguiente: 6
Cuando este proceso termina, se abrirá la siguiente pantalla: Pulsando el botón [Finalizar] ya se habrá terminado la instalación del.net Framework. 3.2 INSTALACIÓN DEL CRYSTALREPORT CrystalReports es una carpeta que contiene los archivos para la instalación del CrystalReport, necesarios para la correcta visualización de los formularios e informes que se obtendrán de la aplicación propia del proyecto: 7
Una vez instalado el.net Framework es el momento de instalar el CrystalReport. Primero se instalará CRRedist2005_x86.msi, motor del generador de infornmes, y posteriormente CRRedist2005_x86_es.msi, paquete del lenguaje español. 3.2.1 Instalación de CRRedist2005_x86.msi El primer paso para la instalación del Cristal Reports es la instalación de CRRedist2005_x86.msi. Para iniciar la instalación se hace doble clic sobre el archivo y se abre el asistente de instalación siguiente: Se pulsa el botón [Next>] y se abrirá la pantalla de confirmación del contrato: 8
Se acepta el contrato (I Agree), se pulsa el botón [Next >] y se inicia el proceso de instalación: Una vez que termine el proceso de instalación se mostrará la última pantalla: 9
Pulsando el botón [Close] se finaliza la instalación del CrystalReport. 3.2.2 Instalación de CRRedist2005_x86_es.msi Una vez instalado el crystalreport tenemos la opción de instalar el paquete de traducción a español del CrystalReport, para ello se hace doble clic sobre el fichero CRRedist2005_x86_es.msi y se abrirá el asistente de instalación: Se pulsa el botón [Siguiente >] para continuar con la instalación del paquete, y se abre la siguiente interfaz de confirmación: 10
Si se pulsa el botón [Siguiente >] empezará el proceso de instalación: Una vez finalizado este proceso se abrirá la siguiente pantalla: 11
Pulsando el botón [Cerrar] se finaliza la instalación 3.3 INSTALACIÓN DE HERRAMIENTA PROGRESA Cuando ya se tiene instalado correctamente el Microsoft.NET Framework y el CrystalReport es el momento de la instalación de la herramienta progresa. Para ello se hace doble clic sobre el fichero Progresa.msi y se abre el asistente de instalación: Se pulsa el botón [Siguiente >] y se abre la pantalla para seleccionar la ruta donde se instalará la herramienta y el nombre que se desea poner al sitio web: 12
El programa de instalación solicitará el Sitio para almacenar la herramienta, en este caso se selecciona Sitio Web Predeterminado. En el directorio virtual se especificará el nombre del sitio Web. El programa de instalación generará el sitio Web es el Sitio especificado, copiando todos los archivos de la herramienta en es directorio virtual. Una vez se tiene la ruta, se pulsa el botón [Siguiente >] y se abre la pantalla de confirmación: Pulsando en el botón [Siguiente >] se inicia el proceso de instalación: 13
Una vez finalizado el proceso de instalación se abre la última pantalla de la instalación: Pulsando el botón [Cerrar] se finaliza el proceso de instalación. 14
4 CONFIGURACIÓN Una vez instalada la herramienta es el momento de la configuración del sitio Web que se ha generado. 4.1 CREACIÓN DE LAS BASES DE DATOS El CD de instalación incluye dos copias de las bases de datos necesarias para la ejecución de la aplicación Web progresa. Estas copias de seguridad son ASPNETDB.bak y PROGRESA.bak. El primer paso será la creación de las bases de datos en el Microsoft SQL Server del servidor en el que se desee instalar la aplicación, para ello se restauraran las copias en el servidor SQL Server utilizando la opción de restaurar copia de seguridad que incluye la herramienta de administración. Una vez se tengan las bases de datos creadas y el SQL Server configurado para el acceso a dichas bases de datos se podrá comenzar con la configuración del ISS. 4.2 CONFIGURACIÓN DEL IOS (SERVIDOR WEB) Para llevar a cabo la configuración de la aplicación sobre el servidor Web, deberán seguirse los siguientes pasos: 1.- Abrir el IIS (Internet Information Server), para lo que seleccionaremos Inicio > Panel de control > Herramientas administrativas > Administrador de Internet Information Services (IIS) 15
Figura 2.1.- IIS 2.- Accederemos a Sitios Web Sitio Web predeterminado dentro del IIS y buscaremos el sitio Web cuyo nombre corresponda con el indicado en la instalación. A continuación configuramos el sitio Web pulsando el botón derecho del ratón Propiedades. Se obtiene una pantalla similar a la siguiente: 16
Como se observa en la imagen anterior, el propio instalador a creado el sitio Web con nombre Progresa situado en C:\Inetpub\wwwroot\Progresa, la ruta por defecto de las aplicaciones Web en el ISS. Si accedemos a la pestaña ASP.NET tendremos lo siguiente: Antes de continuar, asegúrese que la Versión de ASP.NET seleccionada sea la 2.0.50727. Si se pulsa [Editar Configuración] obtendremos la configuración del web config de la aplicación: 17
En la pestaña General se deberá configurar las cadenas de conexión. Se deberán tener dos cadenas de conexión. - ProgresaConecctionString: Enlazando con la base de datos Progresa generada en el apartado 3.1 de este manual. - LocalSqlServer: Enlazando con la base de datos ASPNETBD también generada en el apartado 3.1 de este manual. Para configurarlas se seleccionará en primer lugar LocalSqlServer y se pulsará [Editar ], en el campo de texto del que disponemos se introducirá la cadena de conexión correspondiente a la base de datos ASPNETBD (Ver Como realizar cadena conexión ). Se procederá a configurar de la misma manera la cadena de conexión progresaconnectionstring pero indicando la cadena de conexión correspondiente a la base de datos Progresa (Ver Como realizar cadena conexión ). Además de la configuración de estas dos cadenas de conexión se debe modificar la cadena de conexión de acceso a datos, ya que para ese fin se utiliza NHibbernate, y ésta necesita su propia cadena de conexión. Para realizar esta operación se debe acceder al directorio del sitio web (por defecto c:\inetpub\wwwroot\progresa), en ese directorio se pulsa con el botón derecho sobre el archivo web.config y se selecciona [Abrir con] bloc de notas. Una vez abierto el web.config se deberá buscar la etiqueta siguiente: 18
<hibernate-configuration xmlns="urn:nhibernate-configuration-2.2"> Dentro de esta etiqueta tendremos, entre otras: <property name="connection.connection_string"> XXX </property> En lugar de XXX se debe escribir la cadena de conexión correspondiente a la base de datos Progresa, que será la misma que se introdujo en la configuración del IIS, descrito anteriormente. Una vez modificado, se guarda el archivo. Una vez configuradas las cadenas de conexión accedemos a la pestaña Autenticación : Se debe verificar que Administración de funciones habilitada este Activo y que en Clase de proveedor de funciones este seleccionado AspNewSqlRoleProvider, es decir, tal y como está en la imagen anterior. Con esto tendremos configurado el IIS del sitio Web. 19
4.2.1 Como realizar cadena conexión Una opción para realizar las cadenas de conexión es mediante un archivo.udl. Para crear un archivo.udl se pulsa el botón derecho, se selecciona [Nuevo] fichero de texto. Se modifica el nombre y la extensión del fichero anterior como nombre.udl, después de aceptar el mensaje indicando que va a modificar la extensión se observará un icono como el que se muestra: Abrimos el archivo creado y accedemos a la pestaña [Proveedor]: Seleccionado Microsoft OLE DB Provider for SQL Server se pulsa [Siguiente>>] y se obtiene lo siguiente: 20
Lo primero será seleccionar el servidor de las bases de datos, una vez lo tenemos debemos indicar el usuario que accederá al SQL Server. Si se dispone de usuario se marcará Usar un nombre de usuario, se pondrá el nombre de usuario y contraseña y se marcara Permitir guardar contraseña. Por último se selecciona la Base de datos para la que se desea hacer la cadena de conexión. Si todo se ha realizado correctamente, al pulsar [Probar conexión] deberá salir lo siguiente: Una vez la conexión sea satisfactoria se pulsa [Aceptar]. Para obtener la cadena de conexión se pulsa con el boton derecho sobre el archivo.udl creado y se selecciona [Abrir con] Bloc de notas. Tendremos algo similar a esto: 21
La tercera línea contiene la cadena de conexión que será todo exceptuando la parte de Provider=SQLOLEDB.1; por tanto, seleccionaremos el resto de la cadena y ya tendremos una cadena de conexión. 4.3 PERMISOS DE ESCRITURA. Dentro de la estructura del sitio Web (c:\inetpub\wwwroot\progresa) se deberán dar permisos de escritura y modificación al directorio Documentos y a sus subdirectorios, ya que es el directorio donde se realiza el Upload de ficheros por parte de los técnicos, y por tanto se deberá permitir esta opción. 22