Configuración de una base de datos de SQL Server para Rational Engineering Lifecycle Manager

Configure una base de datos de SQL Server para trabajar con Jazz Team Server, Rational Engineering Lifecycle Manager y la aplicación Gestión de configuración.

Antes de empezar

Este procedimiento necesita que se cumplan los siguientes requisitos previos para SQL Server:

Nota: Si utiliza SQL Server en un idioma que no sea inglés, debe cambiar el idioma a inglés antes de crear el almacén de datos:
  1. En SQL Server Management Studio, pulse el botón derecho del ratón en la conexión al servidor de base de datos.
  2. En la ventana emergente, seleccione Propiedades.
  3. En la ventana Propiedades del servidor, seleccione Avanzadas y establezca la entrada Idioma predeterminado en Inglés.
  4. Guarde los cambios.

Procedimiento

  1. Cree una base de datos para cada instancia de Jazz Team Server, Rational Engineering Lifecycle Manager y la aplicación Gestión de configuración. Cree una base de datos para el almacén de datos asociado con Jazz Team Server. Por ejemplo, si tiene un Rational Engineering Lifecycle Manager, una aplicación Gestión de configuración, un Jazz Team Server y un almacén de datos, deberá crear cuatro bases de datos. Utilice el ejemplo siguiente para crear la base de datos de Jazz Team Server. Para crear las bases de datos de Rational Engineering Lifecycle Manager y de la aplicación Gestión de configuración, sustituya jts por el nombre de la base de datos, por ejemplo, relm y vvc:
    CREATE DATABASE jts 
    GO 
  2. Cree un usuario y contraseña para cada base de datos y cambie el propietario de cada base de datos.
    Ejecute estos mandatos:
    CREATE LOGIN jtsDBuser
    WITH PASSWORD = 'jtsDBpswd';
    USE jts;
    exec sp_changedbowner 'jtsDBuser'
    GO 
  3. Cambie el orden de las bases de datos de Jazz Team Server, Rational Engineering Lifecycle Manager y de la aplicación Gestión de configuración. En la herramienta de línea de mandatos, ejecute este mandato para Jazz Team Server. Para las bases de datos de Rational Engineering Lifecycle Manager y de la aplicación Gestión de configuración, sustituya jts por relm o vvc.
    ALTER DATABASE jts COLLATE SQL_Latin1_General_CP437_CS_AS 
    GO
  4. Cambie el sistema de versión de filas para las bases de datos de Jazz Team Server, Rational Engineering Lifecycle Manager y la aplicación Gestión de configuración. En la herramienta de línea de mandatos, ejecute este mandato para Jazz Team Server. Para las bases de datos de Rational Engineering Lifecycle Manager y de la aplicación Gestión de configuración, sustituya jts por relm o vvc.
    Nota: Asegúrese de que la conexión a la base de datos está abierta antes de ejecutar este mandato.
    ALTER DATABASE jts SET READ_COMMITTED_SNAPSHOT ON
    GO
  5. Cambie la intercalación de la base de datos del almacén de datos Desde la línea de mandatos, escriba:
    ALTER DATABASE dw COLLATE SQL_Latin1_General_CP1_CS_AS
    GO
  6. Cree una variable de entorno denominada SQLSERVER_JDBC_DRIVER_FILE y que apunte al controlador JDBC sqljdbc4.jar. La ubicación del controlador varía en función de la instalación.
    Windows
    1. Pulse en Inicio > Panel de control > Sistema.
    2. Pulse el separador Avanzado y, a continuación, pulse Variables de entorno.
    3. En la lista Variables del sistema, pulse Nueva.
    4. En Nombre de variable, especifique SQLSERVER_JDBC_DRIVER_FILE y en Valor de variable, especifique C:\Vía_acceso_a_controlador JDBC\sqljdbc4.jar.
    LinuxEn sistemas UNIX, añada la siguiente declaración de variable de entorno:
    SQLSERVER_JDBC_DRIVER_FILE =.:Vía_acceso_a_controlador_JDBC/sqljdbc4.jar
    Nota: Rational Engineering Lifecycle Manager no da soporte a JRE 5.0. Las versiones de JRE soportadas son 6.0 y 7.0.

    Si está utilizando WebSphere Application Server, también debe añadir una propiedad personalizada que apunte al controlador JDBD sqljdbc4.jar JDBC. Para obtener más información, consulte el apartado Configuración de WebSphere Application Server para Rational Engineering Lifecycle Manager.

  7. Para configurar las conexiones de bases de datos y crear tablas de base de datos, complete uno de los pasos siguientes:
    1. Si está utilizando Tomcat o si está desplegando WebSphere Application Server, inicie el servidor y continúe en Ejecución del asistente de configuración de Jazz Team Server para las aplicaciones de Rational Engineering Lifecycle Manager.
    2. Si prefiere modificar manualmente el archivo teamserver.properties para la conexión de base de datos, ejecute los mandatos repotools para crear tablas de base de datos. Si desea más información, consulte Configuración manual de una base de datos SQL Server.
    3. Si está actualizando desde una versión anterior, siga ejecutando los scripts de actualización adecuados, que migran las conexiones de base de datos existentes. Para obtener más información, lea sobre la actualización de Rational Engineering Lifecycle Manager.

