Instalando pacotes MSI do MariaDB no Windows

Os pacotes MSI para o MariaDB estão disponíveis desde a versão 5.2.6. Os pacotes estão disponíveis para ambas as arquiteturas de processamento x86 (32 bits) e x64 (64 bits). Usaremos screenshots de uma instalação x64 abaixo (o instalador de 32 bits é bastante parecido).

Importante: Compatibilidade com instaladores NSIS para 5.2.5 ou anteriores.

If you install the MSI package for MariaDB 5.2 on a machine where 5.2.5 or earlier is installed, the MSI package will fail and tell you to uninstall the older 5.2 version. This behavior is by design. You can proceed by uninstalling 5.2.x without worries. Existing databases will not be removed.

Instalação IU (Interface de Usuário)

Esse é o modo de instalação mais comum. Para iniciar o instalador simplesmente clique no arquivo mariadb-<maior>.<menor>.<patch>.msi

Bem-vindo

Welcome dialog

Acordo de licença

License Agreement

Clique em "Eu aceito os termos"

Instalação Personalizada

Custom Setup

Aqui você pode escolher que características instalar. Por padrão , todas as características são instaladas com exceção dos símbolos de depuração. Se a característica "Instância do Banco" é selecionada, o instalador irá criar uma instância do banco de dados, por padrão correndo como um serviço. Neste caso, o instalador irá apresentar caixas de diálogo adicionais para controlar várias propriedades do banco de dados. Note que você não necessariamente tem que criar uma instância nesta fase. Por exemplo, se você já tiver bancos de dados MySQL ou MariaDB rodando como serviços, você pode simplesmente atualizá-los durante a instalação. Além disso você pode criar instâncias de bancos de dados adicionais após a instalação com o utilitário mysql_install_db.exe.

NOTA: Por padrão, se você instalar a instância do banco de dados, o diretório de dados estará na pasta "data" sob a instalação root. Para mudar o local do diretório de dados selecione "Instância do Banco" na árvore de características, e use o botão "Browse" para apontar para outro lugar.

Autenticação do Banco de Dados/propriedades relacionadas com a segurança

Database security properties

Este diálogo é mostrado se você selecionou a característica "Database instance". Aqui você pode definir a senha do usuário administrador do banco de dados e especificar se ele pode acessar ao banco desde máquinas remotas. A configuração "Criar conta anônima" habilita usuários anônimos (não-autenticados). Por padrão está desativada, e não é recomendável alterar esta configuração.

Outras propriedades do banco de dados

Other database properties

  • Instalar como serviço
  • Define se o banco de dados deveria rodar como um serviço e o nome do serviço. É recomendável executar a instância do banco como um serviço, já que isto simplifica de maneira importante o gerenciamento do banco de dados. O nome padrão do serviço é "MySQL", por razões de compatibilidade (este é o mesmo nome que o "mysqld.exe --install" escolheria).
  • Habilitar a rede
  • Se deve-se habilitar TCP/IP (recomendado) e em qual porta deveria escutar MariaDB. Se a segurança for uma preocupação, você pode alterar o parâmetro "bind-address" após a instalação para ligar a apenas endereços locais. Se a caixa "Habilitar a rede" estiver desmarcada, o banco de dados usará pipes nomeados para comunicação.
  • Otimizar para transações
  • Se esta caixa estiver marcada, o mecanismo de armazenamento padrão é definido como Innodb (ou XtraDB) e o parâmetro sql_mode é definido como "NO_ENGINE_SUBSTITUTION,STRICT_TRANS_TABLES". Você pode também definir o tamanho do buffer pool (área de cache) Innodb/Xtradb. O tamanho padrão do buffer pool é 12.5% da RAM e dependendo dos seus requerimentos você pode dar mais ao innodb (até 70-80% de RAM). Versões de 32 bit do MariaDB têm restricções no tamanho máximo do buffer pool, o qual é aproximadamente 1GB, devido a limitações do espaço de endereçamento virtual para processadores de 32bits. processes.

Pronto para instalar

Ready Dialog

Neste ponto, todas as configurações da instalação são coletadas. Clique no botão "Instalar".

O diálogo de Controle de Conta de Usuário

UAC popup

Se o controle de conta de usuário estiver habilitado (Vista ou posterior) Você verá este diálogo. Clique "Sim".

Fim

Finish

A instalação terminou. Se você tiver instâncias atualizáveis de MySQL/MariaDB, rodando como serviços este diálogo irá mostrar a caixa "Você quer atualizar as instâncias existentes?" Se for selecionada, será lançado o assistente de atualização pós-instalação.

Se você instalou a instância do banco como um serviço, o serviço já estará rodando.

Novas entradas no menu Iniciar

A instalação adicionará algumas entradas no menu Iniciar:

Start Menu

  • Cliente MySQL - Inicia a linha de comando cliente mysql.exe
  • Linha de comando - Inicia uma linha de comando. O ambiente é definido de tal forma que o diretório "bin" da instalação seja incluido na variável de ambiente PATH, p.e você pode usar esta linha de comando para emitir comandos do MariaDB (mysqldadmin, mysql etc...)
  • Diretório do banco de dados - Abre o diretório dos dados no explorer.
  • Log de erros - Abre o log de erros no Notepad.
  • my.ini - my.ini - Abre o arquivo de configuração do banco my.ini no Notepad
  • Assistente de configuração - Inicia o assistente para atualizar uma instância do banco existente para esta versão do MariaDB.

