Referência da sintaxe do Kickstart

Este apêndice descreve comandos e opções disponíveis em instalações Kickstart. Para informações gerais sobre o Kickstart, veja Automatizando a instalação com o Kickstart.

Table of Contents

Não há garantia de que os nomes dos dispositivos sejam consistentes nas reinicializações, o que pode complicar o uso dos scripts do Kickstart. Quando uma opção do Kickstart chama um nome de nó de dispositivo (como sda), você pode usar qualquer item de /dev/disk. Por exemplo, em vez de:

part / --fstype=xfs --onpart=sda1

Você pode usar uma entrada semelhante a uma das seguintes:

part / --fstype=xfs --onpart=/dev/disk/by-path/pci-0000:00:05.0-scsi-0:0:0:0-part1
part / --fstype=xfs --onpart=/dev/disk/by-id/ata-ST3160815AS_6RA0C882-part1

Isso fornece uma maneira consistente de se referir a discos que é mais significativo do que apenas sda. Isso é especialmente útil em grandes ambientes de armazenamento.

Embora os princípios gerais das instalações do Kickstart tendam a permanecer os mesmos, os comandos e opções podem mudar entre as versões principais. Você pode usar o comando ksverdiff para exibir as diferenças entre as duas versões da sintaxe do Kickstart. Isso é útil ao atualizar um arquivo Kickstart existente para ser usado com uma nova versão. Para exibir uma lista de alterações na sintaxe entre o Fedora 30 e 31, use o seguinte comando:

$ ksverdiff -f F30 -t F31

A opção -f especifica a versão com a qual iniciar a comparação, e a opção -t para especificar a versão com a qual terminar. Para obter informações adicionais, consulte a página man ksverdiff(1). Observe também que você não pode usar isso para exibir alterações em uma versão mais recente que o seu sistema - a versão do pykickstart no Fedora 30 não pode exibir alterações no Fedora 31 .

Além disso, você pode revisar as Notas de Lançamento do Fedora {PRODVER }, disponíveis no https://docs.fedoraproject.org/, para obter uma lista de mudanças.

Nas seções a seguir, se uma opção for seguida por uma marca de igual (=), um valor deve ser especificado depois dela. Nos comandos de exemplo, as opções entre colchetes ([]) são argumentos opcionais para o comando.

Métodos e fontes de instalação

Os comandos a seguir controlam a maneira como o Fedora será instalado.

device (opcional) - Instala drivers de dispositivos extras

Na maioria dos sistemas PCI, o programa de instalação detecta automaticamente as placas Ethernet e SCSI. No entanto, em sistemas mais antigos e alguns sistemas PCI, o Kickstart requer uma dica para encontrar os dispositivos adequados. O comando device, que informa ao programa de instalação para instalar módulos extras, usa o seguinte formato:

device nomeMódulo [--opts=]

Substitua nomeMódulo pelo nome do módulo do kernel que deve ser instalado.

--opts=

Opções para passar para o módulo de kernel instalado. Por exemplo:

device i2c_piix4 --opts="aic152x=0x340 io=11"

driverdisk (opcional) - Usa um disco de driver

Os discos de driver podem ser usados durante as instalações do Kickstart para fornecer drivers adicionais não incluídos por padrão. Você deve copiar o conteúdo dos discos de driver para o diretório raiz de uma partição no disco rígido do sistema. Em seguida, você deve usar o comando driverdisk para especificar que o programa de instalação deve procurar um disco de driver e sua localização.

driverdisk partição | --source= | --biospart=
partição

Procura a imagem do disco de driver em uma partição local. Substitua partição pelo nome da partição que contém o disco de driver. Observe que a partição deve ser especificada como um caminho completo. Por exemplo:

driverdisk /dev/sdb1
--source=

Procura o disco de driver em um local de rede em vez de uma partição local. Por exemplo:

driverdisk --source=ftp://caminho/para/dd.img
driverdisk --source=http://caminho/para/dd.img
driverdisk --source=nfs:nome-do-host:/caminho/para/dd.img
--biospart=

Partição BIOS contendo o disco de driver (por exemplo, 82p2).

install (obrigatório) - Configura o método de instalação

O modo de instalação padrão. Você deve especificar o tipo de instalação a partir de cdrom, harddrive, nfs, liveimg ou url. O comando install e o comando do método de instalação devem estar em linhas separadas. Por exemplo:

install
liveimg --url=file:///images/install/squashfs.img --noverifyssl

Os comandos do método de instalação são:

cdrom

Instala a partir da primeira unidade de disco óptico (DVD) no sistema.

harddrive

Instala a partir de uma árvore ou de imagem ISO de instalação completa no disco rígido local. A árvore ou imagem ISO deve estar num sistema de arquivos que seja montável no ambiente de instalação. Arquivos de sistema suportados são ext2, ext3, ext4, vfat ou xfs.

install
harddrive --partition= | --biospart= [--dir=]
--partition=

Partição para instalar a partir de (tal como sdb2).

--biospart=

Partição BIOS para instalar a partir de (tal como 82p2).

--dir=

Diretório contendo a árvore de instalação ou imagem ISO.

liveimg

Instala a partir de uma imagem de disco ao invés de pacotes. A imagem pode ser o arquivo squashfs.img de uma imagem ISO live, ou qualquer sistema de arquivos que a mídia de instalação possa montar. Arquivos de sistema suportados são ext2, ext3, ext4, vfat e xfs.

Este comando também tem suporte à instalação de arquivos tar do sistema de arquivos raiz. Nesse caso, o nome do arquivo deve terminar com .tar, .tbz, .tgz, .txz, .tar.bz2, tar.gz ou tar.xz.

install
liveimg --url= [--proxy= | --checksum= | --noverifyssl=]
--url=

O local a partir do qual instalar. Os protocolos suportados são HTTP, HTTPS, FTP e file.

--proxy=

Especifica um proxy HTTP, HTTPS ou FTP para usar durante a instalação.

--checksum=

Um argumento opcional com a soma de verificação SHA256 do arquivo de imagem, usado para verificação de integridade. Se você estiver usando uma imagem live fornecida pelo Projeto Fedora, você pode encontrar uma lista de somas de verificação no https://getfedora.org/security.

--noverifyssl

Desabilita a verificação SSL ao conectar-se a um servidor HTTPS.

nfs

Instale a partir de um servidor NFS especificado. O servidor NFS deve estar exportando a imagem ISO de instalação completa (como o DVD do Fedora Server) ou seu conteúdo extraído.

install
nfs --server= [--dir=] [--opts= ]
--server=

Nome do host do servidor.

--dir=

Diretório contendo a árvore de instalação ou imagem ISO.

--opts=

Opções de montagem para usar para montar a exportação NFS.

url

Instala a partir de uma árvore em um servidor remoto por HTTP, HTTPS ou FTP.

install
url --url= | --mirrorlist= [--proxy= | --noverifyssl]
--url=

O local a partir do qual instalar. Os protocolos suportados são http, https, ftp e file.

--mirrorlist=

A URL do espelho a partir da qual instalar.

--proxy=

Especifica um proxy HTTP, HTTPS ou FTP para usar durante a instalação.

--noverifyssl

Desabilita a verificação SSL ao conectar-se a um servidor HTTPS.

mediacheck (opcional) - Verifica a integridade da mídia de instalação

