Manual de Instalación - ri.ufg.edu.svri.ufg.edu.sv/jspui/bitstream/11592/7081/8/651.8-C348s-Manual...

J

Manual de Instalación Sistema automatizado en línea para el control de recepción y distribución de donaciones e inventario para Aldeas Infantiles SOS.

Aldeas Infantiles SOS El Salvador

CONTENIDO.

1. Introducción. J2 2. Software requerido para la instalación. J2 3. Instalación de la base de datos. J2

3.1. Instalación de SQL Server 2000. J2 3.2. Ejecución del script de la base de datos. J8

4. Instalación de Java Development Kit. J14 5. Instalación de Jakarta Tomcat. J16 6. Creación de la conexión ODBC. J20 7. Instalación del sistema. J24 8. Ejecutar el sistema. J24

Sistema automatizado en línea para Aldeas Infantiles SOS

Manual de Instalación

J2

1. Introducción. La presente guía de instalación tiene por objetivo la instalación del prototipo del sistema, en una computadora que funcionará como el servidor de la aplicación con un sistema operativo Windows 2003 Server. Se indica paso a paso la instalación del software requerido para el funcionamiento del software. 2. Software requerido para la instalación.

• Base de datos: SQL Server 2000. • Servidor Web: Yakarta Tomcat.

3. Instalación de la base de datos.

3.1. Instalación de SQL Server 2000. Ingrese a [Unidad de CD]:\x86\setup Ejecute el archivo setupsql.exe



J3

Por defecto se muestra el nombre de la computadora local en donde se creará la nueva instancia de SQL Server.

Seleccione la opción Crear una nueva instancia de SQL Server.



J4

Ingrese un nombre de referencia para la base de datos.

A continuación se muestran los términos del contrato de la licencia. Clic en si para aceptar los términos.



J5

Seleccione el tipo de instalación: Herramientas de Servidor y Cliente.

Seleccione una instalación por defecto.



J6

Seleccione el tipo de instalación típica.

Configure las cuentas. Seleccione “Usar la cuenta local del sistema”.



J7

Seleccione el modo de autenticación de Windows.

Finalmente se muestra una pantalla que dará inicio a la ejecución de la instalación de la base de datos.



J8

3.2. Ejecución del script de la base de datos. Ingrese al Enterprise Manager y de clic en Microsoft SQL Server.

Clic en SQL Server Group.



J9

Clic derecho en (LOCAL) (Windows NT), y seleccione Connect.

Esto inicia el servicio de la base de datos.



J10

Clic en Databases.

Clic en el botón que se muestra en la figura, para adicionar una nueva base de datos.



J11

Cree la base de datos. 1. El nombre de la base de datos es: BD_ALDEAS 2. Clic en OK.

A continuación se muestra la base de datos ya creada. Clic en BD_ALDEAS, para establecerla como la base de datos actual.



J12

Abra el SQL Query Analizer, que es la aplicación en donde se correrá el Script.

Una vez en el SQL Query Analizer, abra el script, el cual se encuentra en la ruta: SOFALDEAS\SCRIPT-BD\bd_sofaldeas.sql Para ello, de clic en el botón Abrir.

Luego busque el archivo, selecciónelo y de clic en Abrir.



J13

A continuación se muestra todo el contenido del script. Para ejecutarlo, de

clic en el botón que se muestra en la figura.

Otra forma para ejecutar el script: en el menú Query, seleccione la opción Execute.



J14

4. Instalación de Java Development Kit. De doble clic en el icono de instalación (que se encuentra en el CD):

Se muestra el contrato de licencia, a continuación. Seleccione la opción I Accept … y de clic en Next.

En la pantalla de personalizar la instalación, no realizar cambios. Clic Next.



J15

A continuación comienza la instalación y se muestra la pantalla siguiente.

Seleccione los navegadores que se registraran con Java. Se muestra el listado de los que están actualmente instalados.