Interface de Usuário para Desinstalação

No applet do Explorer "Programas e características" (ou "Adicionar/Remover programas em Windows anteriores), encontre a entrada para o MariaDB, escolha Desinstalar/Alterar e clique no botão "Remover" no diálogo abaixo.

UninstallChangeDialog

Se você instalou uma instância do banco de dados, você terá de decidir se você quer remover ou deixar a data no diretório do banco.

KeepOrRemoveDataDialog

Instalação Silenciosa

O instalador MSI suporta também instalações silenciosas. Em sua forma mais simples a instalação silenciosa pode ser executada desde uma linha de comando com permissões elevadas da seguinte forma:

  msiexec /i <path-to-package.msi> /qn

Note: A instalação é silenciosa devido ao switch /qn (sem interface de usuário) do msiexe.exe, se você omitir esta opção, a instalação tera a interface de usuário toda.

Propriedades

Instalações silenciosas também suportam propriedades de instalação (uma propriedade corresponderia por exemplo a um estado marcado/desmarcado de uma caixa na interface de usuário, senha do usuário, etc). Com propriedades, a linha de comando para instalar o pacote MSI ficaria assim:

msiexec /i <path-to-package.msi> [PROPERTY_1=VALUE_1 ... PROPERTY_N=VALUE_N] /qn

O pacote instalador MSI requer que os nomes das propriedades estejam em maiúsculas contendo só letras em inglês. Por convenção, para uma propriedade booleana, um valor vazio significa "falso" e um não-vazio "verdadeiro".

A instalação do MariaDB suporta as seguintes propriedades:

Nome da propriedadeValor PadrãoDescrição
INSTALLDIR%ProgramFiles%\MariaDB <version>\Instalação root
PORT3306Parâmetro --port para o servidor
ALLOWREMOTEACCESSPermite acesso remoto para o usuário root
BUFFERPOOLSIZERAM/8Tamanho do Bufferpool para o innodb
CLEANUPDATA1Remove o diretório de dados (somente desinstalação)
DATADIRINSTALLDIR\dataLocal do diretório de dados
DEFAULTUSERPermite usuários anônimos
PASSWORDSenha do usuário root
SERVICENAMENome do serviço do Windows. Não será criado um serviço se este valor estiver vazio
SKIPNETWORKINGIgnorar a rede
STDCONFIG1Corresponde a "optimizar para transações" na GUI, mecanismo padrão innodb, modo estrito sql

Features (Características)

Feature é um termo do instalador do Windows para uma unidade de instalação. Características podem ser selecionadas e deselecionadas na interface de usuário, na árvore de características no diálogo da "Instalação Personalizada".

A instalação silenciosa suporta a adição de características com a propriedade especial ADDLOCAL=Feature_1,..,Feature_N e remover características com REMOVE=Feature_1,..., Feature_N

Features no instalador do MariaDB:

Id do FeatureInstalada por padrão?Descrição
DBInstanceSimInstalar instância do banco
ClientSimPrograma cliente com linha de comando
MYSQLSERVERSimInstalar servidor
DebugBinariesSimInstalar mysqld-debug, e versões de depuração das livrarias clientes
SharedLibrariesSimInstalar livraria cliente compartilhada
DEVELSimInstalar arquivos-cabeçalhos de C/C++ e livrarias cliente
EmbeddedNãoLivraria do servidor embutida
DEBUGSYMBOLSNãoInstalar símbolos de depuração

Exemplos de instalação silenciosa

Todos os exemplos aqui requerem ser executados como administrador (uma linha de comando com permissões elevadas em Vista e posterior)

  • Instalar as características padrão, a instância do banco como serviço, diretório de dados e porta (não-padrões)
    msiexec /i <path-to-package.msi> SERVICENAME=MySQL DATADIR=C:\mariadb5.2\data PORT=3307 /qn
  • Instalar o serviço, adicionar símbolos de depuração, não adicionar componentes para desenvolvimento (livrarias clientes e headers)
    msiexec /i <path-to-package.msi> SERVICENAME=MySQL ADDLOCAL=DEBUGSYMBOLS REMOVE=DEVEL /qn

Desinstalação silenciosa

Para desinstalar silenciosamente, use a propriedade REMOVE=ALL com msiexec:

msiexec /i <path-to-package.exe> REMOVE=ALL /qn

Para manter a data no diretório durante a desinstalação, você precisará de passar um parâmetro adicional:

msiexec /i <path-to-package.exe> REMOVE=ALL CLEANUPDATA="" /qn

Logs de Instalação

Se você encontrar um bug no instalador, o log do instalador deveria ser usado para diagnóstico. Por favor anexe os logs ao reporte de bugs que você crie. Para criar um log do instaldor, inicie o instalador desde uma linha de comando com o switch /l da seguinte forma:

  msiexec.exe /i <path-to-package.msi>  /l <path-to-logfile.txt>

Rodando distribuições de 32 e 64 bits na mesma máquina.

É possível instalar pacotes para 32 e 64 bits no mesmo Windows x64.

Além de testar, um exemplo onde essa característica pode ser útil é num cenário de desenvolvimento, onde os usuários queiram rodar o servidor de 64 bits e desenvolver os componentes de ambos clientes tanto de 32 e 64 bits. Neste caso o pacote completo de 64 bits pode ser instalado, incluindo características adicionais da instância do banco de dados relacionadas a desenvolvimento, vindas do pacote de 32 bits.

Comments

Comments loading...