Configuración manual de una base de datos SQL Server

La ejecución del asistente de configuración es el método recomendado para configurar las conexiones de base de datos y para crear las tablas de base de datos. Si prefiere realizar este procedimiento manualmente, edite el archivo teamserver.properties para configurar una conexión de base de datos de SQL Server y ejecute el mandato -createTables para crear tablas de base de datos.

Procedimiento

  1. Para cada aplicación, abra y modifique un teamserver.properties separado. Estos archivos se encuentran en sus correspondientes directorios (jts, relm y vvc) en el directorio <DirInstalaciónJazz>/server/conf. Abra cada archivo teamserver.properties y especifique los detalles de la base de datos y de la conexión.
    1. Comente las líneas siguientes en la configuración de Derby colocando un signo de número (#) delante de cada línea. El ejemplo es para el archivo teamserver.properties de JTS:
      #com.ibm.team.repository.db.vendor = DERBY
      # com.ibm.team.repository.db.jdbc.location=conf/jts/derby/repositoryDB
    2. Elimine el comentario de las siguientes líneas en la configuración de SQL Server eliminando (#) antes de cada línea:
      com.ibm.team.repository.db.vendor = SQLSERVER
      com.ibm.team.repository.db.jdbc.location=//localhost:1433;databaseName=jazz;user=jazzDBuser;password={password}
      com.ibm.team.repository.db.jdbc.password=jazzDBpswd
    3. Edite los siguientes valores en las propiedades com.ibm.team.repository.db.jdbc.location y com.ibm.team.datawarehouse.db.jdbc.location :
      • //hostlocal:1433: Escriba el nombre de host completo del servidor de base de datos.
        Nota: Debe configurar de forma manual el puerto estático en 1433 mediante la herramienta de configuración de SQL Server.
      • jazz: Escriba el nombre de base de datos.
      • jazzDBuser: Tipo de nombre de usuario
      Nota: No cambie el texto password={password} en las propiedades com.ibm.team.repository.db.jdbc.location y com.ibm.team.datawarehouse.db.jdbc.location.
    4. Especifique la contraseña de usuario en las propiedades com.ibm.team.repository.db.jdbc.password y com.ibm.team.datawarehouse.db.jdbc.password.
    5. Cambie el valor de la línea com.ibm.team.fulltext.indexLocation=conf/jts/indices/workitemindex a la ubicación de vía de acceso completa del índice de texto completo. Por ejemplo, entre com.ibm.team.fulltext.indexLocation=c:/Progra~1/IBM/JazzTeamServer/server/conf/jts/indices/workitemindex.
    6. Cambie el valor de la línea com.ibm.team.jfs.index.root.directory=indices a la ubicación de vía de acceso completa del directorio raíz de índice de Jazz Foundation Service. Por ejemplo, entre com.ibm.team.jfs.index.root.directory=c:/Progra~1/IBM/JazzTeamServer/server/conf/jts/indices.
  2. Después de crear cada base de datos, debe ejecutar un mandato repotools para crear tablas de base de datos.
    Importante: Ejecute el mandato createTables sólo si se trata de una instalación nueva.
    Nota: Cuando ejecuta el mandato repotools, el archivo teamserver.properties se actualiza y se guarda el archivo original con el contenido original en el mismo directorio. Es posible que vea un aviso que indica que el URI público no se ha establecido. Puede omitir este aviso ahora ya que el URI público se establece durante la ejecución del asistente de configuración de Jazz Team Server para las aplicaciones Rational Engineering Lifecycle Manager.
    1. Para crear las tablas de base de datos para Jazz Team Server, vaya al directorio JazzInstallDir/server y ejecute este mandato:
      repotools-jts -createTables 
    2. Para crear las tablas de base de datos para la aplicación de Rational Engineering Lifecycle Manager, vaya al directorio RELMInstallDir/server y ejecute este mandato:
      repotools-relm -createTables
    3. Para crear las tablas de base de datos para la aplicación Gestión de configuración, vaya al directorio VVCInstallDir/server y ejecute este mandato:
      repotools-vvc -createTables 

Resolución de problemas

Procedimiento

  • Si el mandato repotools no funciona, compruebe los archivos de registro correspondientes, que se encuentran en el directorio JazzInstallDir/server.
  • Compruebe que estas condiciones son correctas:
    • SQL Server está configurado para permitir conexiones que utilicen el protocolo TCP/IP. Si es necesario, reinicie el servicio SQL.
    • El nombre de host de la máquina de SQL Server y el puerto se reflejan de forma correcta en los archivos teamserver.properties.
    • El nombre de inicio de sesión, la contraseña y el nombre de la base de datos se reflejan de forma correcta en los archivos teamserver.properties.
    • No existe ningún cortafuegos que impida el acceso a SQL Server. Utilice un mandato Telnet para conectarse al servidor. Especifique el nombre y puerto del host desde el archivo teamserver.properties.
    • El usuario creado dispone de los permisos adecuados en la base de datos Jazz Team Server.
    • Las variables de entorno del controlador JDBC están configuradas de forma correcta para su entorno.
    Nota: Jazz Team Server se ejecuta en varias plataformas de base de datos; sin embargo, existen diferencias entre las bases de datos de empresa en la sintaxis, las estrategias de optimización y la semántica de bloqueo. El servidor se ha probado en SQL Server utilizando una combinación de pruebas automáticas y simulaciones de cargas de trabajo normales y pruebas de exceso de carga de trabajo. La simulación de cargas de trabajo normales ha mostrado un rendimiento aceptable. En algunos casos, se han producido puntos muertos en la base de datos en pruebas de simultaneidad automatizadas; sin embargo, estos errores no se han reproducido de forma sistemática en un hardware de servidor diferente.

    El servidor está diseñado para gestionar un gran número de solicitudes simultáneas. En casos excepcionales, se producen puntos muertos en la base de datos de repositorio, ya que se actualizan simultáneamente objetos similares o iguales en transacciones asociadas con las solicitudes. Estos errores son inusuales, pero son sucesos normales. El sistema está diseñado para defenderse de los puntos muertos y mantener la integridad de los datos; no se produce ninguna pérdida de datos. En ocasiones, las tareas, como la ejecución de motor de compilación, registran puntos muertos. Generalmente, se detecta la condición y la tarea se realiza de nuevo.

    Todos los puntos muertos encontrados se registran en el servidor para proporcionar información sobre qué ha sucedido al producirse el punto muerto. La entrada de registro incluye texto similar al siguiente: com.ibm.team.repository.common.RetryableDatabaseException: Serialization failure.

    Si el sistema detecta algún punto muerto, consulte el archivo de anotaciones, que se encuentra disponible en https://servername:9443/jts/service/com.ibm.team.repository.common.internal.IFeedService?category=SystemLog.

    Si se producen puntos muertos con frecuencia, póngase en contacto con el soporte del producto o compruebe los foros en jazz.net para obtener la información más reciente, actualizaciones o técnicas de mitigación.


Comentarios