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.
Contents
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
Acordo de licença
Clique em "Eu aceito os termos"
Instalação Personalizada
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
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
- 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
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
Se o controle de conta de usuário estiver habilitado (Vista ou posterior) Você verá este diálogo. Clique "Sim".
Fim
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:
- 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.
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.
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 propriedade | Valor Padrão | Descrição |
|---|---|---|
| INSTALLDIR | %ProgramFiles%\MariaDB <version>\ | Instalação root |
| PORT | 3306 | Parâmetro --port para o servidor |
| ALLOWREMOTEACCESS | Permite acesso remoto para o usuário root | |
| BUFFERPOOLSIZE | RAM/8 | Tamanho do Bufferpool para o innodb |
| CLEANUPDATA | 1 | Remove o diretório de dados (somente desinstalação) |
| DATADIR | INSTALLDIR\data | Local do diretório de dados |
| DEFAULTUSER | Permite usuários anônimos | |
| PASSWORD | Senha do usuário root | |
| SERVICENAME | Nome do serviço do Windows. Não será criado um serviço se este valor estiver vazio | |
| SKIPNETWORKING | Ignorar a rede | |
| STDCONFIG | 1 | Corresponde 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 Feature | Instalada por padrão? | Descrição |
|---|---|---|
| DBInstance | Sim | Instalar instância do banco |
| Client | Sim | Programa cliente com linha de comando |
| MYSQLSERVER | Sim | Instalar servidor |
| DebugBinaries | Sim | Instalar mysqld-debug, e versões de depuração das livrarias clientes |
| SharedLibraries | Sim | Instalar livraria cliente compartilhada |
| DEVEL | Sim | Instalar arquivos-cabeçalhos de C/C++ e livrarias cliente |
| Embedded | Não | Livraria do servidor embutida |
| DEBUGSYMBOLS | Não | Instalar 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.
