Configurar una base de datos SQL Server para que funcione con Jazz Team Server.
Este procedimiento asume que se cumplen los requisitos previos siguientes:
- Se ha instalado SQL Server
- Se ha iniciado el servicio de SQL Server
- Los controladores JDBC de SQL Server están instalados.
Para obtener más información consulte http://msdn2.microsoft.com/en-us/data/aa937724.aspx
- El protocolo TCP está habilitado para SQL Server
- El usuario que cree la tabla de base de datos debe tener uno de los
permisos siguientes:
- Una pertenencia al rol del servidor fijo sysadmin, o propiedad de la base de datos (dbo)
Recuerde: El nombre de inicio de sesión predeterminado definido en el archivo JazzInstallDir/server/teamserver.properties para una base de datos de SQL Server es jazzDBuser y la contraseña predeterminada es jazzDBpswd. Estos valores se utilizan en los siguientes pasos para crear una base de datos. Puede sustituir estos valores con el nombre de usuario y contraseña para su base de datos.
Configuración de una base de datos
Esta sección describe cómo configurar la base de datos SQL Server utilizando la herramienta de línea de mandatos sqlcmd,
que se proporciona con la instalación de SQL Server. También puede utilizar una herramienta visual, como SQL Server Studio Management, también disponible para la versión
Express como SQL Server Studio Management
Express. Consulte la documentación de SQL Server o a un administrador de base de datos SQL Server (DBA) para obtener más información.
Para configurar una base de datos SQL
Server utilizando la herramienta de mandatos sqlcmd:
- Cree una base de datos Jazz Team Server.
En la herramienta de línea de mandatos, escriba:
CREATE DATABASE jazz
GO
- Cree un usuario y contraseña y cambie el propietario de la base de datos Jazz Team Server.
En la herramienta de línea de mandatos, escriba:
CREATE LOGIN jazzDBuser
WITH PASSWORD = 'jazzDBpswd';
USE jazz;
exec sp_changedbowner 'jazzDBuser'
GO
- Cambie la intercalación de la base de datos Jazz Team Server.
En la herramienta de línea de mandatos, escriba:
ALTER DATABASE jazz COLLATE SQL_Latin1_General_CP437_CS_AS
GO
Configuración del servidor
Recuerde: De manera predeterminada, el archivo teamserver.properties en el directorio JazzInstallDir/server no está configurado para conectarse a una base de datos SQL Server. Todos los valores, junto con los valores específicos de SQL Server, se encuentran en el archivo teamserver.sqlserver.properties
en el mismo directorio.
Para configurar el servidor:
- Renombre
los siguientes archivos:
- Renombre el archivo JazzInstallDir/server/conf/jazz/teamserver.properties a teamserver.OtherDBProvider.properties
- Renombre el archivo teamserver.sqlserver.properties
a teamserver.properties
Consejo: El renombrar
el archivo teamserver.properties original
le permite restaurar el archivo a la última versión funcional. De forma predeterminada, el Proveedor de base de datos es derby.
- Edite el archivo de configuración del servidor si ha utilizado un nombre de usuario, contraseña o nombre de base de datos distintos, si ha instalado SQL Server en una máquina distinta que Jazz Team Server,
o si utiliza un puerto distinto al predeterminado. Abra el archivo teamserver.properties en el directorio JazzInstallDir/server/conf/jazz
y cambie la información enumerada a continuación para que coincida con su configuración.
com.ibm.team.repository.db.vendor = SQLSERVER
com.ibm.team.repository.db.jdbc.location=//SQL SERVER MACHINE IP:SQL SERVER TCIP PORT;databaseName=JAZZ DATABASE NAME;user=JAZZ USERNAME;password={password}
com.ibm.team.repository.db.jdbc.password=JAZZ LOGIN PASSWORD
Importante: No cambie el texto password={password}
en la propiedad com.ibm.team.repository.db.jdbc.location.
La contraseña de usuario debe especificarse en la propiedad com.ibm.team.repository.db.jdbc.password.
Importante: Sólo para Windows. Asegúrese de que la seguridad del servidor
está en modalidad mixta. Puede verificarlo seleccionando la seguridad del servidor. Debe estar establecida en "Modalidad de autenticación de Windows y SQL Server".
Para especificar la ubicación del archivo jar para JDBC:
- En
el mismo directorio que los scripts del servidor (JazzInstallDir/server),
cree un directorio denominado sqlserver.
- Ubique el archivo JAR del controlador JDBC de SQL Server,
denominado sqljdbc.jar.
La ubicación puede variar en función de dónde se instalaran los controladores, como se resaltó en la sección de requisitos previos. Copie el archivo al directorio recién creado sqlserver.
- Especifique la ubicación del archivo JAR de JDBC para JDBC completando la siguiente tarea:
- Configure la variable de entorno SQLSERVER_ABSPATH para apuntar al directorio que contiene el archivo JAR. Si la vía de acceso contiene caracteres de espacio, debe incluirlos con comillas.
Consejo: Si
utiliza WebSphere Application Server, configure
una propiedad denominada SQLSERVER_JDBC; a continuación, configúrela hacia
la vía de acceso del directorio absoluta (no URL) que contenga los controladores JDBC de SQL Server, por ejemplo, si su sqljdbc.jar está
ubicado en JazzInstallDir/server/sqlserver.
Para obtener más información, consulte las instrucciones de configuración de WebSphere Application Server.
Anote la vía de acceso al archivo para su uso posterior en estas instrucciones.
Resolución de problemas
Si el mandato repotools no es correcto, compruebe el archivo de registro llamado repotools_createTables.log,
ubicado en el directorio JazzInstallDir/server.
Además, verifique lo siguiente:
- SQL Server está configurado para permitir conexiones utilizando el protocolo TCP/IP. Si es necesario, reinicie el servicio SQL.
- El nombre de host de la máquina SQL Server y el puerto se refleja correctamente en el archivo teamserver.properties.
- El nombre de inicio de sesión, contraseña y nombre de base de datos se reflejan correctamente en el archivo teamserver.properties.
- El cortafuegos no le impide acceder a SQL Server.
Utilice un mandato telnet para conectarse a la máquina utilizando un nombre de host y puerto desde el archivo teamserver.properties.
- El usuario creado tiene los permisos correctos en la base de datos de Jazz Team Server.
Nota: El código de la base de datos para
Jazz Team Server fue diseñado para ser genérico y estándar a fin de que pueda ser ejecutado en varias plataformas de base de datos; no obstante, existen diferencias de sintaxis, estrategias de optimización y semántica de bloqueo entre los proveedores de bases de datos empresariales. El servidor fue probado en SQL Server utilizando una combinación de pruebas automáticas y simulaciones de cargas de trabajo normales y pruebas de carga. La simulación de cargas de trabajo normales demostró un rendimiento aceptable. En algunas instancias se observaron puntos muertos de base de datos en pruebas de simultaneidad automáticas; sin embargo, éstas no se reprodujeron de forma regular en los distintos hardware de servidor.
El servidor está diseñado para prestar servicio a un gran número de solicitudes simultáneas. En casos excepcionales, los puntos muertos pueden producirse en la base de datos de repositorio, mientras que objetos similares o iguales se actualizan a la vez en transacciones asociadas con las solicitudes. Son sucesos inusuales, pero normales. El sistema está diseñado para defenderse contra esto y mantener la integridad de los datos; no hay pérdida de datos.
Ocasionalmente, los puntos muertos son registrados por tareas, como la ejecución del motor de compilación. Por lo general, se detecta la condición y se reintenta la tarea.
El punto muerto puede producir una compilación fallada. En casos muy inusuales, puede tratarse de una acción de usuario, como trabajar con elementos de trabajo o código fuente, que se aborta para resolver un punto muerto. En ese caso, la acción de usuario falla y se muestra al usuario un error con detalles acerca de un punto muerto. El usuario entonces puede reintentar la acción.
Todos los puntos muertos encontrados se registran en el servidor para proporcionar información acerca de lo que sucedió cuando se produjo el punto muerto. La entrada de registro incluye texto similar al siguiente: com.ibm.team.repository.common.RetryableDatabaseException:
Serialization failure.
Si su sistema encuentra puntos muertos, consulte el registro del error, disponible en: https://servername:9443/jazz/service/com.ibm.team.repository.common.internal.IFeedService?category=SystemLog.
Si encuentra excepciones de punto muerto frecuentes, póngase en contacto con el soporte del producto o compruebe los foros en jazz.net para obtener la última información, actualizaciones o técnicas de mitigación.