Finalmente, aparece la pantalla de la instalación completa. Clic en Finish.



J16

5. Instalación de Jakarta Tomcat. De doble clic en el icono de instalación y se mostrará la pantalla de bienvenida.

A continuación se muestra el contrato de licencia, clic en I Agree.



J17

Seleccione el tipo de instalación completa.

Ingrese la ruta para la instalación como se muestra. En español: C:\Archivos de Programa\Apache Software Foundation\Tomcat 5.0



J18

A continuación ingrese las opciones de configuración.

Seleccione la ruta de la Java Virtual Machine, clic en Install.



J19

Al finalizar la instalación se muestra la ventana siguiente.

Para probar que Apache Tomcat este funcionando correctamente ingrese en el navegador: http://localhost:8080 Si se muestra la pantalla siguiente, la instalación ha sido un éxito.



J20

6. Creación de la conexión ODBC.

o Para crear una conexión a la base de datos haga clic en Inicio> Configuración >Panel de Control>Herramientas Administrativas>Orígenes de Datos (ODBC)

o Se desplegará una ventana como la siguiente:

o De Clic en el botón Agregar… o Se mostrará una ventana con una lista de controladores de ODBC,

seleccione el controlador para SQL Server y de clic en el botón Finalizar.



J21

o La siguiente ventana permitirá establecer el Nombre del origen de datos: conexion_aldeas Si la base correrá de forma local se coloca el servidor (local) o el nombre del servidor, sino la dirección IP del recurso a conectarse.

Luego se establece la seguridad o autenticidad de inicio. Seleccione la primera opción que es usar la autenticidad de Windows.



J22

En esta pantalla, debe especificar datos de alias de servidor y otras configuraciones para cliente.

A continuación, establezca la base de datos a emplear: BD_ALDEAS. Y de clic en Siguiente.



J23

En esta pantalla, no se realiza ningún cambio. De clic en Finalizar.

Cuando aparezca esta pantalla, puede probar la conexión (dando clic en Probar origen de datos…) o puede terminar el procedimiento dando clic en Aceptar. Y luego en Aceptar nuevamente.



J24

7. Instalación del sistema.

• Copie el directorio SOFALDEAS del CD en la ruta siguiente: C:\Arhivos de Programa\Apache Software Foundation\Tomcat 5.0\webapps\

• Copie el archivo SOFALDEAS\JAR\SOFALDEAS.jar (Dentro del CD), en el directorio:

C:\Archivos de Programa\Apache Software Foundation\Tomcat 5.0\common\lib NOTA: Si el instalador del JDK es diferente al jdk-6u1-windows-i586-p que esta dentro del CD de instalación, podría presentarse un error, que requerirá copiar el archivo tools.jar desde la ubicación [Unidad raíz]:\Archivos de Programa\Java\jdk1.6.0_01\lib hacia la siguiente ruta: [Unidad raíz]:\Archivos de Programa\Apache Software Foundation\Tomcat 5.0\common\lib 8. Ejecución del sistema. Para ejecutar el sistema, ingrese al navegador y escriba en la barra de direcciones: http://<IP DEL SERVIDOR>:8080/SOFALDEAS/PUBLICAS/frmLogin.jsp Ejemplos: Si la IP del servidor es: 192.168.1.100 http://192.168.1.100:8080/SOFTALDEAS/PUBLICAS/frmLogin.jsp Y se cargará el menú principal de la aplicación. La primera vez puede entrar como USUARIO: ADMIN CONTRASEÑA: ADMIN Se recomienda cambiar la contraseña después del primer ingreso.

K

Manual del programador Sistema automatizado en línea para el control de recepción y distribución de donaciones e inventario para Aldeas Infantiles SOS.

Aldeas Infantiles SOS El Salvador

Parte I: Introducción al desarrollo del sistema.

1. Requisitos para el diseño y la programación. K1 2. Plataforma de desarrollo. K1

Parte II: Estándares utilizados.

