Configurando SQL Server

Creación de la base de datos

Crear una base de datos y un usuario

Inicie SQL Server Management Studio Express y cree una base de datos llamada okmdb.

Seleccione el collation adecuado para la base de datos.

Configure su openkm.properties

Edite el fichero $TOMCAT_HOME/openkm.properties

spring.jpa.hibernate.ddl-auto=create-only
spring.jpa.properties.hibernate.dialect=com.openkm.db.dialect.SQLServerDialect

Configurar los orígenes de datos de Tomcat

Edite el fichero $TOMCAT_HOME/openkm.properties y habilite los recursos

spring.datasource.driver-class-name=com.microsoft.sqlserver.jdbc.SQLServerDriver
spring.datasource.url=jdbc:sqlserver://localhost:1433;databaseName=okmdb
spring.datasource.username=openkm
spring.datasource.password=*secret*
spring.datasource.validationQuery=SELECT 1

Edite el fichero $TOMCAT_HOME/openkm.xml

authentication.openkm.database=true

Ejecutar la aplicación

Durante el arranque de OpenKM, la aplicación creará automáticamente una estructura de base de datos vacía.

Configurar la seguridad integrada

Debe añadir el parámetro “integratedSecurity=true” a la URL de conexión JDBC para habilitar la seguridad integrada. Por ejemplo:

spring.datasource.driver-class-name=com.microsoft.sqlserver.jdbc.SQLServerDriver
spring.datasource.url=jdbc:sqlserver://localhost:1433;databaseName=okmdb;autoReconnect=true;integratedSecurity=true
spring.datasource.username=
spring.datasource.password=

También debe descargar el paquete del driver desde https://go.microsoft.com/fwlink/?linkid=2122434 y copiar el fichero sqljdbc_auth.dll a la carpeta TOMCAT_HOME/bin.

Más información en:

Microsoft SQL Server documentation

Resolución de problemas

No se puede conectar a SQL Server

Asegúrese de tener habilitado el protocolo TCP (está deshabilitado por defecto).

La conexión se pierde después de un tiempo.

Hemos observado en algunas ediciones de SQL Server lo que parece ser un comportamiento nuevo, por el cual, tras algunas horas, la conexión se cierra (podría ser un parámetro de configuración adicional en las últimas ediciones de SQL Server que está habilitado por defecto, o algo similar). Existe un nuevo atributo de configuración llamado autoReconnect que resuelve esto.

spring.datasource.driver-class-name=com.microsoft.sqlserver.jdbc.SQLServerDriver
spring.datasource.url=jdbc:sqlserver://localhost:1433;databaseName=okmdb;autoReconnect=true
spring.datasource.username=openkm
spring.datasource.password=*secret*
spring.datasource.validationQuery=SELECT 1

No es posible iniciar sesión en OpenKM

Cuando el primer inicio de sesión en OpenKM falla con el usuario y contraseña correctos (okmAdmin / admin), debería revisar la configuración de la base de datos.

Compruebe si la base de datos está configurada como case-sensitive; puede ser una de las razones por las que no puede iniciar sesión.

No es posible conectar vía TCP/IP a SQL local, puerto 1433, al usar una instancia en la URL de conexión JDBC

Si usa el nombre de instancia de la base de datos en la conexión, debe usar “\\” en el parámetro de configuración spring.datasource.URL. El siguiente ejemplo usa una instancia de base de datos llamada SampleSQL.

spring.datasource.url=jdbc:sqlserver://localhost\\SampleSQL;databaseName=okmdb;autoReconnect=true

Problemas de deadlock

Estos errores aparecen en el log de esta forma:

o.h.engine.JDBC.spi.SqlExceptionHelper : SQL Error: 1205, SQLState: 40001
o.h.engine.JDBC.spi.SqlExceptionHelper: Transaction (Process ID 56) was deadlocked on lock resources with another process and has been chosen as the deadlock victim. Rerun the transaction.

Modifique la base de datos para evitar estos problemas:

ALTER DATABASE okmdb SET READ_COMMITTED_SNAPSHOT ON WITH ROLLBACK IMMEDIATE

Fuente How to Solve Database Deadlock on Microsoft SQL Server.

Error de conexión SSL

Si ve este error:

The driver could not establish a secure connection to SQL Server by using Secure Sockets Layer (SSL) encryption.

El problema puede solucionarse añadiendo el parámetro “encrypt=false” a la URL JDBC:

spring.datasource.url=jdbc:sqlserver://sqlserver:1433;databaseName=okmdb;encrypt=false;

Esto se debe a un cambio en la última versión del driver JDBC Java de SQL Server.