name : HOWTO.INSTALL.pt ÍNDICE Introdução I. Construir e instalar o módulo do kernel II. Perguntas frequentes: P: Como executar o ficheiro de instalação .i686 ou .x86_64? P: O ficheiro de instalação .i686 é compatível com a minha arquitetura x86_64? P: Posso instalar o produto num sistema IA64? P: O programa de configuração não consegue localizar os ficheiros de origem do kernel no diretório /lib/modules/<MY_KERNEL>/build ou /lib/modules/<MY_KERNEL>/source. O que devo fazer? INTRODUÇÃO Em alguns casos, o programa de configuração não consegue compilar os módulos do kernel necessários ou preparar o ambiente de execução necessário para o produto. Geralmente, o programa de configuração informa-o acerca deste problema e refere-lhe este ficheiro. A secção I deste ficheiro descreve como construir e instalar o módulo kernel. Pode ser necessário ler essa secção se tiver um kernel personalizado ou uma localização não padrão dos ficheiros de origem do kernel. I. CONSTRUIR E INSTALAR O MÓDULO DO KERNEL Pode instalar o produto nas seguintes distribuições Linux com o kernel de 2.4.20 a 4.4 e glibc 2.3.2 ou superior: (a) Red Hat Enterprise Linux 4.x, 5.x, 6.x, 7.0, 7.1, e 7.2 (b) Ubuntu 9.10, 10.04, 10.10, 11.04, 11.10, 12.04, 12.10, 13.04, 13.10, 14.04, 14.10, 15.04 e 15.10 (c) Fedora 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22 e 23 (d) SUSE Linux Enterprise Server 10 e 11 SUSE Linux Enterprise Server 12 – suportado em sistemas de ficheiros, exceto para Btrfs (e) Debian 4, 5, 6, 7.0, 7.2, 7.4, 7.5, 7.6, 7.7, 8.0, 8.1, 8.2 e 8.3 (f) CentOS 5.x, 6.x, 7 e 7.1 (g) Oracle Linux 5.x, 6.x, 7.0, 7.1 e 7.2 – tanto Unbreakable Enterprise Kernel como Red Hat Compatible Kernel (h) CloudLinux 6.x (i) ClearOS 5.x, 6.x, 7 e 7.1 Em qualquer uma destas distribuições, geralmente, o programa de configuração compila automaticamente o módulo do kernel necessário para o produto funcionar. Se o programa de configuração não conseguir compilar o módulo do kernel, é necessário fazer isto manualmente da seguinte forma. É necessário instalar os ficheiros de origem do kernel, o ficheiro de configuração adequado e todos os pacotes necessários para construir o kernel. Estes pacotes incluem "gcc", "make" e "kernel-devel". São-lhe solicitados os pacotes necessários quando instalar os ficheiros de origem do kernel. Geralmente, pode construir e instalar o módulo do kernel "snapapi" através da execução dos comandos "dkms" da seguinte forma: módulos # dkms build -m <MODULE_NAME> -v <MODULE_VERSION> \ --config <CONFIG_FILE> --arch <KERNEL_ARCH> \ --kernelsourcedir <PATH_TO_KERNEL_SOURCES> # dkms install -m <MODULE_NAME> -v <MODULE_VERSION> \ --config <CONFIG_FILE> --arch <KERNEL_ARCH> \ --kernelsourcedir <PATH_TO_KERNEL_SOURCES> Nestes comandos: <MODULE_NAME> tem de ser um dos seguintes: (a) Para os kernels 2.4.x: snapapi (b) Para os kernels 2.6.x e 3.x: snapapi26 <MODULE_VERSION> é a versão do módulo "snapapi". Pode determiná-la através da execução do seguinte comando: # ls /usr/src | grep snapapi Por exemplo, se o nome do diretório é snapapi26-0.7.64, o valor do <MODULE_VERSION> é: 0.7.64 <CONFIG_FILE> é o nome do ficheiro de configuração do kernel . Este ficheiro está geralmente no diretório /boot. Especifique o nome completo do ficheiro, por exemplo: /boot/config-2.6.31-14-generic <KERNEL_ARCH> é o tipo de arquitetura do kernel, por exemplo: i686. Pode detetar o valor para <KERNEL_ARCH> através da execução dos seguintes comandos: (a) Para distribuições baseadas em RPM, como Red Hat Enterprise Linux, CentOS ou Fedora: # rpm -q --queryformat "%{ARCH}\n" kernel (b) Para distribuições não baseadas em RPM, como Ubuntu: # uname -m Para mais informações sobre como utilizar o utilitário dkms, consulte a página dkms man. Após a construção e a instalação bem-sucedidas do módulo do kernel, pode executar o produto para verificar a respetiva funcionalidade. Os módulos do kernel adequados são carregados automaticamente. II. Perguntas frequentes P: Como executar o ficheiro de instalação .i686 ou .x86_64? R: Este é um ficheiro binário padrão. Para iniciar a instalação, execute os seguintes comandos: # chmod +x <FILE_NAME> # ./<FILE_NAME> Aqui, <FILE_NAME> é o nome do ficheiro de instalação .i686 ou .x86_64 .x86_64. O programa de configuração utiliza o RPM Package Manager (RPM). Antes da instalação do produto num sistema sem o RPM, como um sistema Ubuntu, é necessário instalar o RPM; por exemplo, através da execução do seguinte comando como o utilizador raiz: #apt-get install -y rpm P: O ficheiro de instalação .i686 é compatível com a minha arquitetura x86_64? R: Não, tem de transferir e instalar o ficheiro de instalação .x86_64 correspondente em vez do ficheiro de instalação . O procedimento de instalação é igual. P: Posso instalar o produto num sistema IA64? R: Não, esta arquitetura não é suportada pelo produto. P: O programa de configuração não consegue localizar os ficheiros de origem do kernel no diretório /lib/modules/<MY_KERNEL>/build ou /lib/modules/<MY_KERNEL>/source. O que devo fazer? R: Isto geralmente significa que é necessário instalar os ficheiros de origem do kernel correspondentes à sua versão do kernel. Os comandos seguintes instalam os ficheiros de origem do kernel no Debian e no Ubuntu: $ sudo apt-get update $ sudo apt-get install linux-headers-`uname -r` $ sudo apt-get install linux-image-`uname -r` O comando seguinte instala os ficheiros de origem do kernel no Red Hat Enterprise Linux e no Fedora: # yum install kernel-devel-`uname -r`