1. Estándares de diseño de interfaces. K2 2. Estándares de programación. K4

Parte III: Estructura del proyecto.

1. Estructura del sitio Web. K9 2. Estructura del proyecto Java. K10 3. Estructura de la base de datos. K11

CONTENIDO

Este manual ha sido elaborado para que sea utilizado por programadores que en el futuro se les encomiende realizar modificaciones al sistema, para el crecimiento y mantenimiento del mismo. Se describe los requisitos necesarios para programar en este proyecto, los estándares que se han utilizado para que haya una mejor comprensión del código y una fácil adaptación a él. También se explica la estructura del proyecto, que se divide en dos: el proyecto Web y el proyecto de clases Java. Es necesario también, para que el programador pueda realizar cambios, que conozca la estructura de la base de datos, la cual es parte primordial en un proyecto de sistema de información. El diseño físico y la estructura de tablas, serán herramientas fundamentales para el trabajo del analista programador. Se recomienda leer el manual técnico para ver detalles del proyecto sobre el análisis y el desarrollo del mismo.

BIENVENIDO

L1

K1

1. REQUISITOS PARA EL DISEÑO Y LA PROGRAMACIÓN. Para el desarrollo del proyecto y para realizar cualquier modificación al mismo, es necesario contar con el software siguiente: Herramienta. Utilización. Dreamweaver. En versión de macromedia Studio o de Adobe.

Para el diseño de la interfaz gráfica.

JDK (Java Development Kit). Versión 1.6 o superior.

Conjunto de herramientas que permiten compilar y ejecutar código Java.

Tomcat WebServer. Versión 5 o superior.

Servidor para la administración de aplicaciones Web. Funciona como contenedor de Java Server Pages.

Eclipse Lomboz. Creación y compilación de paquetes y clases Java.

Navegador Web. Se recomienda Internet Explorer 7.

Para pruebas del sistema.

SQL Server 2000. Base de datos.

2. PLATAFORMA DE DESARROLLO. Esta versión ha sido desarrollada con: Eclipse Lomboz 3.2 Macromedia DreamWeaver MX 2004 Tomcat WebServer 5.0 JDK 1.6 SQL Server 2000

PARTE I. INTRODUCCIÓN AL DESARROLLO DEL SISTEMA

L2

K2

1. ESTÁNDARES DEL DISEÑO DE INTERFACES. Se ha utilizado una plantilla para las interfaces, que contiene un encabezado con el nombre y logo de la institución, un pie con los datos de contacto de la institución, un área para el título o nombre de la pantalla y un área donde se mostrará el formulario de entrada o salida de información. Los colores deberán ser estándar en todas las pantallas, para no dar sensación al usuario que está trabajando en diferentes sistemas. Además es importante que la localización de los controles sea constante de pantalla en pantalla. Pantalla de muestra:

NOTA: Los campos obligatorios deben siempre marcarse con un asterisco rojo.

PARTE II. ESTÁNDARES UTILIZADOS

K3

A continuación se muestra el estándar recomendado para la utilización de controles:

REPRESENTACIÓN DESCRIPCIÓN

Campos para el ingreso fecha.

Cajas de texto.

Etiqueta para mostrar información.

Botones de acción.

Botones de opción.

Listas de selección.

Casillas de verificación (check box).

Botón para retornar al menú principal.

Presente en todas las pantallas

excepto en búsquedas rápidas y

reportes.

Botón para búsquedas rápidas.

Botón para creación rápida de

registros.

Botón para eliminación de ítems.

Botón para editar registros.

Botón para enviar valores desde la

búsqueda rápida al form. De llamada.

Botón para ver detalles de una

consulta.

K4

2. ESTÁNDARES DE PROGRAMACIÓN. Nombres de controles y objetos. Para nombrar los controles y objetos se ha utilizado la notación siguiente: prefijo + nombre del control (relacionado al campo que representan). Los prefijos utilizados se muestran en la tabla siguiente:

