MySQL

Nesta seção estão os passos necessários para a instalação do banco de dados do LumisXP no Servidor MySQL:

Abra o MySQL Query Browser, crie um novo database e execute o script db_mysql.sql.
No arquivo lumisdata/config/lumishibernate.cfg.xml altere as informações de conexão com o banco de dados.
 <property name="dialect">org.hibernate.dialect.MySQL5InnoDBDialect</property> <property name="connection.driver_class">com.mysql.cj.jdbc.Driver</property> <property name="connection.username">DB_USERNAME</property> <property name="connection.password">DB_PASSWORD</property> <property name="connection.url">jdbc:mysql://HOST_NAME/DATABASENAME?characterEncoding=UTF-8&useSSL=false&allowPublicKeyRetrieval=true&useConfigs=maxPerformance&prepStmtCacheSize=500&prepStmtCacheSqlLimit=2048</property> <property name="connection.isolation">2</property>

Uma outra alternativa de conexão com o banco de dados, é a configuração do datasource no servidor de aplicação.
Execute o arquivo /setup/initializeportal.cmd, para o Windows®, ou initializeportal.sh, para o Linux. Este script executa uma aplicação Java que abre uma conexão com o banco de dados, utilizando as informações do arquivo lumisdata/config/lumishibernate.cfg.xml. Este script também insere os dados iniciais necessários para o funcionamento do LumisXP.

Observações

O driver MySQL Connector Java não está incluído na distribuição do LumisXP, ele pode ser encontrado no link abaixo:

http://dev.mysql.com/downloads/connector/j/

Verificar se a versão do conector do MySQL utilizado, corresponde ao especificado no arquivo setup/setclasspath.cmd ou setup/setclasspath.sh. Caso contrário, alterar a versão do conector no arquivo setclasspath.

Existe uma limitação quando utilizado o MySQL que a data não pode ser inferior a 01/01/1753. Quando isso ocorre, é retornado uma mensagem de erro informando que a data é inválida.
A configuração max_allowed_packet do MySQL que limita o tamanho máximo do pacote recebido pelo servidor deve ser configurada com um valor igual ou superior a 128M, valores muito baixos podem causar problema em cenários de cluster. Para contornar tal limitação, recomenta-se configurar a variável do servidor max_allowed_packet , conforme no exemplo abaixo:
[mysqld] max_allowed_packet=128M

Onde 128M é o tamanho máximo do pacote. O padrão do servidor é 1M. O valor deve ser ajustado de acordo com a necessidade da aplicação.
A configuração SQL Mode deve conter STRICT_TRANS_TABLES. Ele já faz parte do valor padrão desta configuração a partir da versão 5.7.5 do MySQL.

Dependendo da versão do driver JDBC e das configurações do sistema operacional, em alguns casos o driver não consegue reconhecer o timezone do sistema e pode dar um erro como a mensagem abaixo ao tentar inicializar as conexões com o banco de dados:

The server time zone value 'XXXX' is unrecognized or represents more than one time zone. You must configure either the server or JDBC driver (via the serverTimezone configuration property) to use a more specifc time zone value if you want to utilize time zone support.

Neste caso pode ser necessário acrescentar ao valor de connection.url a propriedade serverTimezone para explicitar o fuso a ser utilizado pelo driver. Para maiores informações sobre as propriedades do conector JDBC MySQL, consulte seu manual.