Este comando forçará o programa de instalação a executar uma verificação de mídia antes de iniciar a instalação, de forma semelhante à rd.live.check opção de inicialização (consulte Verificando a mídia de inicialização. Este comando requer que as instalações sejam atendidas, por isso está desabilitado por padrão.

ostreesetup (opcional) - Instala de uma OSTree

Usado para instalações OSTree. Veja https://wiki.gnome.org/action/show/Projects/OSTree para mais informações sobre OSTree. As opções disponíveis são:

--osname=

Raiz de gerenciamento para a instalação do sistema operacional (obrigatório).

--remote=

Raiz de gerenciamento para a instalação do sistema operacional (opcional).

--url=

URL do repositório (obrigatório).

--ref=

Nome do branch dentro do repositório (obrigatório).

--nogpg

Desabilita a verificação de chave GPG (opcional).

repo (opcional) - Configura repositórios adicionais

Configura repositórios adicionais do [application] DNF que podem ser usados como fontes para a instalação do pacote. Este comando pode ser usado várias vezes em um único arquivo Kickstart.

Veja o Fedora System Administrator’s Guide (guia de administrador de sistema), disponível em https://docs.fedoraproject.org/, para informações sobre o gerenciador de pacotes DNF.

Os repositórios usados para instalação devem ser estáveis. A instalação pode falhar se um repositório for modificado antes da conclusão da instalação.

--name=

O ID do repositório. Esta opção é obrigatória. Se um repositório tiver um nome que conflite com outro repositório adicionado anteriormente, ele será ignorado. Como o programa de instalação usa uma lista de repositórios pré-configurados, isso significa que você não pode adicionar repositórios com os mesmos nomes dos pré-configurados.

--baseurl=

O URL do repositório. As variáveis que podem ser usadas nos arquivos de configuração de repositório do DNF não são suportadas. Você pode usar uma destas opções ou --mirrorlist, não ambas.

--mirrorlist=

A URL apontando para uma lista de espelhos para o repositório. As variáveis que normalmente podem ser usadas nos arquivos de configuração do repositório dnf não são suportadas aqui. Você pode usar uma das opções ou --baseurl, não ambas.

--install

Disponibiliza o repositório configurado no arquivo Kickstart no sistema após a instalação. Cria um arquivo de configuração para o repositório em /etc/yum.repos.d/ no sistema instalado.

--cost=

Um valor inteiro para atribuir um custo a este repositório. Se vários repositórios fornecerem os mesmos pacotes, este número será usado para priorizar qual repositório será usado antes do outro. Repositórios com custo mais baixo têm prioridade sobre repositórios com custo mais alto.

--excludepkgs=

Uma lista separada por vírgulas de nomes de pacotes que não devem ser extraídos deste repositório. Isso é útil se vários repositórios fornecem o mesmo pacote e você deseja ter certeza de que ele vem de um repositório específico. Ambos os nomes de pacotes completos (como publican) e globs (como`gnome-*`) são aceitos.

--includepkgs=

Uma lista separada por vírgulas de nomes de pacotes e globs que devem ser extraídos deste repositório. Isso é útil se vários repositórios fornecerem o mesmo pacote e você quiser ter certeza de que ele vem desse repositório.

--proxy=

Especifica um servidor proxy HTTP, HTTPS ou FTP para usar ao acessar este repositório. Esta configuração não afeta nenhum outro repositório ou fonte de instalação.

--ignoregroups=true

Esta opção é usada ao compor árvores de instalação e não tem efeito no próprio processo de instalação. Diz às ferramentas de composição para não olharem para as informações do grupo de pacotes ao espelhar árvores, para evitar espelhar grandes quantidades de dados desnecessários.

--noverifyssl

Desabilita a verificação SSL ao conectar-se a um servidor HTTPS.

url (opcional) - Instala a partir de uma árvore de instalação em um servidor remoto via FTP ou HTTP.

Instala a partir de uma árvore de instalação em um servidor remoto via FTP ou HTTP.

--proxy=

Especifica um proxy HTTP/HTTPS/FTP para usar durante a instalação. As várias partes do argumento agem como você esperaria. A sintaxe é:

[protocolo://][usuário[:senha]@]host[:porta]
--noverifyssl

Para uma árvore em um servidor HTTPS, não verifica o certificado do servidor com o que uma AC conhecida validou e não verifique se o nome do host do servidor corresponde ao nome de domínio do certificado.

--url=

A URL a partir da qual instalar. A substituição da variável é feita para $releasever e $basearch na URL.

--mirrorlist=

A URL do espelho a partir da qual instalar. A substituição da variável é feita para $releasever e $basearch na URL.

--metalink=

A URL do metalink a partir da qual instalar. A substituição da variável é feita para $releasever e $basearch na URL.

Armazenamento e particionalmente

Os comandos nesta seção são usados para determinar as opções de armazenamento e particionamento do seu sistema.

autopart (opcional) - Particionamento automático

Cria partições automaticamente: uma partição raiz (/) (1 GB ou maior), uma partição swap e uma partição /boot apropriada para a arquitetura. Em unidades grandes o suficiente (50 GB e maiores), isso também cria uma partição /home.

A opção autopart não pode ser usada junto com as opções part/partition, raid, logvol ou volgroup no mesmo arquivo Kickstart .

--type=

Seleciona um dos esquemas de particionamento automático predefinidos que você deseja usar. Aceita os seguintes valores:

  • lvm: O esquema de particionamento LVM.

  • btrfs: O esquema de particionamento Btrfs.

  • plain: Particionamentos regulares sem LVM ou Btrfs.

  • thinp: O esquema de particionamento de provisionamento LVM fino.

    O esquema de particionamento criado seguirá o esquema recomendado descrito em Esquema de particionamento recomendado.

--fstype=

Especifica um sistema de arquivos compatível (como ext4 ou xfs) para substituir o padrão ao fazer o particionamento automático.

--nolvm

Não usa LVM ou Btrfs para particionamento automático. Esta opção é igual a --type=plain.

--encrypted

Criptografa todas as partições. Isso é equivalente a marcar a caixa de seleção Criptografar partições na tela de particionamento inicial durante uma instalação gráfica manual.

--passphrase=

Fornece uma senha padrão para o sistema para todos os dispositivos criptografados.

--escrowcert=URL_do_certificado_X.509

Armazena chaves de criptografia de dados de todos os volumes criptografados como arquivos em /root, criptografados usando o certificado X.509 da URL especificada com URL_do_certificado_X.509. As chaves são armazenadas como um arquivo separado para cada volume criptografado. Esta opção só é significativa se --encrypted for especificada.

--backuppassphrase

Adiciona uma senha gerada aleatoriamente para cada volume criptografado. Armazena essas senhas em arquivos separados em /root, criptografados usando o certificado X.509 especificado com --escrowcert. Esta opção só é significativa se --escrowcert for especificado.

--cipher=

Especifica qual tipo de criptografia será usado se aes-xts-plain64, padrão do Anaconda, não for satisfatório. Você deve usar esta opção junto com a opção --encrypted; por si só não tem efeito. Os tipos de criptografia disponíveis estão listados no Fedora Security Guide (guia de segurança), disponível no https://docs.fedoraproject.org/. Usar aes-xts-plain64 ou aes-cbc-essiv: sha256 é fortemente recomendado.

--luks-version=

Especifica qual versão do LUKS deve ser usada para criptografar o sistema. Relevante apenas se --encrypted também for especificada.

--pbkdf=

Define o algoritmo da Função de Derivação de Chave Baseada em Senha (PBKDF) para o slot de chave LUKS. Relevante apenas se --encrypted também for especificado. Consulte a página man cryptsetup(8) para obter mais informações.

pbkdf-memory=

Define o custo de memória para PBKDF. Relevante apenas se --encrypted também for especificada. Consulte a página man cryptsetup(8) para obter mais informações.

pbkdf-time=

Define o número de milissegundos a ser gasto com o processamento da senha PBKDF. Relevante apenas se --encrypted também for especificado. Veja informações sobre a opção --iter-time na página man cryptsetup(8) para mais informações.

Apenas uma de --pbkdf-time= ou --pbkdf-iterations= pode ser especificada ao mesmo tempo.

pbkdf-iterations=

Define o número de iterações para o processamento da senha diretamente e evita a avaliação de desempenho de PBKDF. Relevante apenas se --encrypted também for especificado. Veja informações sobre a opção --pbkdf-force-iterations na página do manual cryptsetup(8) para mais informações.

Apenas uma de --pbkdf-time= ou --pbkdf-iterations= pode ser especificada ao mesmo tempo.

bootloader (obrigatório) - Configura o carregador de inicialização

Especifica como o carregador de inicialização deve ser instalado.

Você deve sempre usar uma senha para proteger seu carregador de inicialização. Um carregador de inicialização desprotegido pode permitir que um invasor em potencial modifique as opções de inicialização do sistema e obtenha acesso não autorizado ao sistema.

Alguns sistemas requerem uma partição especial para instalar o carregador de inicialização. O tipo e tamanho desta partição depende se o disco no qual você está instalando o carregador de incialização usa o Master Boot Record (MBR) ou um esquema de Tabela de Partição GUID (GPT). Para obter mais informações, consulte Instalação do carregador de inicialização.

--append=

Especifica parâmetros de kernel adicionais. Para especificar vários parâmetros, separe-os com espaços. Por exemplo:

bootloader --location=mbr --append="hdd=ide-scsi ide=nodma"

Os parâmetros rhgb e quiet são sempre usados, mesmo se você não os especificar aqui ou não usar o comando --append=.

--boot-drive=

Especifica em qual unidade o carregador de inicialização deve ser gravado e, portanto, de qual unidade o computador será inicializado. Se você usar um dispositivo multipath como unidade de inicialização, especifique apenas um membro do dispositivo.

A opção --boot-drive= está atualmente sendo ignorada em instalações do Fedora em sistemas IBM System z usando o carregador de inicialização zipl. Quando zipl está instalado, ele determina a unidade de inicialização por sua própria conta.

Não especificar esta opção resultará no seguinte comportamento:

  1. Se a opção --driveorder= foi usada, Anaconda instalará o carregador de inicialização no primeiro dispositivo válido especificado na ordem do drive.

  2. O primeiro disco presente e válido contendo uma partição /boot será usado.

  3. Se nenhuma das opções acima se aplicar, o primeiro dispositivo de armazenamento válido da lista de todos os dispositivos detectados será usado para instalar o carregador de inicialização.

--leavebootorder

Evita que o programa de instalação faça alterações na lista existente de imagens inicializáveis em sistemas UEFI ou ISeries/PSeries.

--driveorder=

Especifica qual unidade é a primeira na ordem de inicialização do BIOS. Por exemplo:

bootloader --driveorder=sda,hda
--location=

Especifica onde o registro de inicialização é gravado. Os valores válidos são os seguintes:

  • mbr - A opção padrão. Depende se a unidade usa o esquema Master Boot Record (MBR) ou Tabela de Partição GUID (GPT):

    • Em um disco formatado por GPT, esta opção instalará o estágio 1.5 do carregador de inicialização na partição de inicialização do BIOS.

    • Em um disco formatado por MBR, o estágio 1.5 será instalado no espaço vazio entre o MBR e a primeira partição.

  • partition - Instala o carregador de inicialização no primeiro setor da partição que contém o kernel.

  • none - Não instala o carregador de inicialização.

    Na maioria dos casos, essa opção não precisa ser especificada.

--password=

Se estiver usando GRUB2 como o carregador de inicialização, defina a senha do carregador de inicialização para aquela especificada com esta opção. Isso deve ser usado para restringir o acesso ao shell do GRUB2, onde opções arbitrárias do kernel podem ser passadas.

Se uma senha for especificada, o GRUB2 também solicitará um nome de usuário. O nome do usuário é sempre root.

--iscrypted

Normalmente, quando você especifica uma senha do carregador de inicialização usando a opção --password=, ela será armazenada no arquivo Kickstart em texto simples. Se você deseja criptografar a senha, use esta opção e uma senha criptografada.

Para gerar uma senha criptografada, use o comando grub2-mkpasswd-pbkdf2, insira a senha que deseja usar e copie a saída do comando (o hash começando com grub.pbkdf2) no arquivo Kickstart. Um exemplo de entrada Kickstart de bootloader com uma senha criptografada será semelhante ao seguinte:

bootloader --iscrypted --password=grub.pbkdf2.sha512.10000.5520C6C9832F3AC3D149AC0B24BE69E2D4FB0DBEEDBD29CA1D30A044DE2645C4C7A291E585D4DC43F8A4D82479F8B95CA4BA4381F8550510B75E8E0BB2938990.C688B6F0EF935701FF9BD1A8EC7FE5BD2333799C98F28420C5CC8F1A2A233DE22C83705BB614EA17F3FDFDF4AC2161CEA3384E56EB38A2E39102F5334C47405E
--timeout=

Especifica a quantidade de tempo que o carregador de inicialização aguardará antes de inicializar a opção padrão (em segundos).

--default=

Define a imagem de inicialização padrão na configuração do carregador de inicialização.

--extlinux

Usa o carregador de inicialização extlinux em vez do GRUB2. Esta opção funciona apenas em sistemas suportados pelo extlinux.

--disabled

Não tenta instalar um carregador de inicialização. Esta opção substitui todas as outras configurações do carregador de inicialização; todas as outras opções do carregador de inicialização serão ignoradas e nenhum pacote do carregador de inicialização será instalado.

--nombr

Instala a configuração do carregador de inicialização e os arquivos de suporte, mas não modifica o MBR.

btrfs (opcional) - Cria volume ou subvolume Btrfs

Cria um volume ou subvolume Btrfs. Para um volume, a sintaxe é:

btrfs ponto de montagem --data=nível --metadata=nível [--label=] partições

One or more partitions can be specified in partitions. When specifying more than one partitions, the entries must be separated by a single space. See Kickstart_Syntax_Reference.adoc#exam-kickstart-create-btrfs for a demonstration.

Para um subvolume, a sintaxe é:

btrfs ponto de montagem --subvol --name=nome pai

pai deve ser o identificador do volume pai do subvolume, nome com um nome para o subvolume e ponto de montagem é o local onde o sistema de arquivos está montado.

--data=

Nível de RAID a ser usado para dados do sistema de arquivos (como 0, 1 ou 10). Este parâmetro é opcional, não tem significado para subvolumes e requer mais de um disco físico.

--metadata=

Nível de RAID a ser usado para sistema de arquivos/volume de metadados (como 0, 1 ou 10). Este parâmetro é opcional, não tem significado para subvolumes e requer mais de um disco físico.

--label=

Especifica um rótulo para o sistema de arquivos Btrfs. Se o rótulo fornecido já estiver em uso por outro sistema de arquivos, um novo rótulo será criado. Esta opção não tem significado para subvolumes.

--subvol

Cria um subvolume Btrfs em vez de um volume.

--name=

Define um nome para um subvolume Btrfs.

--noformat ou --useexisting

Usa um volume Btrfs existente (ou subvolume) e não reformata o sistema de arquivos.

--mkfsoptions=

Especifica parâmetros adicionais a serem passados para o programa que cria um sistema de arquivos neste volume ou subvolume. Nenhum processamento é feito na lista de argumentos, então eles devem ser fornecidos em um formato que pode ser passado diretamente para o programa mkfs. Isso significa que várias opções devem ser separadas por vírgulas ou entre aspas, dependendo do sistema de arquivos.

O exemplo a seguir mostra como criar um volume Btrfs a partir de partições membros em três discos com subvolumes para / e /home. O volume principal não é montado ou usado diretamente neste exemplo.

Example 1. Criando volumes e subvolumes Btrfs
part btrfs.01 --size=6000 --ondisk=sda
part btrfs.02 --size=6000 --ondisk=sdb
part btrfs.03 --size=6000 --ondisk=sdc

btrfs none --data=0 --metadata=1 --label=f31 btrfs.01 btrfs.02 btrfs.03
btrfs / --subvol --name=root LABEL=f31
btrfs /home --subvol --name=home f31

clearpart (opcional) - Remove todas as partições existentes

Remove partições do sistema, antes da criação de novas partições. Por padrão, nenhuma partição é removida.

Se o comando clearpart for usado, o comando part --onpart não poderá ser usado em uma partição lógica.

For a detailed example of partitioning including the clearpart command, see Kickstart_Syntax_Reference.adoc#sect-kickstart-example-advanced-partitioning.

--all

Apaga todas as partições do sistema.

Esta opção apagará todos os discos que podem ser acessados pelo instalador, incluindo qualquer armazenamento de rede conectado. Use esta opção com cuidado.

--drives=

Especifica de quais unidades limpar as partições. Por exemplo, o seguinte limpa todas as partições nas primeiras duas unidades no controlador IDE primário:

clearpart --drives=hda,hdb --all

Para limpar um dispositivo multipath, use o formato disk/by-id/scsi-WWID, onde WWID é o world-wide identifier (identificador mundial) para o dispositivo. Por exemplo, para limpar um disco com WWID 58095BEC5510947BE8C0360F604351918, use:

clearpart --drives=disk/by-id/scsi-58095BEC5510947BE8C0360F604351918

Este formato é preferível para todos os dispositivos multipath, mas se surgirem erros, os dispositivos multipath que não usam gerenciamento de volume lógico (LVM) também podem ser limpos usando o formato disk/by-id/dm-uuid-mpath-WWID, onde WWID é o world-wide identifier (identificador mundial) do dispositivo. Por exemplo, para limpar um disco com WWID 2416CD96995134CA5D787F00A5AA11017, use:

clearpart --drives=disk/by-id/dm-uuid-mpath-2416CD96995134CA5D787F00A5AA11017

Nunca especifique dispositivos multipath por nomes de dispositivos como mpatha. Nomes de dispositivos como este não são específicos para um determinado disco. O disco denominado /dev/mpatha durante a instalação pode não ser o que você esperava. Portanto, o comando clearpart pode ter como destino o disco errado.

A partir do Fedora 25, você pode combinar várias maneiras de especificar destinos de armazenamento em um comando, usando o pipe ("|") como delimitador. Por exemplo:

clearpart --drives=sd*|hd*|vda,/dev/vdc

O acima irá corresponder a qualquer um de sd*, hd*, ou vda e /dev/vdc. As variantes são processadas da esquerda para a direita e pelo menos uma delas deve corresponder para que o comando seja bem-sucedido.

--list=

Especifica quais partições limpar. Esta opção sobrescreve as opções --all e --linux, se usadas. Pode ser usado em diferentes unidades. Por exemplo:

clearpart --list=sda2,sda3,sdb1
--disklabel=

Cria um conjunto de rótulo de disco ao renomear um disco.

--linux

Apaga todas as partições Linux.

--none

Não remove nenhuma partição. Este é o comportamento padrão - usar esta opção é o mesmo que não usar o comando clearpart.

Usar o comando clearpart --all em um arquivo Kickstart para remover todas as partições existentes durante a instalação fará com que o Anaconda pause e solicite uma confirmação. Se você precisar executar a instalação automaticamente sem interação, adicione o comando zerombr ao seu arquivo Kickstart.

fcoe (opcional) - Configura dispositivos de Fibre Channel sobre Ethernet

Especifica quais dispositivos FCoE devem ser ativados automaticamente, além daqueles descobertos por Enhanced Disk Drive Services (EDD).

fcoe --nic=nome [--dcp= | --autovlan]
--nic= (obrigatório)

Nome do dispositivo a ser ativado.

--dcb=

Estabelece configurações de Data Center Bridging (DCB).

--autovlan

Descobre VLANs automaticamente.

ignoredisk (opcional) - Ignora discos específicos

Faz com que o programa de instalação ignore os discos especificados. Isso é útil se você usar a partição automática e quiser ter certeza de que alguns discos serão ignorados. Por exemplo, sem ignoredisk, a tentativa de implantar em um cluster SAN, o Kickstart falhará, pois o programa de instalação detecta caminhos passivos para a SAN que não retornam nenhuma tabela de partição.

ignoredisk --drives= | --only-use= [--interactive]
--drives=

Especifica uma ou mais unidades para ignorar. Várias unidades podem ser especificadas como uma lista separada por vírgulas. Por exemplo:

ignoredisk --drives=sda,sdc

Para ignorar um dispositivo multicaminho que não usa gerenciamento de volume lógico (LVM), use o formato disk/by-id/dm-uuid-mpath-WWID, onde WWID é o world-wide identifier (identificador mundial) para o dispositivo. Por exemplo, para ignorar um disco com WWID 2416CD96995134CA5D787F00A5AA11017, use:

ignoredisk --drives=disk/by-id/dm-uuid-mpath-2416CD96995134CA5D787F00A5AA11017

Os dispositivos multicaminho que usam LVM não são montados até que o Anaconda tenha analisado o arquivo Kickstart. Portanto, você não pode especificar esses dispositivos no formato dm-uuid-mpath. Em vez disso, para ignorar um dispositivo multicaminho que usa LVM, use o formato disk/by-id/scsi-WWID, onde WWID é o world-wide identifier (identificador mundial) do dispositivo. Por exemplo, para ignorar um disco com WWID 58095BEC5510947BE8C0360F604351918, use:

ignoredisk --drives=disk/by-id/scsi-58095BEC5510947BE8C0360F604351918

Nunca especifique dispositivos multipath por nomes de dispositivos como mpatha. Nomes de dispositivos como este não são específicos para um determinado disco. O disco denominado /dev/mpatha durante a instalação pode não ser o que você esperava. Portanto, o comando clearpart pode ter como destino o disco errado.

A partir do Fedora 25, você pode combinar várias maneiras de especificar destinos de armazenamento em um comando, usando o pipe ("|") como delimitador. Por exemplo:

ignoredisk --drives=sd*|hd*|vda,/dev/vdc

O acima irá corresponder a qualquer um de sd*, hd*, ou vda e /dev/vdc. As variantes são processadas da esquerda para a direita e pelo menos uma delas deve corresponder para que o comando seja bem-sucedido.

--only-use=

Especifica uma lista de discos para uso do programa de instalação. Todos os outros discos são ignorados. Por exemplo, para usar o disco sda durante a instalação e ignorar todos os outros discos:

ignoredisk --only-use=sda

Para incluir um dispositivo multicaminho que não usa LVM:

ignoredisk --only-use=disk/by-id/dm-uuid-mpath-2416CD96995134CA5D787F00A5AA11017

Para incluir um dispositivo multicaminho que usa LVM:

ignoredisk --only-use=disk/by-id/scsi-58095BEC5510947BE8C0360F604351918
--interactive

Permite que você navegue manualmente na tela de armazenamento avançado.

iscsi (opcional) - Configura dispositivos iSCSI

Specifies additional iSCSI storage to be attached during installation. If you use the iscsi command, you must also assign a name to the iSCSI node, using the iscsiname command (see Kickstart_Syntax_Reference.adoc#sect-kickstart-commands-iscsiname. The iscsiname command must appear before the iscsi command in the Kickstart file.

Você deve configurar o armazenamento iSCSI no BIOS ou firmware do sistema (iBFT para sistemas Intel) em vez de usar o comando iscsi se possível. Se você fizer isso, o Anaconda detecta e usa automaticamente os discos configurados no BIOS ou firmware e nenhuma configuração especial é necessária no arquivo Kickstart.

Se você deve usar o comando iscsi, certifique-se de que a rede esteja ativada no início da instalação, e que o comando iscsi apareça no arquivo Kickstart antes de você referir-se aos discos iSCSI com comandos como clearpart ou ignoreisk.

iscsi --ipaddr=  --port=  [--target= | --iface= | --user= | --password= | --reverse-user= | --reverse-password=]
--ipaddr=

O endereço IP do alvo para conectar.

--port=

O número de porta (geralmente 3260).

--target=

IQN (Nome Qualificado iSCSI) alvo.

--iface=

Vincula a conexão a uma interface de rede específica em vez de usar a interface padrão determinada pela camada de rede. Uma vez usado, ele deve ser especificado em todas as instâncias do comando iscsi em todo o arquivo Kickstart.

--user=

Nome de usuário necessário para autenticar com o alvo.

--password=

Senha que corresponde ao nome de usuário especificado para o alvo.

--reverse-user=

Nome de usuário necessário para autenticar com o iniciador de um destino usando autenticação CHAP reversa.

--reverse-password=

Senha que corresponde ao nome de usuário especificado para o iniciador.

iscsiname (opcional) - Atribui nome do dispositivo iSCSI

Assigns a name to an iSCSI node specified by the iscsi command (Kickstart_Syntax_Reference.adoc#sect-kickstart-commands-iscsi). This command is mandatory if you use the iscsi command, and it must be specified before you use iscsi.

iscsiname iqn

logvol (opcional) - Cria volume lógico LVM

Cria um volume lógico para Gerenciamento de Volume Lógico (LVM) com a sintaxe:

logvol pontomontagem --vgname=  --name= [opções]

Não usa o caractere de traço (-) no volume lógico e nomes de grupo de volume ao instalar Fedora usando o Kickstart. Se este caractere for usado, a instalação terminará normalmente, mas o diretório /dev/mapper/ irá listar esses volumes e grupos de volumes com cada traço dobrado. Por exemplo, um grupo de volume denominado volgrp-01 contendo um volume lógico denominado logvol-01 será listado como /dev/mapper/volgrp—​01-logvol—​01.

Essa limitação se aplica apenas a nomes de volume lógico e grupo de volume recém-criados. Se você estiver reutilizando os existentes usando a opção --noformat ou --useexisting, seus nomes não serão alterados.

For a detailed example of logvol in action, see Kickstart_Syntax_Reference.adoc#sect-kickstart-example-advanced-partitioning.

pontomontagem

Substitui com o ponto de montagem do volume. Este nome aceita as seguintes formas:

/caminho

Um caminho para o ponto de montagem - por exemplo, / ou /home

swap

A partição é usada como espaço swap.

Para determinar o tamanho da partição swap automaticamente, use a opção --recommended:

swap --recommended

Para determinar o tamanho da partição swap automaticamente, mas também permitir espaço extra para o seu sistema hibernar, use a opção --hibernation:

swap --hibernation

O tamanho atribuído será equivalente ao espaço de troca atribuído por --recommended mais a quantidade de RAM em seu sistema.

Para os tamanhos de swap atribuídos por esses comandos, consulte a seção que descreve swap em Esquema de particionamento recomendado.

none

Usada apenas ao criar um volume thin-pool.

--noformat

Usa um volume lógico existente e não o formata.

--useexisting

Usa um volume lógico existente e o formate.

--fstype=

Define o tipo de sistema de arquivos para o volume lógico. Os valores válidos são xfs, ext2, ext3, ext4, swap e vfat. Veja Tipos de dispositivos, sistemas de arquivos e RAID para informações sobre os sistemas de arquivos disponíveis.

--fsoptions=

Especifica uma sequência de opções de formato livre a ser usada ao montar o sistema de arquivos. Esta string será copiada para o arquivo /etc/fstab do sistema instalado e deve ser colocada entre aspas. Por exemplo:

--fsoptions="ro, x-systemd.device-timeout=0"
--mkfsoptions=

Especifica parâmetros adicionais a serem passados para o programa que cria um sistema de arquivos neste volume lógico. Nenhum processamento é feito na lista de argumentos, então eles devem ser fornecidos em um formato que pode ser passado diretamente para o programa mkfs. Isso significa que várias opções devem ser separadas por vírgulas ou entre aspas, dependendo do sistema de arquivos.

--label=

Define um rótulo para o volume lógico.

--grow

Aumenta o volume para preencher o espaço disponível (se houver) ou até o limite definido pela opção --maxsize=.

--size=

O tamanho do volume lógico em megabytes. Esta opção não pode ser usada junto com a opção --percent=.

--percent=

Especifica a quantidade pela qual o volume lógico deve crescer, como uma porcentagem do espaço livre no grupo de volumes após quaisquer volumes lógicos de tamanho estático serem considerados. Esta opção não pode ser usada junto com as opções --size= e --grow.

Ao criar um novo volume lógico, você deve especificar seu tamanho estaticamente usando a opção --size=, ou como uma porcentagem do espaço livre restante usando a opção --percent=. Você não pode usar ambas as opções no mesmo volume lógico.

--maxsize=

O tamanho máximo em megabytes quando o volume lógico é configurado para aumentar. Especifique um valor inteiro aqui, como 500 (não inclua a unidade).

--recommended

Use esta opção ao criar um volume lógico swap para determinar o tamanho deste volume automaticamente, baseado no hardware do seu sistema. Para obter detalhes sobre o esquema recomendado, consulte Esquema de particionamento recomendado.

Esta opção só pode ser usada para partições que resultam em um sistema de arquivos como a partição /boot e o espaço swap. Não pode ser usado para criar partições, volumes físicos ou lógicos de LVM ou membros RAID.

--resize

Redimensiona um volume lógico existente. Se você usar esta opção, você também deve especificar --useexisting e --size.

--encrypted

Especifica que este volume lógico deve ser criptografado, usando a senha fornecida na opção --passphrase=. Se você não especificar uma senha, o programa de instalação usará a senha padrão para todo o sistema definida com o comando autopart --passphrase, ou interromperá a instalação e solicitará que você forneça uma senha se nenhum padrão for definido.

--passphrase=

Especifica a frase secreta a ser usada ao criptografar este volume lógico. Você deve usar esta opção junto com a opção --encrypted. Esta opção não tem efeito por si só.

--cipher=

Especifica qual tipo de criptografia será usado se aes-xts-plain64, padrão do Anaconda, não for satisfatório. Você deve usar esta opção junto com a opção --encrypted; por si só não tem efeito. Os tipos de criptografia disponíveis estão listados no Fedora Security Guide (guia de segurança), disponível no https://docs.fedoraproject.org/. Usar aes-xts-plain64 ou aes-cbc-essiv: sha256 é fortemente recomendado.

--escrowcert=URL_do_certificado_X.509

Armazena as chaves de criptografia de dados de todos os volumes criptografados como arquivos em /root, criptografados usando o certificado X.509 da URL especificada com URL_do_certificado_X.509. As chaves são armazenadas como um arquivo separado para cada volume criptografado. Esta opção só é significativa se --encrypted for especificado.

--backuppassphrase

Adiciona uma senha gerada aleatoriamente a cada volume criptografado. Armazena essas senhas em arquivos separados em /root, criptografados usando o certificado X.509 especificado com --escrowcert. Esta opção só é significativa se --escrowcert for especificado.

--thinpool

Cria um volume lógico de thin-pool. (Use um ponto de montagem de none)

--metadatasize=

Tamanho da área de metadados (em MiB) para um novo dispositivo de thin pool.

--chunksize=

Tamanho do bloco (em KiB) para um novo dispositivo de thin pool.

--thin

Cria um volume lógico thing. (Requer o uso de --poolname)

--poolname=

Especifica o nome do thin pool no qual criar um volume lógico thin. Requer a opção --thin.

--profile=

Especifica o nome do perfil de configuração a ser usado com volumes lógicos thin. Se usado, o nome também será incluído nos metadados para o volume lógico fornecido. Por padrão, os perfis disponíveis são default e thin-performance e são definidos no diretório /etc/lvm/profile. Consulte a página man lvm(8) para obter informações adicionais.

--cachepvs=

Uma lista separada por vírgulas de volumes físicos (rápidos) que devem ser usados para o cache LVM.

--cachesize=

Tamanho solicitado de cache anexado ao volume lógico, em MiB. (Requer a opção --cachepvs=.)

--cachemode=

Modo a ser usado para cache LVM (writeback ou writethrough).

As opções --cachepvs=, --cachesize= e --cachemode= listadas acima são usadas para configurar cache de LVM. Para mais informações, veja a áginas man lvmcache(7).

--luks-version=

Especifica qual versão do LUKS deve ser usada para criptografar o sistema. Relevante apenas se --encrypted também for especificada.

--pbkdf=

Define o algoritmo da Função de Derivação de Chave Baseada em Senha (PBKDF) para o slot de chave LUKS. Relevante apenas se --encrypted também for especificado. Consulte a página man cryptsetup(8) para obter mais informações.

pbkdf-memory=

Define o custo de memória para PBKDF. Relevante apenas se --encrypted também for especificada. Consulte a página man cryptsetup(8) para obter mais informações.

pbkdf-time=

Define o número de milissegundos a ser gasto com o processamento da senha PBKDF. Relevante apenas se --encrypted também for especificado. Veja informações sobre a opção --iter-time na página man cryptsetup(8) para mais informações.

Apenas uma de --pbkdf-time= ou --pbkdf-iterations= pode ser especificada ao mesmo tempo.

pbkdf-iterations=

Define o número de iterações para o processamento da senha diretamente e evita a avaliação de desempenho de PBKDF. Relevante apenas se --encrypted também for especificado. Veja informações sobre a opção --pbkdf-force-iterations na página do manual cryptsetup(8) para mais informações.

Apenas uma de --pbkdf-time= ou --pbkdf-iterations= pode ser especificada ao mesmo tempo.

Create one or more partitions first using Kickstart_Syntax_Reference.adoc#sect-kickstart-commands-part, create the logical volume group (Kickstart_Syntax_Reference.adoc#sect-kickstart-commands-volgroup), and then create logical volumes. For example:

part pv.01 --size 3000
volgroup myvg pv.01
logvol / --vgname=myvg --size=2000 --name=rootvol

part (required) - Create Physical Partition

Creates a partition on the system.

part|partition mntpoint --name=name --device=device --rule=rule [options]

All partitions created are formatted as part of the installation process unless --noformat and --onpart= are used.

If partitioning fails for any reason, diagnostic messages appear on virtual console 3.

pontomontagem

Where the partition is mounted. The value must be of one of the following:

/caminho

Um caminho para o ponto de montagem - por exemplo, / ou /home

swap

A partição é usada como espaço swap.

Para determinar o tamanho da partição swap automaticamente, use a opção --recommended:

swap --recommended

The size assigned will be effective but not precisely calibrated for your system.

Para determinar o tamanho da partição swap automaticamente, mas também permitir espaço extra para o seu sistema hibernar, use a opção --hibernation:

swap--hibernation

O tamanho atribuído será equivalente ao espaço de troca atribuído por --recommended mais a quantidade de RAM em seu sistema.

Para os tamanhos de swap atribuídos por esses comandos, consulte a seção que descreve swap em Esquema de particionamento recomendado.

raid.id

The partition is used for software RAID (see raid).

pv.id

The partition is used for LVM (see Kickstart_Syntax_Reference.adoc#sect-kickstart-commands-part).

biosboot

The partition will be used for a BIOS Boot partition. A 1 MB BIOS boot partition is necessary on BIOS-based systems using a GUID Partition Table (GPT); the boot loader will be installed into it. It is not necessary on UEFI systems. Also see Kickstart_Syntax_Reference.adoc#sect-kickstart-commands-part.

/boot/efi

An EFI System Partition. An EFI partition at least 50 MB in size is necessary on UEFI-based systems; the recommended size is 200 MB. It is not necessary on BIOS systems. Also see Kickstart_Syntax_Reference.adoc#sect-kickstart-commands-part.

--size=

The minimum partition size in megabytes. Specify an integer value here such as 500 (do not include the unit).

If the --size value is too small, the installation will fail. Set the --size value as the minimum amount of space you require. For size recommendations, see Recommended Partitioning Scheme.

--maxsize=

The maximum partition size in megabytes when the partition is set to grow. Specify an integer value here such as 500 (do not include the unit).

--resize

Resize an existing partition. When using this option, specify the new size (in megabytes) using the --size= option and the target partition using the --onpart= option.

--grow

Tells the partition to grow to fill available space (if any), or up to the maximum size setting.

If you use --grow= without setting --maxsize= on a swap partition, Anaconda will limit the maximum size of the swap partition. For systems that have less than 2 GB of physical memory, the imposed limit is twice the amount of physical memory. For systems with more than 2 GB, the imposed limit is the size of physical memory plus 2 GB.

--noformat

Specifies that the partition should not be formatted, for use with the --onpart command.

--onpart= or --usepart=

Specifies the device on which to place the partition. For example:

partition /home --onpart=hda1

The above puts /home on /dev/hda1.

These options can also add a partition to a logical volume. For example:

partition pv.1 --onpart=hda2

The device must already exist on the system; the --onpart option will not create it.

--ondisk= or --ondrive=

Forces the partition to be created on a particular disk. For example, --ondisk=sdb puts the partition on the second SCSI disk on the system.

To specify a multipath device that does not use logical volume management (LVM), use the format disk/by-id/dm-uuid-mpath-WWID, where WWID is the world-wide identifier for the device. For example, to specify a disk with WWID 2416CD96995134CA5D787F00A5AA11017, use:

part / --fstype=xfs --grow --asprimary --size=8192 --ondisk=disk/by-id/dm-uuid-mpath-2416CD96995134CA5D787F00A5AA11017

Multipath devices that use LVM are not assembled until after Anaconda has parsed the Kickstart file. Therefore, you cannot specify these devices in the format dm-uuid-mpath. Instead, to specify a multipath device that uses LVM, use the format disk/by-id/scsi-WWID, where WWID is the world-wide identifier for the device. For example, to specify a disk with WWID 58095BEC5510947BE8C0360F604351918, use:

part / --fstype=xfs --grow --asprimary --size=8192 --ondisk=disk/by-id/scsi-58095BEC5510947BE8C0360F604351918

Nunca especifique dispositivos multipath por nomes de dispositivos como mpatha. Nomes de dispositivos como este não são específicos para um determinado disco. O disco denominado /dev/mpatha durante a instalação pode não ser o que você esperava. Portanto, o comando clearpart pode ter como destino o disco errado.

A partir do Fedora 25, você pode combinar várias maneiras de especificar destinos de armazenamento em um comando, usando o pipe ("|") como delimitador. Por exemplo:

part --onpart=sd*|hd*|vda,/dev/vdc

O acima irá corresponder a qualquer um de sd*, hd*, ou vda e /dev/vdc. As variantes são processadas da esquerda para a direita e pelo menos uma delas deve corresponder para que o comando seja bem-sucedido.

--asprimary

Forces the partition to be allocated as a primary partition. If the partition cannot be allocated as primary (usually due to too many primary partitions being already allocated), the partitioning process will fail. This option only makes sense when the disk uses a Master Boot Record (MBR); for GUID Partition Table (GPT)-labeled disks this option has no meaning. For information about primary (and extended) partitions, see Recommended Partitioning Scheme.

--fsprofile=

Specifies a usage type to be passed to the program that makes a filesystem on this partition. A usage type defines a variety of tuning parameters to be used when making a filesystem. For this option to work, the filesystem must support the concept of usage types and there must be a configuration file that lists valid types. For ext2, ext3, ext4, this configuration file is /etc/mke2fs.conf.

--fstype=

Sets the file system type for the partition. Valid values are xfs, ext2, ext3, ext4, swap, vfat, efi and biosboot. For information about supported file systems, see Device, File System and RAID Types.

--fsoptions=

Especifica uma sequência de opções de formato livre a ser usada ao montar o sistema de arquivos. Esta string será copiada para o arquivo /etc/fstab do sistema instalado e deve ser colocada entre aspas. Por exemplo:

--fsoptions="ro, x-systemd.device-timeout=0"
--mkfsoptions=

Specifies additional parameters to be passed to the program that makes a filesystem on this partition. No processing is done on the list of arguments, so they must be supplied in a format that can be passed directly to the mkfs program. This means multiple options should be comma-separated or surrounded by double quotes, depending on the filesystem.

--label=

Assign a label to an individual partition.

--recommended

Determine the size of the partition automatically. For details about the recommended scheme, see Recommended Partitioning Scheme.

Esta opção só pode ser usada para partições que resultam em um sistema de arquivos como a partição /boot e o espaço swap. Não pode ser usado para criar partições, volumes físicos ou lógicos de LVM ou membros RAID.

--onbiosdisk

Forces the partition to be created on a particular disk as discovered by the BIOS.

--encrypted

Specifies that this partition should be encrypted, using the passphrase provided in the --passphrase option. If you do not specify a passphrase, Anaconda uses the default, system-wide passphrase set with the autopart --passphrase command, or stops the installation and prompts you to provide a passphrase if no default is set.

--passphrase=

Specifies the passphrase to use when encrypting this partition. You must use this option together with the --encrypted option; by itself it has no effect.

--cipher=

Especifica qual tipo de criptografia será usado se aes-xts-plain64, padrão do Anaconda, não for satisfatório. Você deve usar esta opção junto com a opção --encrypted; por si só não tem efeito. Os tipos de criptografia disponíveis estão listados no Fedora Security Guide (guia de segurança), disponível no https://docs.fedoraproject.org/. Usar aes-xts-plain64 ou aes-cbc-essiv: sha256 é fortemente recomendado.

--escrowcert=URL_do_certificado_X.509

Armazena chaves de criptografia de dados de todos os volumes criptografados como arquivos em /root, criptografados usando o certificado X.509 da URL especificada com URL_do_certificado_X.509. As chaves são armazenadas como um arquivo separado para cada volume criptografado. Esta opção só é significativa se --encrypted for especificada.

--backuppassphrase

Add a randomly-generated passphrase to each encrypted partition. Store these passphrases in separate files in /root, encrypted using the X.509 certificate specified with --escrowcert. This option is only meaningful if --escrowcert is specified.

--luks-version=

Especifica qual versão do LUKS deve ser usada para criptografar o sistema. Relevante apenas se --encrypted também for especificada.

--pbkdf=

Define o algoritmo da Função de Derivação de Chave Baseada em Senha (PBKDF) para o slot de chave LUKS. Relevante apenas se --encrypted também for especificado. Consulte a página man cryptsetup(8) para obter mais informações.

pbkdf-memory=

Define o custo de memória para PBKDF. Relevante apenas se --encrypted também for especificada. Consulte a página man cryptsetup(8) para obter mais informações.

pbkdf-time=

Define o número de milissegundos a ser gasto com o processamento da senha PBKDF. Relevante apenas se --encrypted também for especificado. Veja informações sobre a opção --iter-time na página man cryptsetup(8) para mais informações.

Apenas uma de --pbkdf-time= ou --pbkdf-iterations= pode ser especificada ao mesmo tempo.

pbkdf-iterations=

Define o número de iterações para o processamento da senha diretamente e evita a avaliação de desempenho de PBKDF. Relevante apenas se --encrypted também for especificado. Veja informações sobre a opção --pbkdf-force-iterations na página do manual cryptsetup(8) para mais informações.

Apenas uma de --pbkdf-time= ou --pbkdf-iterations= pode ser especificada ao mesmo tempo.

raid (optional) - Create Software RAID

Assembles a software RAID device. This command is of the form:

raid mntpoint --level=level --device=mddevice partitions*
pontomontagem

Location where the RAID file system is mounted. If it is /, the RAID level must be 1 unless a boot partition (/boot) is present. If a boot partition is present, the /boot partition must be level 1 and the root (/) partition can be any of the available types. The partitions* (which denotes that multiple partitions can be listed) lists the RAID identifiers to add to the RAID array.

--level=

RAID level to use (0, 1, 4, 5, 6, or 10). See Device, File System and RAID Types for information about various RAID types and their requirements.

--device=

Name of the RAID device to use. As of Fedora 31, RAID devices are no longer referred to by names like md0. If you have an old (v0.90 metadata) array that you cannot assign a name to, you can specify the array by a filesystem label or UUID (for example, --device=rhel7-root --label=rhel7-root).

--spares=

Specifies the number of spare drives allocated for the RAID array. Spare drives are used to rebuild the array in case of drive failure.

--fsprofile=

Specifies a usage type to be passed to the program that makes a filesystem on this partition. A usage type defines a variety of tuning parameters to be used when making a filesystem. For this option to work, the filesystem must support the concept of usage types and there must be a configuration file that lists valid types. For ext2, ext3, ext4, this configuration file is /etc/mke2fs.conf.

--fstype=

Sets the file system type for the partition. Valid values are xfs, ext2, ext3, ext4, swap, vfat, efi and biosboot. For information about supported file systems, see Device, File System and RAID Types.

--fsoptions=

Especifica uma sequência de opções de formato livre a ser usada ao montar o sistema de arquivos. Esta string será copiada para o arquivo /etc/fstab do sistema instalado e deve ser colocada entre aspas. Por exemplo:

--fsoptions="ro, x-systemd.device-timeout=0"
--mkfsoptions=

Specifies additional parameters to be passed to the program that makes a filesystem on this partition. No processing is done on the list of arguments, so they must be supplied in a format that can be passed directly to the mkfs program. This means multiple options should be comma-separated or surrounded by double quotes, depending on the filesystem.

--label=

Specify the label to give to the filesystem to be made. If the given label is already in use by another filesystem, a new label will be created.

--noformat

Use an existing RAID device and do not format it.

--useexisting

Use an existing RAID device and reformat it.

--encrypted

Specifies that this array should be encrypted, using the passphrase provided in the --passphrase option. If you do not specify a passphrase, Anaconda uses the default, system-wide passphrase set with the autopart --passphrase command, or stops the installation and prompts you to provide a passphrase if no default is set.

--passphrase=

Specifies the passphrase to use when encrypting this partition. You must use this option together with the --encrypted option; by itself it has no effect.

--cipher=

Especifica qual tipo de criptografia será usado se aes-xts-plain64, padrão do Anaconda, não for satisfatório. Você deve usar esta opção junto com a opção --encrypted; por si só não tem efeito. Os tipos de criptografia disponíveis estão listados no Fedora Security Guide (guia de segurança), disponível no https://docs.fedoraproject.org/. Usar aes-xts-plain64 ou aes-cbc-essiv: sha256 é fortemente recomendado.

--escrowcert=URL_do_certificado_X.509

Armazena chaves de criptografia de dados de todos os volumes criptografados como arquivos em /root, criptografados usando o certificado X.509 da URL especificada com URL_do_certificado_X.509. As chaves são armazenadas como um arquivo separado para cada volume criptografado. Esta opção só é significativa se --encrypted for especificada.

--backuppassphrase

Add a randomly-generated passphrase to each encrypted partition. Store these passphrases in separate files in /root, encrypted using the X.509 certificate specified with --escrowcert. This option is only meaningful if --escrowcert is specified.

--luks-version=

Especifica qual versão do LUKS deve ser usada para criptografar o sistema. Relevante apenas se --encrypted também for especificada.

--pbkdf=

Define o algoritmo da Função de Derivação de Chave Baseada em Senha (PBKDF) para o slot de chave LUKS. Relevante apenas se --encrypted também for especificado. Consulte a página man cryptsetup(8) para obter mais informações.

pbkdf-memory=

Define o custo de memória para PBKDF. Relevante apenas se --encrypted também for especificada. Consulte a página man cryptsetup(8) para obter mais informações.

pbkdf-time=

Define o número de milissegundos a ser gasto com o processamento da senha PBKDF. Relevante apenas se --encrypted também for especificado. Veja informações sobre a opção --iter-time na página man cryptsetup(8) para mais informações.

Apenas uma de --pbkdf-time= ou --pbkdf-iterations= pode ser especificada ao mesmo tempo.

pbkdf-iterations=

Define o número de iterações para o processamento da senha diretamente e evita a avaliação de desempenho de PBKDF. Relevante apenas se --encrypted também for especificado. Veja informações sobre a opção --pbkdf-force-iterations na página do manual cryptsetup(8) para mais informações.

Apenas uma de --pbkdf-time= ou --pbkdf-iterations= pode ser especificada ao mesmo tempo.

The following example shows how to create a RAID level 1 partition for /, and a RAID level 5 for /home, assuming there are three SCSI disks on the system. It also creates three swap partitions, one on each drive.

Example 2. Creating a RAID array in Kickstart
part raid.01 --size=6000 --ondisk=sda
part raid.02 --size=6000 --ondisk=sdb
part raid.03 --size=6000 --ondisk=sdc

part swap --size=512 --ondisk=sda
part swap --size=512 --ondisk=sdb
part swap --size=512 --ondisk=sdc

part raid.11 --size=1 --grow --ondisk=sda
part raid.12 --size=1 --grow --ondisk=sdb
part raid.13 --size=1 --grow --ondisk=sdc

raid / --level=1 --device=f31-root --label=f31-root raid.01 raid.02 raid.03
raid /home --level=5 --device=f31-home --label=f31-home raid.11 raid.12 raid.13

reqpart (optional) - Create Required Partitions

Automatically create partitions required by your hardware platform. These include a /boot/efi for x86_64 and Aarch64 systems with UEFI firmware, biosboot for x86_64 systems with BIOS firmware and GPT (GUID Partition Table), and PRePBoot for IBM Power Systems.

This command can not be used together with autopart, because autopart does the same and creates other partitions or logical volumes such as / and swap on top. In contrast with autopart, this command only creates platform-specific partitions and leaves the rest of the drive empty, allowing you to create a custom layout.

reqpart [--add-boot]
--add-boot

Create a separate /boot partition in addition to the platform-specific partition created by the base command.

volgroup (optional) - Create LVM Volume Group

Creates a Logical Volume Management (LVM) volume group.

volgroup name partition [options]

Não usa o caractere de traço (-) no volume lógico e nomes de grupo de volume ao instalar Fedora usando o Kickstart. Se este caractere for usado, a instalação terminará normalmente, mas o diretório /dev/mapper/ irá listar esses volumes e grupos de volumes com cada traço dobrado. Por exemplo, um grupo de volume denominado volgrp-01 contendo um volume lógico denominado logvol-01 será listado como /dev/mapper/volgrp—​01-logvol—​01.

This limitation only applies to newly created logical volume and volume group names. If you are reusing existing ones using the --noformat or --noformat option, their names will not be changed.

For a detailed partitioning example including volgroup, see Kickstart_Syntax_Reference.adoc#sect-kickstart-example-advanced-partitioning.

--noformat

Use an existing volume group and do not format it.

--useexisting

Use an existing volume group and reformat it.

--pesize=

Set the size of the physical extents. The default size for Kickstart installations is 4 MiB.

--reserved-space=

Specify an amount of space to leave unused in a volume group in megabytes. Applicable only to newly created volume groups.

--reserved-percent=

Specify a percentage of total volume group space to leave unused. Applicable only to newly created volume groups.

Create one or more partitions first using Kickstart_Syntax_Reference.adoc#sect-kickstart-commands-part, create the logical volume group (Kickstart_Syntax_Reference.adoc#sect-kickstart-commands-volgroup), and then create logical volumes. For example:

part pv.01 --size 3000
volgroup myvg pv.01
logvol / --vgname=myvg --size=2000 --name=rootvol

zerombr (optional) - Reinitialize Partition Tables

If zerombr is specified, any invalid partition tables found on disks are initialized. This destroys all of the contents of disks with invalid partition tables. This command is required when performing an unattended installation on a system with previously initialized disks.

On IBM System z, if zerombr is specified, any Direct Access Storage Device (DASD) visible to the installation program which is not already low-level formatted is automatically low-level formatted with dasdfmt. The command also prevents user choice during interactive installations.

If zerombr is not specified and there is at least one unformatted DASD visible to the installation program, a non-interactive Kickstart installation will exit unsuccessfully.

If zerombr is not specified and there is at least one unformatted DASD visible to the installation program, an interactive installation exits if the user does not agree to format all visible and unformatted DASDs. To circumvent this, only activate those DASDs that you will use during installation. You can always add more DASDs after installation is complete.

zfcp (optional) - Configure Fibre Channel Device

Define a Fibre channel device. This option only applies on IBM System z. All of the options described below must be specified.

zfcp --devnum=devnum --wwpn=wwpn --fcplun=lun
--devnum

The device number (zFCP adaptor device bus ID).

--wwpn

The device’s World Wide Port Name (WWPN). Takes the form of a 16-digit number, preceded by 0x.

--fcplun

The device’s Logical Unit Number (LUN). Takes the form of a 16-digit number, preceded by 0x.

For example:

zfcp --devnum=0.0.4000 --wwpn=0x5005076300C213e9 --fcplun=0x5022000000000000

Configuração de rede

Commands in this chapter are used for network configuration.

firewall (optional) - Configure Firewall

Specify the firewall configuration for the installed system.

firewall --enabled | --disabled device [--trust= | --ssh | --smtp | --http | --ftp | --port= | --service=]
--enabled or --enable

Reject incoming connections that are not in response to outbound requests, such as DNS replies or DHCP requests. If access to services running on this machine is needed, you can choose to allow specific services through the firewall.

--disabled or --disable

Desabilitar o firewall.

--trust=

Listing a device here, such as em1, allows all traffic coming to and from that device to go through the firewall. To list more than one device, use this option again - for example:

firewall --enable --trust=em1 --trust=em2

Do not use a comma-separated format such as --trust em1, em2.

incoming

Replace with one or more of the following to allow the specified services through the firewall:

  • --ssh

  • --smtp

  • --http

  • --ftp

--port=

You can specify that ports be allowed through the firewall using the port:protocol format. For example, to allow IMAP access through your firewall, specify imap:tcp. Numeric ports can also be specified explicitly; for example, to allow UDP packets on port 1234 through, specify 1234:udp. To specify multiple ports, separate them by commas.

--service=

This option provides a higher-level way to allow services through the firewall. Some services (like cups, avahi, etc.) require multiple ports to be open or other special configuration in order for the service to work. You can specify each individual port with the --port option, or specify --service= and open them all at once.

Valid options are anything recognized by the firewall-offline-cmd program in the firewalld package. If firewalld is running, firewall-cmd --get-services will provide a list of known service names.

network (optional) - Configure Network Interfaces

Configures network information for the target system and activates network devices in the installation environment. The device specified in the first network command is activated automatically. Activation of the device can be also explicitly required by the --activate option.

--activate

If you use the --activate option on a device that has already been activated (for example, an interface you configured with boot options so that the system could retrieve the Kickstart file) the device is reactivated to use the details specified in the Kickstart file.

Use the --nodefroute option to prevent the device from using the default route.

--no-activate

Prevents the configured device from automatically activating on boot.

--bootproto=

One of dhcp, bootp, ibft, or static. The default option is dhcp; the dhcp and bootp options are treated the same.

The DHCP method uses a DHCP server system to obtain its networking configuration. The BOOTP method is similar, requiring a BOOTP server to supply the networking configuration. To direct a system to use DHCP:

network --bootproto=dhcp

To direct a machine to use BOOTP to obtain its networking configuration, use the following line in the Kickstart file:

network --bootproto=bootp

To direct a machine to use the configuration specified in iBFT, use:

network --bootproto=ibft

The static method requires that you specify the IP address, netmask, gateway, and nameserver in the Kickstart file. This information is static and is used during and after the installation.

All static networking configuration information must be specified on one line; you cannot wrap lines using a backslash (\) as you can on a command line.

network --bootproto=static --ip=10.0.2.15 --netmask=255.255.255.0 --gateway=10.0.2.254 --nameserver=10.0.2.1

You can also configure multiple nameservers at the same time. To do so, use the --nameserver= options once for each name server you want to configure:

network --bootproto=static --ip=10.0.2.15 --netmask=255.255.255.0 --gateway=10.0.2.254 --nameserver=192.168.2.1 --nameserver=192.168.3.1
--device=

Specifies the device to be configured (and eventually activated in Anaconda) with the network command.

If the --device= option is missing on the first use of the network command, the value of the ksdevice= Anaconda boot option is used, if available. Note that this is considered deprecated behavior; in most cases, you should always specify a --device= for every network command.

The behavior of any subsequent network command in the same Kickstart file is unspecified if its --device= option is missing. Make sure you specify this option for any network command beyond the first.

You can specify a device to be activated in any of the following ways:

  • the device name of the interface, for example, em1

  • the MAC address of the interface, for example, 01:23:45:67:89:ab

  • the keyword link, which specifies the first interface with its link in the up state

  • the keyword bootif, which uses the MAC address that pxelinux set in the BOOTIF variable. Set IPAPPEND 2 in your pxelinux.cfg file to have pxelinux set the BOOTIF variable.

    For example:

    network --bootproto=dhcp --device=em1
--bindto=

Optional. Allows to specify how the connection configuration created for the device should be bound. If the option is not used, the connection binds to interface name (DEVICE value in ifcfg file). For virtual devices (bond, team, bridge) it configures binding of slaves. Not applicable to vlan devices.

Note that this option is independent of how the --device is specified.

Currently only the value mac is suported. --bindto=mac will bind the connection to MAC address of the device (HWADDR value in the ifcfg file).

For example:

network --device=01:23:45:67:89:ab --bootproto=dhcp --bindto=mac

The above will bind the configuration of the device specified by MAC address 01:23:45:67:89:ab to its MAC address.

network --device=01:23:45:67:89:ab --bootproto=dhcp

The above will bind the configuration of the device specified by MAC address 01:23:45:67:89:ab to its interface name (e.g. ens3).

network --device=ens3 --bootproto=dhcp --bindto=mac

The above will bind the configuration of the device specified by interface name ens3 to its MAC address.

--ip=

IP address of the device.

--ipv6=

IPv6 address of the device, in the form of address[/prefix length] - for example, 3ffe:ffff:0:1::1/128 . If prefix is omitted, 64 will be used. You can also use auto for automatic configuration, or dhcp for DHCPv6-only configuration (no router advertisements).

--gateway=

Default gateway as a single IPv4 address.

--ipv6gateway=

Default gateway as a single IPv6 address.

--nodefroute

Prevents the interface being set as the default route. Use this option when you activate additional devices with the --activate= option, for example, a NIC on a separate subnet for an iSCSI target.

--nameserver=

DNS name server, as an IP address. To specify more than one name server, use this parameter multiple times. For example:

network --bootproto=static --ip=10.0.2.15 --netmask=255.255.255.0 --gateway=10.0.2.254 --nameserver=192.168.2.1 --nameserver=192.168.3.1
--nodns

Do not configure any DNS server.

--netmask=

Network mask for the installed system.

--hostname=

Host name for the installed system. The host name can be either a fully-qualified domain name (FQDN) in the format hostname.domainname, or a short host name with no domain name. Many networks have a Dynamic Host Configuration Protocol (DHCP) service that automatically supplies connected systems with a domain name; to allow the DHCP service to assign the domain name to this machine, only specify the short host name.

--ethtool=

Specifies additional low-level settings for the network device which will be passed to the ethtool program.

--essid=

The network ID for wireless networks.

--wepkey=

The WEP encryption key for wireless networks.

--wpakey=

The WPA encryption key for wireless networks.

--onboot=

Whether or not to enable the device at boot time.

--dhcpclass=

The DHCP class.

--mtu=

The MTU of the device.

--noipv4

Disable IPv4 on this device.

--noipv6

Disable IPv6 on this device.

--bondslaves=

When this option is used, the network device specified in the --device= option will be created using slaves defined in the --bondslaves= option. For example:

network --device=mynetwork --bondslaves=em1,em2

The above command will create a bond device named mynetwork using the em1 and em2 interfaces as its slaves.

--bondopts=

A list of optional parameters for a bonded interface, which is specified using the --bondslaves= and --device= options. Options in this list must be separated by commas (",") or semicolons (";"). If an option itself contains a comma, use a semicolon to separate the options. For example:

network --bondopts=mode=active-backup,balance-rr;primary=eth1

Available optional parameters are listed in the Working with Kernel Modules chapter of the Fedora System Administrator’s Guide, available at https://docs.fedoraproject.org/.

The --bondopts=mode= parameter only supports full mode names such as balance-rr or broadcast, not their numerical representations such as 0 or 3.

--vlanid=

Specifies virtual LAN (VLAN) ID number (802.1q tag) for the device created using the device specified in --device= as a parent. For example, network --device=em1 --vlanid=171 will create a virtual LAN device em1.171.

--interfacename=

Specify a custom interface name for a virtual LAN device. This option should be used when the default name generated by the --vlanid= option is not desirable. This option must be used along with --vlanid=. For example:

network --device=em1 --vlanid=171 --interfacename=vlan171

The above command will create a virtual LAN interface named vlan171 on the em1 device with an ID of 171.

The interface name can be arbitrary (for example, my-vlan), but in specific cases, the following conventions must be followed:

  • If the name contains a dot (.), it must take the form of NAME.ID. The NAME is arbitrary, but the ID must be the VLAN ID. For example: em1.171 or my-vlan.171.

  • Names starting with vlan must take the form of vlanID - for example, vlan171.

--teamslaves=

Team device specified by the --device= option will be created using slaves specified in this option. Slaves are separated by commas. A slave can be followed by its configuration, which is a single-quoted JSON string with double quotes escaped by the \ character. For example:

network --teamslaves="p3p1'{\"prio\": -10, \"sticky\": true}',p3p2'{\"prio\": 100}'"

See also the --teamconfig= option.

--teamconfig=

Double-quoted team device configuration which is a single-quoted JSON string with double quotes escaped by the \ character. The device name is specified by --device= option and its slaves and their configuration by --teamslaves= option. For example:

network --device team0 --activate --bootproto static --ip=10.34.102.222 --netmask=255.255.255.0 --gateway=10.34.102.254 --nameserver=10.34.39.2 --teamslaves="p3p1'{\"prio\": -10, \"sticky\": true}',p3p2'{\"prio\": 100}'" --teamconfig="{\"runner\": {\"name\": \"activebackup\"}}"
--bridgeslaves=

When this option is used, the network bridge with device name specified using the --device= option will be created and devices defined in the --bridgeslaves= option will be added to the bridge. For example:

network --device=bridge0 --bridgeslaves=em1
--bridgeopts=

An optional comma-separated list of parameters for the bridged interface. Available values are stp, priority, forward-delay, hello-time, max-age, and ageing-time. For information about these parameters, see the bridge setting table in the nm-settings(5) man page or at https://developer.gnome.org/NetworkManager/0.9/ref-settings.html. Also see the Fedora Networking Guide, available at https://docs.fedoraproject.org/, for general information about network bridging.

Console and Environment

The following commands control the environment of the system after the installation finishes - language, keyboard layouts, or the graphical interface.

keyboard (opcional) - Configurar layouts de teclado

Sets one or more available keyboard layouts for the system.

keyboard --vckeymap= | --xlayouts= [--switch=]
--vckeymap=

Specify a VConsole keymap which should be used. Valid names correspond to the list of files in the /usr/lib/kbd/keymaps/* directory, without the .map.gz extension.

--xlayouts=

Specify a list of X layouts that should be used as a comma-separated list without spaces. Accepts values in the same format as setxkbmap(1), either in the layout format (such as cz), or in the layout (variant) format (such as cz (qwerty)).

All available layouts can be viewed on the xkeyboard-config(7) man page under Layouts.

--switch=

Specify a list of layout-switching options (shortcuts for switching between multiple keyboard layouts). Multiple options must be separated by commas without spaces. Accepts values in the same format as setxkbmap(1).

Available switching options can be viewed on the xkeyboard-config(7) man page under Options.

The following example sets up two keyboard layouts (English (US) and Czech (qwerty)) using the --xlayouts= option, and allows to switch between them using Alt+Shift:

keyboard --xlayouts=us,'cz (qwerty)' --switch=grp:alt_shift_toggle

lang (opcional) - Configurar idioma durante a instalação

Sets the language to use during installation and the default language to use on the installed system.

lang language [--addsupport=]

The file /usr/share/system-config-language/locale-list provides a list of the valid language codes in the first column of each line and is part of the system-config-language package.

Certain languages (for example, Chinese, Japanese, Korean, and Indic languages) are not supported during text-mode installation. If you specify one of these languages with the lang command and use text mode, the installation process will continue in English, but the installed system will use your selection as its default language.

--addsupport=

Add support for additional languages. Takes the form of comma-separated list without spaces. For example:

lang en_US --addsupport=cs_CZ,de_DE,en_UK

services (optional) - Configure Services

Modifies the default set of services that will run under the default systemd target. The list of disabled services is processed before the list of enabled services - therefore, if a service appears on both lists, it will be enabled.

services [--disabled=list] [--enabled=list]

Do not include spaces in the list of services. If you do, Kickstart will enable or disable only the services up to the first space. For example:

services --disabled=auditd, cups,smartd, nfslock

The above will disable only the auditd service. To disable all four services, the entry should include no spaces:

services --disabled=auditd,cups,smartd,nfslock
--disabled=

Disable the services given in the comma separated list.

--enabled=

Enable the services given in the comma separated list.

skipx (optional) - Do Not Configure X Window System

If present, X will not be configured on the installed system.

If you install a display manager among your package selection options, this package will create an X configuration, and the installed system will default to graphical.target. The effect of the skipx option will be overridden.

timezone (optional) - Configure Time Zone

Sets the system time zone to timezone. To view a list of available time zones, use the timedatectl list-timezones command.

Every option, including actually specifying a time zone, is optional starting with Fedora 25. This allows you to, for example, disable NTP from starting using --nontp without having to choose any time zone. However, if this command is present in the Kickstart file, at least one option must be used.

timezone [timezone] [options]
--utc

If present, the system assumes the hardware clock is set to UTC (Greenwich Mean) time.

--nontp

Disable the NTP service automatic starting.

--ntpservers=

Specify a list of NTP servers to be used as a comma-separated list without spaces.

xconfig (optional) - Configure X Window System

Configures the X Window System. If you install the X Window System with a Kickstart file that does not include the xconfig command, you must provide the X configuration manually during installation.

Do not use this command in a Kickstart file that does not install the X Window System.

--defaultdesktop=

Specify either GNOME or KDE to set the default desktop (assumes that GNOME Desktop Environment and/or KDE Desktop Environment has been installed in the %packages section).

--startxonboot

Use a graphical login on the installed system.

Users, Groups and Authentication

The commands below are used to control user accounts, groups, and related areas.

auth or authconfig (optional) - Configure Authentication (deprecated)

This command has been deprecated by authselect. Using it will invoke the authconfig compatibility tool; however, it is highly recommended to use authselect instead.

Sets up the authentication options for the system using the authconfig command, which can also be run on a command line after the installation finishes. See the authconfig(8) manual page and the authconfig --help command for more details. Passwords are shadowed by default.

authselect (optional) - Configure Authentication

This command sets up the authentication options for the system. This is just a wrapper around the authselect program, so all options recognized by that program are valid for this command. See the authselect(8) for a complete list. Passwords are shadowed by default.

group (optional) - Create User Group

Creates a new user group on the system. If a group with the given name or GID already exists, this command will fail. In addition, the user command can be used to create a new group for the newly created user.

group --name=name [--gid=gid]
--name=

Provides the name of the group.

--gid=

The group ID (GID). If not provided, defaults to the next available non-system GID.

pwpolicy (optional) - Change the Default Password Policy

This command can be used to set custom requirements (policy) such as length and strength for passwords set during the installation - the root password, user passwords and LUKS (disk encryption) password.

pwpolicy name [--minlen=length] [--minquality=quality] [--strict|nostrict] [--emptyok|noempty] [--changesok|nochanges]

The libpwquality library is used to check minimum password requirements (length and quality). You can use the pwscore and pwmake commands provided by the libpwquality package to check the quality score of your chosen password, or to create a random password with a given score. See the pwscore(1) and pwmake(1) man pages for details about these commands.

This command must be used inside the %anaconda section. See Kickstart_Syntax_Reference.adoc#sect-kickstart-commands-anaconda for details.

name

Name of the password entry. Supported values are root, user and luks for root password, user passwords and LUKS password, respectively.

--minlen=

Sets the minimum allowed password length. The default minimum length is 8.

--minquality=

Sets the minimum allowed password quality as defined by the libpwquality library. The default value is 50.

--strict

Strict password enforcement. Passwords not meeting the quality requirements specified in --minquality= will not be allowed. Enabled by default.

--notstrict

Passwords not meeting the minimum quality requirements specified in --minquality= will be allowed after Done is clicked twice.

--emptyok

Allow empty passwords. Enabled by default.

--notempty

Do not allow empty passwords.

--changesok

Allow changing the password in the user interface, even if the Kickstart file already specifies a password.

--nochanges

Do not allow changing passwords which are already set in the Kickstart file. Enabled by default.

An example use of the pwpolicy command is below:

%anaconda
pwpolicy root --minlen=10 --minquality=60 --strict --notempty --nochanges
%end

realm (optional) - Join an Active Directory or IPA Domain

Join an Active Directory or IPA domain. For more information about this command, see the join section of the realm(8) man page.

realm join domain [options]
--computer-ou=OU=

Provide the distinguished name of an organizational unit in order to create the computer account. The exact format of the distinguished name depends on the client software and membership software. The root DSE portion of the distinguished name can usually be left out.

--no-password

Join automatically without a password.

--one-time-password=

Join using a one-time password. This is not possible with all types of realm.

--client-software=

Only join realms which can run this client software. Valid values include sssd and winbind. Not all realms support all values. By default, the client software is chosen automatically.

--server-software=

Only join realms which can run this server software. Possible values include active-directory or freeipa.

--membership-software=

Use this software when joining the realm. Valid values include samba and adcli. Not all realms support all values. By default, the membership software is chosen automatically.

rootpw (required) - Set Root Password

Sets the system’s root password to the password argument.

rootpw [--iscrypted|--plaintext] [--lock] password
--iscrypted

If this option is present, the password argument is assumed to already be encrypted. This option is mutually exclusive with --plaintext. To create an encrypted password, you can use Python:

$ python -c 'import crypt; print(crypt.crypt("My Password", "$6$My Salt"))'

This will generate a SHA512 crypt of your password using your provided salt.

--plaintext

If this option is present, the password argument is assumed to be in plain text. This option is mutually exclusive with --iscrypted.

--lock

If this option is present, the root account is locked by default. This means that the root user will not be able to log in from the console.

selinux (optional) - Configure SELinux

Sets the state of SELinux on the installed system. The default policy is enforcing. For more information regarding SELinux in Fedora, see the Fedora SELinux User’s and Administrator’s Guide, available at https://docs.fedoraproject.org/.

selinux [--disabled|--enforcing|--permissive]
--enforcing

Enables SELinux with the default targeted policy being enforcing.

--permissive

Enables SELinux with the default targeted policy being permissive. This policy outputs warnings based on the SELinux policy, but does not actually enforce the policy.

--disabled

Disables SELinux completely.

sshkey (optional) - Add an Authorized SSH Key

Use this command to add a specified SSH key to an user’s authorized_keys file. The specified user must either be root, or it must be created in the Kickstart file - either automatically by an installed package, or using Kickstart_Syntax_Reference.adoc#sect-kickstart-commands-user.

sshkey --username=user "ssh_key"

The ssh_key must be a full SSH key fingerprint, and it must be enclosed in quotes ("") because the key may contain spaces.

--username=

The name of the user account to which you want to install the SSH key.

user (optional) - Create User Account

Creates a new user on the system.

user --name=username [options]
--name=

Provides the name of the user. This option is required.

--gecos=

Provides the GECOS information for the user. This is a string of various system-specific fields separated by a comma. It is frequently used to specify the user’s full name, office number, etc. See the passwd(5) man page for more details.

--groups=

In addition to the default group, a comma separated list of group names the user should belong to. The groups must exist before the user account is created. See Kickstart_Syntax_Reference.adoc#sect-kickstart-commands-group.

--homedir=

The home directory for the user. If not provided, this defaults to /home/username.

--lock

If this option is present, this account is locked by default. This means that the user will not be able to log in from the console.

--password=

The new user’s password. If no password is provided, the account will be locked.

--iscrypted

If this option is present, the password argument is assumed to already be encrypted. This option is mutually exclusive with --plaintext. To create an encrypted password, you can use Python:

$ python -c 'import crypt; print(crypt.crypt("My Password", "$6$My Salt"))'

This will generate a SHA512 crypt of your password using your provided salt.

--plaintext

If this option is present, the password argument is assumed to be in plain text. This option is mutually exclusive with --iscrypted.

--shell=

The user’s login shell. If not provided, the system default will be used.

--uid=

The UID (User ID). If not provided, this defaults to the next available non-system UID.

--gid=

The GID (Group ID) to be used for the user’s default group. If not provided, this defaults to the next available non-system group ID.

Installation Environment

The following commands control how the system will behave during the installation.

autostep (optional) - Go Through Every Screen

Normally, Kickstart installations skip unnecessary screens. This option makes the installation program step through every screen, displaying each briefly. This option should not be used when deploying a system because it may disrupt package installation.

autostep [--autoscreenshot]
--autoscreenshot

Take a screenshot at every step during installation. These screenshots are stored in /tmp/anaconda-screenshots during the installation, and after the installation finishes you can find them in /root/anaconda-screenshots.

Each screen is only captured right before the installer switches to the next one. This is important, because if you do not use all required Kickstart options and the installation therefore does not begin automatically, you can go to the screens which were not automatically configured, perform any configuration you want. Then, when you press Done to continue, the screen will be captured including the configuration you just provided.

cmdline (optional) - Perform Installation in Command Line Mode

Perform the installation in a completely non-interactive command line mode. Any prompts for interaction halts the install. This mode is useful on IBM System z systems with the x3270 terminal.

For a fully automatic installation, you must either specify one of the available modes (graphical, text, or cmdline) in the Kickstart file, or you must use the console= boot option as described in Console, Environment and Display Options. Otherwise the system will halt and ask you to choose a mode.

graphical (optional) - Perform Installation in Graphical Mode

Perform the installation in graphical mode. This is the default. This command takes no options.

For a fully automatic installation, you must either specify one of the available modes (graphical, text, or cmdline) in the Kickstart file, or you must use the console= boot option as described in Console, Environment and Display Options. Otherwise the system will halt and ask you to choose a mode.

logging (optional) - Configure Error Logging During Installation

Controls the error logging of Anaconda during installation. It has no effect on the installed system.

logging [--host= | --port= | --level=]
--host=

Send logging information to the given remote host, which must be running a syslogd process configured to accept remote logging.

--port=

If the remote syslogd process uses a port other than the default, it may be specified with this option.

--level=

Specify the minimum level of messages that appear on virtual console 3 (tty3). This only affects messages printed to the console; log files will contain messages of all levels. Possible values are debug, info, warning, error, or critical.

rescue (optional) - Rescue Mode

Automatically enters the installation program’s rescue mode. This gives you a chance to repair the system in case of any problems.

rescue [--nomount|--romount]
--nomount or --romount

Controls how the installed system is mounted in the rescue environment. By default, the installation program will find your system and mount it in read-write mode, telling you where it has performed this mount. You may optionally choose to not mount anything (the --nomount option) or mount in read-only mode (the --romount option). Only one of these two options may be used.

sshpw (opcional) - Restringir o acesso ssh durante a instalação

During the installation, you can interact with the installation program and monitor its progress over an SSH connection. Use the sshpw command to create temporary accounts through which to log on. Each instance of the command creates a separate account that exists only in the installation environment. These accounts are not transferred to the installed system.

sshpw --username=name password [--iscrypted|--plaintext] [--lock]

By default, the ssh server is not started during the installation. To make ssh available during the installation, boot the system with the kernel boot option inst.sshd. See Console, Environment and Display Options for details.

If you want to disable root ssh access to your hardware during installation, use the following:

sshpw --username=root --lock
--username

Provides the name of the user. This option is required.

--iscrypted

If this option is present, the password argument is assumed to already be encrypted. This option is mutually exclusive with --plaintext. To create an encrypted password, you can use Python:

$ python -c 'import crypt; print(crypt.crypt("My Password", "$6$My Salt"))'

This will generate a SHA512 crypt of your password using your provided salt.

--plaintext

If this option is present, the password argument is assumed to be in plain text. This option is mutually exclusive with --iscrypted

--lock

If this option is present, this account is locked by default. This means that the user will not be able to log in from the console.

text (optional) - Perform Installation in Text Mode

Perform the Kickstart installation in text mode. Kickstart installations are performed in graphical mode by default.

For a fully automatic installation, you must either specify one of the available modes (graphical, text, or cmdline) in the Kickstart file, or you must use the console= boot option as described in Console, Environment and Display Options. Otherwise the system will halt and ask you to choose a mode.

unsupported_hardware (optional) - Suppress Unsupported Hardware Alerts

Suppress the Unsupported Hardware Detected alert. If this command is not included and unsupported hardware is detected, the installation will stall at this alert.

vnc (optional) - Configure VNC Access

Allows the graphical installation to be viewed remotely via VNC. This method is usually preferred over text mode, as there are some size and language limitations in text installations. With no additional options, this command will start a VNC server on the installation system with no password and will display the details required to connect to it.

vnc [--host=hostname] [--port=port] [--password=password]

For more information about VNC installations, including instructions on how to connect to the installation system, see Installing Using VNC.

--host=

Connect to a VNC viewer listening on the given hostname.

--port=

Provide a port that the remote VNC viewer process is listening on. If not provided, the VNC default (5900) will be used.

--password=

Set a password which must be provided to connect to the VNC session. This is optional, but recommended.

Após a instalação

This section contains commands which control the system’s behavior immediately after the installation finishes.

%addon com_redhat_kdump (opcional) - Configurar kdump

This command configures the kdump kernel crash dumping mechanism.

The syntax for this command is unusual because it is an add-on rather than a built-in Kickstart command. For more information about add-ons, see Kickstart_Syntax_Reference.adoc#sect-kickstart-commands-addon.

Kdump is a kernel crash dumping mechanism that allows you to save the contents of the system’s memory for later analysis. It relies on kexec, which can be used to start a Linux kernel from the context of another kernel without rebooting the system and preserve the contents of the first kernel memory that would otherwise be lost.

In case of a system crash, kexec starts a second kernel (a capture kernel). This capture kernel resides in a reserved part of the system memory that is inaccessible to the main kernel. Kdump then captures the contents of the crashed kernel’s memory (a crash dump) and saves it to a specified location. This location can not be configured using Kickstart; it must be specified after the installation by editing the /etc/kdump.conf configuration file.

Available options are:

--enable

Enable Kdump on the installed system.

--disable

Do not enable Kdump on the installed system.

--reserve-mb=

The amount of memory you want to reserve for Kdump in megabytes. For example:

%addon com_redhat_kdump --enable --reserve-mb=128
%end

You can also specify auto instead of a numeric value. In that case the installer will determine the amount of RAM to reserve for kdump automatically, based on your system architecture and the total amount of memory on the system.

If you enable Kdump and do not specify the --reserve-mb= option, the auto value will be used.

--enablefadump

Enable firmware-assisted dumping on systems which allow it (notably IBM Power Systems servers).

firstboot (optional) - Enable or Disable Initial Setup

Determine whether the Initial Setup application starts the first time the system is booted. If enabled, the initial-setup package must be installed. If not specified, this option is disabled by default. For more information about Initial Setup, see Initial Setup.

firstboot --enable|--disable [--reconfig]
--enable or --enabled

Initial Setup will be started the first time the installed system boots.

--disable or --disabled

Initial Setup will be disabled.

--reconfig

Initial Setup will start after the reboot in reconfiguration mode. This mode enables the language, mouse, keyboard, root password, security level, time zone and networking configuration options in addition to the default ones.

halt (optional) - Halt System After Installation

Halt the system after the installation has successfully completed. This is similar to a manual installation, where after the installation finishes, the installer displays a message and waits for the user to press a key before rebooting. During a Kickstart installation, if no completion method is specified, this option is used as the default.

For other completion methods, see the poweroff, reboot, and shutdown commands.

poweroff (optional) - Power Off After Installation

Shut down and power off the system after the installation has successfully completed.

The poweroff command is highly dependent on the system hardware in use. Specifically, certain hardware components such as the BIOS, APM (advanced power management), and ACPI (advanced configuration and power interface) must be able to interact with the system kernel. Consult your hardware documentation for more information on you system’s APM/ACPI abilities.

For other completion methods, see the halt, reboot, and shutdown Kickstart commands.

reboot (optional) - Reboot After Installation

Reboot after the installation is successfully completed. If you are installing Fedora on IBM System z in command line mode (using Kickstart_Syntax_Reference.adoc#sect-kickstart-commands-cmdline), this command is necessary for a fully automated installation.

For other completion methods, see the halt, poweroff, and shutdown Kickstart options.

Use of the reboot command may result in an endless installation loop, depending on the installation media and method.

--eject

Attempt to eject the installation media (if installing from a DVD) before rebooting.

--kexec

Use this option to reboot into the new system using the kexec kernel switching mechanism instead of a full reboot, bypassing the BIOS/Firmware and boot loader.

shutdown (optional) - Shut Down After Installation

Shut down the system after the installation has successfully completed.

For other completion methods, see the halt, poweroff, and reboot Kickstart options.

%addon (optional) - Include an Anaconda Add-on

You can expand the basic Anaconda and Kickstart functionality by using custom add-ons specified using the %addon section.

To use an add-on in your Kickstart file, add the %addon addon_name options command. The section must be closed with an %end statement. For example, to use the Kdump add-on, which is included by default on some installations, use the following block:

%addon com_redhat_kdump --enable --reserve-mb=128%end

The %addon section does not have any options of its own; all options depend on the add-on being used.

For more information about Anaconda add-ons, see the Fedora Anaconda Addon Development Guide.

%anaconda (optional) - Additional Anaconda Configuration

This section, introduced in Fedora 22, is used to specify additional configuration options for the installer. Commands inside this section only control the behavior during installation, not on the installed system. The only command currently available inside this section is Kickstart_Syntax_Reference.adoc#sect-kickstart-commands-pwpolicy. The %anaconda section must end with %end.

In interactive installations (using the graphical or text interface), the /usr/share/anaconda/interactive-defaults.ks file contains the default %anaconda section. To change the defaults, you must create a product.img file with a Kickstart file replacing the default one, and pass this file to Anaconda using a boot option.

When using a Kickstart file, you can override the default %anaconda section by using the section again in your custom Kickstart.

%include (optional) - Include Contents of Another File

Use the %include /path/to/file command to include the contents of another file in the Kickstart file as though the contents were at the location of the %include command in the Kickstart file.

%ksappend (optional) - Append Contents of Another File

The %ksappend url directive is very similar to Kickstart_Syntax_Reference.adoc#sect-kickstart-commands-include in that it is used to include the contents of additional files as though they were at the location of the %ksappend command. The difference is in when the two directives are processed.

%ksappend is processed in an initial pass, before any other part of the Kickstart file. Then, this expanded Kickstart file is passed to the rest of Anaconda where all %pre scripts are handled, and then finally the rest of the Kickstart file is processed in order, which includes %include directives.

Therefore, %ksappend provides a way to include a file containing %pre scripts, while %include does not.

%packages (obrigatório) - Seleção de pacotes

Use the %packages command to begin a Kickstart section which describes the software packages to be installed. This section must end with an %end statement.

You can specify packages by environment, group, or by their package names. Several environments and groups that contain related packages are defined. See the repodata/comps.xml file in your installation source for environment and group definitions.

The comps.xml file contains a structure describing available environments (marked by the <environment> tag) and groups (the <group> tag). Each entry has an ID, user visibility value, name, description, and package list. If the group is selected for installation, the packages marked mandatory in the package list are always installed, the packages marked default are installed if they are not specifically excluded, and the packages marked optional must be specifically included even when the group is selected.

You can specify a package group or environment using either its ID (the <id> tag) or name (the <name> tag).

To install a 32-bit package on a 64-bit system, you will need to append the package name with the 32-bit architecture for which the package was built - for example, glibc.i686. The --multilib option also must be specified in the Kickstart file; see the available options below.

Initial Setup does not run after a system is installed from a Kickstart file unless a desktop environment and the X Window System were included in the installation and graphical login was enabled. This means that by default, no users except for root will be created. You can either create a user with the user option in the Kickstart file before installing additional systems from it (see Kickstart_Syntax_Reference.adoc#sect-kickstart-commands-user for details) or log into the installed system with a virtual console as root and add users with the useradd command.

Specifying Environments, Groups and Packages
Specifying an Environment

In addition to groups, you specify an entire environment to be installed:

%packages
@^Infrastructure Server
%end

This command will install all packages which are part of the Infrastracture Server environment. All available environments are described in the comps.xml file.

Specifying Groups

Specify groups, one entry to a line, starting with an @ symbol, and then the full group name or group id as given in the comps.xml file. For example:

%packages
@X Window System
@Desktop
@Sound and Video
%end

The Core and Base groups are always selected - it is not necessary to specify them in the %packages section.

The comps.xml file also defines groups called Conflicts (variant) for each variant of Fedora. This group contains all packages which are known to cause file conflicts, and is intended to be excluded.

Specifying Individual Packages

Specify individual packages by name, one entry to a line. You can use the asterisk character (*) as a wildcard in package names. For example:

%packages
sqlite
curl
aspell
docbook*
%end

The docbook* entry includes the packages docbook-dtds, docbook-simple, docbook-slides and others that match the pattern represented with the wildcard.

Excluding Environments, Groups, or Packages

Use a leading dash (-) to specify packages or groups to exclude from the installation. For example:

%packages
-@Graphical Internet
-autofs
-ipa*fonts
%end

Installing all available packages using only * in a Kickstart file is not supported, even if you exclude the @Conflicts (variant) group.

You can change the default behavior of the %packages section by using several options. Some options work for the entire package selection, others are used with only specific groups.

Common Package Selection Options

The following options are available for the %packages. To use an option, append it to the start of the package selection section. For example:

%packages --multilib --ignoremissing
--nocore

Do not install the @Core group.

--ignoremissing

Ignore any packages, groups and environments missing in the installation source, instead of halting the installation to ask if the installation should be aborted or continued.

--excludedocs

Do not install any documentation contained within packages. In most cases, this will exclude any files normally installed in the /usr/share/doc* directory, but the specific files to be excluded depend on individual packages.

--multilib

Configure the installed system for multilib packages (that is, to allow installing 32-bit packages on a 64-bit system) and install packages specified in this section as such.

Normally, on a 64-bit system, only packages for this architecture (marked as x86_64) and packages for all architectures (marked as noarch) would be installed. When you use this option, packages for 32-bit systems (marked as i686) will be automatically installed as well, if available.

This only applies to packages explicitly specified in the %packages section. Packages which are only being installed as dependencies without being specified in the Kickstart file will only be installed in architecture versions in which they are needed, even if they are available for more architectures.

Options for Specific Package Groups

The options in this list only apply to a single package group. Instead of using them at the %packages command in the Kickstart file, append them to the group name. For example:

%packages
@Graphical Internet --optional
%end
--nodefaults

Only install the group’s mandatory packages, not the default selections.

--optional

Install packages marked as optional in the group definition in the comps.xml file, in addition to installing the default selections.

Note that some package groups, such as Scientific Support, do not have any mandatory or default packages specified - only optional packages. In this case the --optional option must always be used, otherwise no packages from this group will be installed.

%pre (opcional) - Script de pré-instalação

You can add commands to run on the system immediately after the Kickstart file has been parsed, but before the installation begins. This section must be placed towards the end of the Kickstart file, after the actual Kickstart commands, and must start with %pre and end with %end. If your Kickstart file also includes a %post section, the order in which the %pre and %post sections are included does not matter.

You can access the network in the %pre section. However, the name service has not been configured at this point, so only IP addresses work, not URLs.

The pre-installation script section of Kickstart cannot manage multiple install trees or source media. This information must be included for each created Kickstart file, as the pre-installation script occurs during the second stage of the installation process.

Unlike the post-installation script, the pre-installation script is not run in the chroot environment.

The following options can be used to change the behavior of pre-installation scripts. To use an option, append it to the %pre line at the beginning of the script. For example:

%pre --interpreter=/usr/bin/python
--- Python script omitted --
%end
--interpreter=

Allows you to specify a different scripting language, such as Python. Any scripting language available on the system can be used; in most cases, these will be /usr/bin/sh, /usr/bin/bash, and /usr/bin/python.

--erroronfail

Display an error and halt the installation if the script fails. The error message will direct you to where the cause of the failure is logged.

--log=

Logs the script’s output into the specified log file. For example:

%pre --log=/mnt/sysimage/root/ks-pre.log

For an example of a pre-installation script, see Kickstart_Syntax_Reference.adoc#sect-kickstart-example-pre-script.

%post (opcional) - Script de pós-instalação

You have the option of adding commands to run on the system once the installation is complete, but before the system is rebooted for the first time. This section must be placed towards the end of the Kickstart file, after the actual Kickstart commands, and must start with %post and end with %end. If your Kickstart file also includes a %pre section, the order of the %pre and %post sections does not matter.

This section is useful for functions such as installing additional software or configuring an additional name server. The post-install script is run in a chroot environment, therefore, performing tasks such as copying scripts or RPM packages from the installation media do not work by default. You can change this behavior using the --nochroot option as described below.

If you configured the network with static IP information, including a name server, you can access the network and resolve IP addresses in the %post section. If you configured the network for DHCP, the /etc/resolv.conf file has not been completed when the installation executes the %post section. You can access the network, but you cannot resolve IP addresses. Thus, if you are using DHCP, you must specify IP addresses in the %post section.

The following options can be used to change the behavior of post-installation scripts. To use an option, append it to the %post line at the beginning of the script. For example:

%post --interpreter=/usr/bin/python
--- Python script omitted --
%end
--interpreter=

Allows you to specify a different scripting language, such as Python. For example:

%post --interpreter=/usr/bin/python

Any scripting language available on the system can be used; in most cases, these will be /usr/bin/sh, /usr/bin/bash, and /usr/bin/python.

--nochroot

Allows you to specify commands that you would like to run outside of the chroot environment.

The following example copies the file /etc/resolv.conf to the file system that was just installed.

%post --nochroot
cp /etc/resolv.conf /mnt/sysimage/etc/resolv.conf
%end
--erroronfail

Display an error and halt the installation if the script fails. The error message will direct you to where the cause of the failure is logged.

--log=

Logs the script’s output into the specified log file. Note that the path of the log file must take into account whether or not you use the --nochroot option. For example, without --nochroot:

%post --log=/root/ks-post.log

with --nochroot:

%post --nochroot --log=/mnt/sysimage/root/ks-post.log

For an example of a post-installation script, see Kickstart_Syntax_Reference.adoc#sect-kickstart-example-post-script.

Example Kickstart Configurations

Exemplo avançado de particionamento

The following is an integrated example showing the clearpart, zerombr, part, raid, volgroup, and logvol Kickstart options in action:

Example 3. Exemplo avançado de particionamento
clearpart  --drives=hda,hdc
zerombr
# Raid 1 IDE config
part raid.11 --size 1000  --asprimary --ondrive=hda
part raid.12 --size 1000  --asprimary --ondrive=hda
part raid.13 --size 2000  --asprimary --ondrive=hda
part raid.14 --size 8000              --ondrive=hda
part raid.15 --size 16384 --grow      --ondrive=hda
part raid.21 --size 1000  --asprimary --ondrive=hdc
part raid.22 --size 1000  --asprimary --ondrive=hdc
part raid.23 --size 2000  --asprimary --ondrive=hdc
part raid.24 --size 8000              --ondrive=hdc
part raid.25 --size 16384 --grow      --ondrive=hdc

# You can add --spares=x
raid /     --fstype xfs  --device root  --level=RAID1 raid.11 raid.21
raid /safe --fstype xfs  --device safe  --level=RAID1 raid.12 raid.22
raid swap  --fstype swap --device swap  --level=RAID1 raid.13 raid.23
raid /usr  --fstype xfs  --device usr   --level=RAID1 raid.14 raid.24
raid pv.01 --fstype xfs  --device pv.01 --level=RAID1 raid.15 raid.25

# LVM configuration so that we can resize /var and /usr/local later
volgroup sysvg pv.01
logvol /var           --vgname=sysvg --size=8000     --name=var
logvol /var/freespace --vgname=sysvg --size=8000     --name=freespacetouse
logvol /usr/local     --vgname=sysvg --size=1 --grow --name=usrlocal

This advanced example implements LVM over RAID, as well as the ability to resize various directories for future growth.

First, the clearpart command is used on drives hda and hdc to wipe them. The zerombr command initializes unused partition tables.

Then, the two drives are partitioned to prepare them for RAID configuration. Each drive is divided into five partitions, and each drive is partitioned into an identical layout.

The next part uses these pairs of physical partitions to create a software RAID device with RAID1 level (mirroring). The first four RAID devices are used for / (root), /safe, swap and /usr. The fifth, largest pair of partitions is named pv.01 and will be used in the following part as a physical volume for LVM.

Finally, the last set of commands first creates a volume group named sysvg on the pv.01 physical volume. Then, three logical volumes (/var, /var/freespace and /usr/local) are created and added to the sysvg volume group. The /var and /var/freespace volumes have a set size of 8 GB, and the /usr/local volume uses the --grow option to fill all remaining available space.

The above example uses identifiers hda and hdc to identify disk drives. You should use unique identifiers, such as a disk labels or an UUIDs, to identify disk drives. See the note in introduction to this appendix.

Example Pre-installation Script

The following is an example %pre section:

Example 4. Sample %pre Script
%pre
#!/bin/sh
hds=""
mymedia=""
for file in /proc/ide/h* do
mymedia=`cat $file/media`
if [ $mymedia == "disk" ] ; then
hds="$hds `basename $file`"
fi
done
set $hds
numhd=`echo $#`
drive1=`echo $hds | cut -d' ' -f1`
drive2=`echo $hds | cut -d' ' -f2`

#Write out partition scheme based on whether there are 1 or 2 hard drives
if [ $numhd == "2" ] ; then
#2 drives
echo "#partitioning scheme generated in %pre for 2 drives" > /tmp/part-include
echo "clearpart --all" >> /tmp/part-include
echo "part /boot --fstype xfs --size 75 --ondisk hda" >> /tmp/part-include
echo "part / --fstype xfs --size 1 --grow --ondisk hda" >> /tmp/part-include
echo "part swap --recommended --ondisk $drive1" >> /tmp/part-include
echo "part /home --fstype xfs --size 1 --grow --ondisk hdb" >> /tmp/part-include
else
#1 drive
echo "#partitioning scheme generated in %pre for 1 drive" > /tmp/part-include
echo "clearpart --all" >> /tmp/part-include
echo "part /boot --fstype xfs --size 75" >> /tmp/part-include
echo "part swap --recommended" >> /tmp/part-include
echo "part / --fstype xfs --size 2048" >> /tmp/part-include
echo "part /home --fstype xfs --size 2048 --grow" >> /tmp/part-include
fi
%end

This script determines the number of hard drives in the system and writes a text file with a different partitioning scheme depending on whether it has one or two drives. Instead of having a set of partitioning commands in the Kickstart file, include the following line:

%include /tmp/part-include

The partitioning commands selected in the script will be used.

Exemplo de script pós-instalação

The following is an example %post section:

Example 5. Sample %post Script
# Start of the %post section with logging into /root/ks-post.log
%post --log=/root/ks-post.log

# Monta um compartilhamento NFS
mkdir /mnt/temp
mount -o nolock 10.10.0.2:/usr/new-machines /mnt/temp
openvt -s -w -- /mnt/temp/runme
umount /mnt/temp

# Fim da seção %post
%end

The above example mounts an NFS share and executes a script named runme located at /usr/new-machines/ on the share. Note that NFS file locking is not supported while in Kickstart mode, therefore the -o nolock option is required.