Prefijo. Control. frm Formulario o pantalla en DreamWeaver. txt Cajas de texto. lbl Etiquetas. opt Botones de opción. cmb Listas de selección, desplegables. cmd Botones de acción. rpt Páginas web en su versión imprimible.

Ejemplos:

• frmAjuste. Formulario de ajustes de inventario. • txtFecha. Caja de texto en donde se ingresará la fecha de la transacción. • optBodega. Grupo de botones de opción, que determinan si el producto pasó

por bodega o no. Nombres de variables. A todas las variables de tipo String, Int o Double utilizadas; se les ha llamado con el prefijo “var_“ seguido del nombre de variable (que debe estar acorde a los valores que representa). En caso de variables que representan instancias de clases u otros objetos, se les ha llamado simplemente por el nombre de variable. Ejemplos:

• var_codigo_d. Variable que contiene el código del donante. • var_nombre_zo. Variable que contiene el nombre de la zona. • donante. Variable que contiene una instancia de la clase cDonante. • listadouser. Variable que contiene un LinkedList de la clase cDonante.

Nombres de clases. No se utiliza prefijo alguno, sin embargo la inicial del nombre debe estar en mayúsculas. Ejemplo: “Producto” es la clase producto.

K5

Estructura del código de Java Server Pages. En las Java Server Pages se tiene estructura siguiente:

• Código JSP para importar los paquetes que serán utilizados en la página Web actual.

• Código HTML, que se encuentra a lo largo de todo el documento. • Código JavaScript el cual es utilizado para escribir funciones o procedimientos

que no retornan ningún valor, o para hacer las validaciones de información en el lado del cliente.

K6

Estructura del código de clases Java.

• Al principio del código se importan todos los paquetes que se utilizarán. • Se declaran todas las variables privadas. • Luego se escriben las funciones y procedimientos. • Al final se escriben los Getters y Setters.

K7

Diagrama de clases. Donaciones monetarias.

K8

Control de alcancías.

Donaciones en especies.

L1

:

1. ESTRUCTURA DEL SITIO WEB.

A continuación se muestra la estructura del sitio SOFALDEAS:

• En la carpteta IMÁGENES, se guardan todas las imágenes o íconos utilizados en los formularios.

• JS. Contiene todos los archivos con extensión .js los cuales son códigos de JavaScript.

• PRIVADAS. En esta carpeta se guardan todas las páginas JSP que existen en el proyecto, estas se han estructurado así: CONSULTAS (JSP de consultas de información), MANTENIMIENTOS (JSP de catálogos), OPCIONES (JSP de los extras u opciones del sistema), PROCESOS (procesos o transacciones disponibles), QUICK (búsquedas rápidas), QUICK_CREATE (formularios para registros rápidos de los catálogos, REPORTES (Versiones imprimibles de las consultas). Para acceder a cualquiera de estas páginas, se debe tener un usuario y contraseña asignados.

• PUBLICAS. Páginas que se pueden acceder sin necesidad de estar logeados.

PARTE III. ESTRUCTURA DEL PROYECTO

K2

2. ESTRUCTURA DEL PROYECTO JAVA.

El nombre del proyecto es SOS, este contiene varios paquetes.

• El paquete sv, contiene las clases correspondientes a El Salvador, en este caso contiene la clase Departamento.

• sv.org.aldeassos. Aquí se almacenan las clases que serán utilizadas en todo el proyecto, como varios.java, Conexion.java.

• sv.org.aldeassos.donaciones. Almacena las clases relacionadas con el módulo de donaciones.

• sv.org.aldeassos.ninos. Almacena las clases relacionadas con el módulo de información de niños.

K3

3. ESTRUCTURA DE LA BASE DE DATOS.

Base de datos. Nombre: BD_ALDEAS. En la base de datos se crearon 39 tablas, 1 procedimiento almacenado y 1 plan de mantenimiento. Los nombres de las tablas y los campos se han designado de acuerdo a la normalización de bases de datos.

K4

Modelo físico de la base de datos. A continuación se muestra el modelo físico de la base de datos relacional.

Estructura de tablas. Vea la estructura de tablas en el documento capítulo IV, sección 4.1.3.

K5

Procedimiento almacenado para inactivar donantes (“inactivar”). Su función es ejecutar un código que determina cuáles donantes se vuelven inactivos.

Este procedimiento de cambiar el estado a inactivos, se hace comparando la última donación que ha realizado cada donante con un parámetro: tiempo en meses que puede pasar sin realizar una donación antes de ponerse inactivo. Este campo, está en la tabla parámetro, y se puede modificar desde la opción del sistema: “Configuración de parámetros”. En el diseño de la tabla PARAMETRO:

Este procedimiento almacenado se ha configurado para que sea ejecutado cada vez que se inicia el SQL Server Agent. Sin embargo esto puede ser modificado, si cambian los requerimientos. Pasos para configurar la ejecución del procedimiento almacenado:

1. Ingrese a la opción Jobs del SQL Server Agent.

K6

2. Clic derecho sobre Jobs, y seleccione New Job… se mostrará una ventana para la configuración de propiedades del Job.

3. Ingrese el nombre.

4. Seleccione la viñeta Steps, de clic en New… y se mostrará la pantalla de edición del Job Step; especifique la base de datos con la que se trabajará: BD_ALDEAS y escriba el comando para ejecutar el procedimiento almacenado: EXEC inactivar. Para modificar el Paso existente, de doble clic sobre el correspondiente y se mostrará la pantalla de edición del Job Step.

5. Para especificar el tiempo en que se ejecutará el Job, seleccione la viñeta Schedules, de clic en New… y se mostrará la pantalla de Job Schedule; ingrese el nombre del Schedule, seleccione el tipo, clic en OK. Para modificar el Schedule existente, de doble clic sobre el correspondiente y se mostrará la pantalla de edición del Job Schedule.

K7

NOTA: Puede seleccionar entre los tipos de Schedule:

• Comenzar automáticamente cuando arranque el SQL Server Agent. • Comenzar cuando el CPU esté desocupado. • Una vez, se especifica el horario de ejecución: fecha y hora. • Repetidas veces, se especifica los días y horario de ejecución.

Luego en la lista de Jobs existentes se mostrará Verificar_Inactivos.

Planes de mantenimiento de la base de datos. El plan de mantenimiento creado consta de las siguientes acciones:

1. Se configuró las opciones de optimización de información al actualizar. Esto es necesario para organizar e indexar la data para mejorar el rendimiento al consultar o modificar. A la vez se habilitó un horario para ejecutar esas acciones: cada lunes a las 6:00 a.m.

K8

2. Se configuró una revisión de la integridad de la base de datos, con el objetivo

de detectar posibles inconsistencias que fueron causadas por errores del Hardware.

3. Los respaldos automáticos de la base de datos, se configuraron para ser realizados diariamente, en el mismo disco duro. Será responsabilidad del administrador del sistema realizar los respaldos en medios externos: CD o DVD.

L1

:

KNOWLEDGE BASE. (BASE DE CONOCIMIENTOS).

Esta base de conocimientos ha sido desarrollada como una guía de consejos para

los desarrolladores que se dispongan a programar en el lenguaje Java con un

enfoque similar al utilizado en este proyecto.

DOCUMENTACIÓN DE ERRORES.

• Invalid Descriptor Index.

Causa: Se da cuando los valores que se están mostrando del resultset, están

en diferente orden que en el Query ejecutado.

Solución: colocar los valores a mostrar en el mismo orden que se utiliza en el

query.

• C:\Archivos de programa\Apache Software Foundation\Tomcat

5.0\work\Catalina\localhost\SOFALDEAS\org\apache\jsp\SOFALDEAS\PRIVA

DAS\MANTENIMIENTOS\frmDonante_005famigo_jsp.java:430: incompatible

types

found : java.lang.String

required: int

Causa:Tipos de datos diferentes. Se envía un string a una variable de tipo int.

Solución: Al asignar el valor a la variable, convertirla primeramente así:

Integer.parseInt(variable)

L2

• Incomparable types: java.lang.String and int.

Causa: en una condición se están comparando valores con diferentes tipos de

datos.

Solución: Igualar tipos de datos.

• getDisponibilidad(int) in sv.org.aldeassos.donaciones.Alcancia cannot be

applied to ()

Causa: no se han especificado los parámetros para el método.

Solución: enviar los parámetros apropiados.

• java.lang.IndexOutOfBoundsException: Index: 1, Size: 1

Causa: Hay campos vacíos.

Solución: valide campos nulos o vacíos.

• int cannot be dereferenced

Causa: comparación de datos de distintos tipos.

Solución: convertir al mismo tipo de datos.

• java.lang.NumberFormatException: For input string: ""

Causa: Campo vacío el cual se ocupa para obtener algún código.

Solución: Verificar que la caja de texto se esté llenando con el código

correspondiente, además verificar los nombres de los controles en el js.

• Al hacer un cálculo siempre retorna 0 (cero).

Causa: los operandos tienen diferentes tipos de datos, pueden ser double, int.

Solución: Utilizar los operadores de conversión entre tipos de datos. O

declarar las variables con el mismo tipo.

L3

• [Microsoft][ODBC SQL Server Driver][Shared Memory]No existe el servidor

SQL Server o se ha denegado el acceso al mismo.

Causa: La conexión al servidor no está bien configurada. Es posible que el

SQL Server esté apagado.

Solución: Verifique que el SQL Server esté encendido. Si el error continúa

verifique la conexión ODBC.

• javax.servlet.ServletException:

sv.org.aldeassos.donaciones.Donante.getInicio_d()Ljava/util/Date;

Causa: No se ha encontrado la clase para el control de fechas.

Solución: Declare oportunamente las clases que se utilizarán.

• C:\Archivos de programa\Apache Software Foundation\Tomcat

5.0\work\Catalina\localhost\SOFALDEAS\org\apache\jsp\SOFALDEAS\PRIVA

DAS\CONSULTAS\frmcon_005fdonantes_005fproximos_jsp.java:271: 'catch'

without 'try'

} catch (Throwable t) {

Causa: falta una llave, por lo tanto algún bloque ha quedado abierto.

Solución: verifique cuidadosamente el código de la pantalla correspondiente,

para que todos los bloques estén entre las llaves correspondientes.

• [Microsoft][ODBC SQL Server Driver][SQL Server]The column prefix 'zo' does

not match with a table name or alias name used in the query.

Causa: se está utilizando un alias que no existe.

Solución: verifique el correcto alias que será utilizado y cámbielo en el query.

L4

TIPS PARA SQL SERVER 2000

• Crear Store Procedures. En el query analizer:

o Escribir el código para crear el procedimiento.

o F5

• Ejecutar el Store Procedure.

o Se crea un job, en el enterprise manager (Job Scheduling)

o Tipo de comando: Transact – SQL Command

o Seleccionar la base de datos.

o Escribir: EXEC nombreprocedimiento para ejecutar el procedimiento

almacenado.

o Definir el horario para ejecutar el procedimiento.

TIPS DE TRANSACT SQL

Fetch: devuelve una fila determinada del cursor.

@@cursor_rows: numero de filas en un cursor.

NOTAS: El servicio SQLServer Agent debe estar iniciado, para que se ejecuten las tareas de

los jobs.

Manual de Instalación - ri.ufg.edu.svri.ufg.edu.sv/jspui/bitstream/11592/7081/8/651.8-C348s-Manual...

Documents

Transcript of Manual de Instalación - ri.ufg.edu.svri.ufg.edu.sv/jspui/bitstream/11592/7081/8/651.8-C348s-Manual...