Capítulo 20 Instalação, inicialização, parada, desinstalação e clonagem de regiões não globais (tarefas)

Este capítulo descreve como instalar e inicializar uma região não global. É também fornecido um método para uso da clonagem para instalar uma região no mesmo sistema. Também são tratadas outras tarefas associadas à instalação, como parada, reinicialização e desinstalação de regiões. É também fornecido o procedimento para excluir uma região completamente de um sistema.

Para obter informações gerais sobre instalação de região e operações relacionadas, consulte o Capítulo 19Sobre instalação, parada, clonagem e desinstalação de regiões não globais (visão geral).

Para obter informações sobre instalação de regiões com marca lx, consulte o Capítulo 34Sobre instalação, inicialização, parada, clonagem e desinstalação de regiões com marca lx (visão geral) e o Capítulo 35Instalação, inicialização, parada, desinstalação e clonagem de regiões com marca lx (tarefas).

Instalação de região (mapa de tarefas)

Instalação e inicialização de regiões

Use o comando zoneadm descrito na página do manual zoneadm(1M) para executar tarefas de instalação para uma região não global. Você deve ser o administrador global para executar a instalação da região. Os exemplos neste capítulo usam o nome da região e o caminho da região estabelecido em Configuração, verificação e comprometimento de uma região.

(Opcional) Como verificar uma região configurada antes da instalação

Você pode verificar uma região antes de instalá-la. Se ignorar este procedimento, a verificação será executada automaticamente quando você instalar a região.

É necessário ser administrador global na região global para executar este procedimento.

1. Torne-se superusuário ou assuma a função de administrador principal.

   Para criar a função e atribuí-la a um usuário, consulte Using the Solaris Management Tools With RBAC (Task Map) no System Administration Guide: Basic Administration .

2. Verifique uma região configurada nomeada my-zone usando a opção -z com o nome da região e o subcomando verify.

   global# zoneadm -z my-zone verify

   Esta mensagem referente à verificação do caminho da região será exibida:

   Warning: /export/home/my-zone does not exist, so it cannot be verified. When 'zoneadm install' is run, 'install' will try to create /export/home1/my-zone, and 'verify' will be tried again, but the 'verify' may fail if: the parent directory of /export/home/my-zone is group- or other-writable or /export/home1/my-zone overlaps with any other installed zones.

   No entanto, se uma mensagem de erro for exibida e houver falha na verificação da região, faça as correções especificadas na mensagem e tente o comando novamente.

   Se nenhuma mensagem for exibida, você poderá instalar a região.

Como instalar uma região configurada

É necessário ser o administrador global na região global para executar este procedimento.

1. Torne-se superusuário ou assuma a função de administrador principal.

   Para criar a função e atribuí-la a um usuário, consulte Using the Solaris Management Tools With RBAC (Task Map) no System Administration Guide: Basic Administration .

2. Instale a região configurada my-zone usando o comando zoneadm com a opção -z install.

   global# zoneadm -z my-zone install

   Você verá várias mensagens enquanto os arquivos e os diretórios necessários para o sistema de arquivos raiz da região são instalados no caminho raiz da região.

3. (Opcional) Se uma mensagem de erro for exibida e houver falha na instalação da região, digite o que se segue para obter o estado da região:

   global# zoneadm -z my-zone list -v

   • Se o estado estiver listado como configurada, faça as correções especificadas na mensagem e tente o comando zoneadm install novamente.

   • Se o estado estiver listado como incompleta, primeiro execute este comando:

     global# zoneadm -z my-zone uninstall

     Em seguida faça as correções especificadas na mensagem e tente o comando zoneadm install novamente.

4. Quando a instalação estiver concluída, use o subcomando list com as opções -i e -v para listar as regiões instaladas e verificar o status.

   global# zoneadm list -iv

   Você verá uma exibição semelhante a esta:

   ID NAME STATUS PATH BRAND IP 0 global running / native shared - my-zone installed /export/home/my-zone native shared

Solução de problemas

Se a instalação de uma região falhar ou for interrompida, a região ficará no estado de incompleta. Use uninstall -F para redefinir a região como estado de configurada.

Passos Seguintes

Esta região foi instalada com a configuração de rede aberta descrita no Capítulo 19, Managing Services (Tasks), no System Administration Guide: Basic Administration por padrão. Você pode alternar para a configuração de rede aberta, ou ativar ou desativar serviços individuais, quando efetua login na região. Para obter detalhes, consulte Alternação da região não global para uma configuração de serviço de rede diferente.

Solaris 10 8/07: como obter o UUID de uma região global instalada

Um identificador exclusivo universalmente (UUID) é atribuído a uma região quando ela é instalada. O UUID pode ser obtido usando-se zoneadm com o subcomando list e a opção -p. O UUID é o quinto campo da exibição.

1. Visualize os UUIDs para regiões que foram instaladas.

   global# zoneadm list -p

   Você verá uma exibição semelhante a esta:

   0:global:running:/: 6:my-zone:running:/export/home/my-zone:61901255-35cf-40d6-d501-f37dc84eb504

Exemplo 20–1 Como usar o UUID em um comando

global# zoneadm -z my-zone -u 61901255-35cf-40d6-d501-f37dc84eb504 list -v

Se -u uuid-match e - z zonename estiverem presentes, a correspondência será feita com base no primeiro UUID. Se uma região com o UUID especificado for encontrada, essa região será usada e o parâmetro -z será ignorado. Se nenhuma região com o UUID especificado for encontrada, o sistema procurará pelo nome da região.

Sobre o UUID

Regiões podem ser desinstaladas e reinstaladas com o mesmo nome com diferentes conteúdos. Regiões podem também ser renomeadas sem alteração do conteúdo. Por estas razões, o UUID é um manipulador mais confiável do que o nome da região.

Consulte também

Para mais informações, consulte zoneadm(1M) e libuuid(3LIB).

Solaris 10 8/07: como marcar uma região não global instalada incompleta

Se alterações administrativas no sistema tornaram uma região inutilizável ou inconsistente, é possível alterar o estado de uma região instalada para incompleta.

É necessário ser administrador global na região global para executar este procedimento.

1. Torne-se superusuário ou assuma a função de administrador principal.

   Para criar a função e atribuí-la a um usuário, consulte Using the Solaris Management Tools With RBAC (Task Map) no System Administration Guide: Basic Administration .

2. Marque a região testzone incompleta.

   global# zoneadm -z testzone mark incomplete

3. Use o subcomando list com as opções -i e - v para verificar o status.

   global# zoneadm list -iv

   Você verá uma exibição semelhante a esta:

   ID NAME STATUS PATH BRAND IP 0 global running / native shared - my-zone installed /export/home/my-zone native shared - testzone incomplete /export/home/testzone native shared

Marcação de uma região incompleta

A opção -R root pode ser usada com os subcomandos mark e list de zoneadm para especificar um, ambiente de inicialização alternativo. Para obter mais informações, consulte zoneadm(1M).

A marcação de uma região incompleta é irreversível. A única ação que pode ser tomada em uma região marcada como incompleta é desinstalar a região e retorná-la ao estado de configurada. Consulte Como desinstalar uma região.

(Opcional) Como fazer a transição da região instalada para o estado de preparada

A transição para o estado de preparada prepara a plataforma virtual para iniciar a execução de processos de usuário. Regiões no estado de preparada não têm quaisquer processos de usuário em execução.

Você pode ignorar este procedimento, se desejar inicializar a região e usá-la imediatamente. A transição para o estado de preparada é executada automaticamente quando você inicializa a região.

É necessário ser administrador global na região global para executar este procedimento.

1. Torne-se superusuário ou assuma a função de administrador principal.

   Para criar a função e atribuí-la a um usuário, consulte Using the Solaris Management Tools With RBAC (Task Map) no System Administration Guide: Basic Administration .

2. Use o comando zoneadm com a opção -z, o nome da região, que é my-zone , e o subcomando ready para fazer a transição da região para o estado de preparada.

   global# zoneadm -z my-zone ready

3. No prompt, use o comando zoneadm list com a opção -v para verificar o status.

   global# zoneadm list -v

   Você verá uma exibição semelhante a esta:

   ID NAME STATUS PATH BRAND IP 0 global running / native shared 1 my-zone ready /export/home/my-zone native shared

   Observe que o ID exclusivo da região 1 foi atribuído pelo sistema.

Como inicializar uma região

A inicialização de uma região coloca a região no estado de execução. Uma região pode ser inicializada a partir do estado de preparada ou do estado de instalada. Uma região no estado de instalada que é inicializada transparentemente faz a transição do estado de preparada para o estado de execução. O login na região é permitido para regiões no estado de execução.

Observe que é necessário executar a configuração de região internada quando você efetuar login na região após inicializá-la pela primeira vez. Isto é descrito em Configuração de região interna.

Se você planeja usar um arquivo /etc/sysidcfg para executar configuração de região inicial, como descrito em Como usar um arquivo /etc/sysidcfg para executar a configuração de região inicial, crie o arquivo sysidcfg e coloque-o no diretório /etc da região antes de inicializar a região.

É necessário ser administrador global na região global para executar este procedimento.

1. Torne-se superusuário ou assuma a função de administrador principal.

   Para criar a função e atribuí-la a um usuário, consulte Using the Solaris Management Tools With RBAC (Task Map) no System Administration Guide: Basic Administration .

2. Use o comando zoneadm com a opção - z, o nome da região, que é my-zone, e o subcomando boot para iniciar a região.

   global# zoneadm -z my-zone boot

3. Quando a inicialização estiver concluída, use o subcomando list com a opção -v para verificar o status.

   global# zoneadm list -v

   Você verá uma exibição semelhante a esta:

   ID NAME STATUS PATH BRAND IP 0 global running / native shared 1 my-zone running /export/home/my-zone native shared

Exemplo 20–2 Especificação de argumentos de inicialização para regiões

Inicialize uma região usando a opção -m verbose:

global# zoneadm -z my-zone boot -- -m verbose

Reinicialize uma região usando a opção de inicialização -m verbose:

global# zoneadm -z my-zone reboot -- -m verbose

Reinicialize como administrador de região a região my-zone, usando a opção -m verbose:

my-zone# reboot -- -m verbose

Solução de problemas

Se for exibida uma mensagem indicando que o sistema não pôde encontrar a máscara de rede a ser usada para o endereço IP especificado na configuração da região, consulte Aviso de netmasks exibido na inicialização da região. Observe que a mensagem é somente um aviso e o comando teve êxito.

Como inicializar uma região no modo de usuário único

É necessário ser o administrador global na zona global para executar este procedimento.

1. Torne-se superusuário ou assuma a função de administrador principal.

   Para criar a função e atribuí-la a um usuário, consulte Using the Solaris Management Tools With RBAC (Task Map) no System Administration Guide: Basic Administration .

2. Inicialize a região no modo de usuário único.

   global# zoneadm -z my-zone boot -s

O que fazer a seguir

Para efetuar login na região e executar a configuração interna inicial, consulte o Capítulo 21Login na região não global (visão geral) e o Capítulo 22Login em regiões não globais (tarefas).

Parada, reinicialização, desinstalação, clonagem e exclusão de regiões não globais (mapa de tarefas)

Parada, reinicialização e desinstalação de regiões

Como parar uma região

O procedimento de parada é usado para remover o ambiente do aplicativo e a plataforma virtual de uma região. Para desligar corretamente uma região, consulte Como usar zlogin para desligar uma região.

É necessário ser administrador global na região global para executar este procedimento.

1. Torne-se superusuário ou assuma a função de administrador principal.

   Para criar a função e atribuí-la a um usuário, consulte Using the Solaris Management Tools With RBAC (Task Map) no System Administration Guide: Basic Administration .

2. Liste as regiões que estão em execução no sistema.

   global# zoneadm list -v

   Você verá uma exibição semelhante a esta:

   ID NAME STATUS PATH BRAND IP 0 global running / native shared 1 my-zone running /export/home/my-zone native shared

3. Use o comando zoneadm com a opção - z, o nome da região, por exemplo my-zone, e o subcomando halt para parar uma determinada região.

   global# zoneadm -z my-zone halt

4. Liste as regiões no sistema novamente para verificar se my-zone foi parado.

   global# zoneadm list -iv

   Você verá uma exibição semelhante a esta:

   ID NAME STATUS PATH BRAND IP 0 global running / native shared - my-zone installed /export/home/my-zone native shared

5. Inicialize a região, se desejar reiniciá-la.

   global# zoneadm -z my-zone boot

Solução de problemas

Se a operação de parada falhar, consulte A região não pára para obter dicas para solução de problemas.

Como reinicializar uma região

É necessário ser administrador global na região global para executar este procedimento.

1. Torne-se superusuário ou assuma a função de administrador principal.

   Para criar a função e atribuí-la a um usuário, consulte Using the Solaris Management Tools With RBAC (Task Map) no System Administration Guide: Basic Administration .

2. Liste as regiões que estão em execução no sistema.

   global# zoneadm list -v

   Você verá uma exibição semelhante a esta:

   ID NAME STATUS PATH BRAND IP 0 global running / native shared 1 my-zone running /export/home/my-zone native shared

3. Use o comando zoneadm com a opção - z reboot para reinicializar a região my-zone.

   global# zoneadm -z my-zone reboot

4. Liste as regiões no sistema novamente para verificar se my-zone foi reinicializado.

   global# zoneadm list -v

   Você verá uma exibição semelhante a esta:

   ID NAME STATUS PATH BRAND IP 0 global running / native shared 2 my-zone running /export/home/my-zone native shared

   ---

   Dica –

   Observe que o ID da região para my-zone foi alterado. O ID da região geralmente se altera após uma reinicialização.

   ---

Como desinstalar uma região

Use este procedimento com cuidado. A ação de remover todos os arquivos no sistema de arquivos raiz da região é irreversível.

A região não pode estar no estado de execução. A operação uninstall é inválida para regiões em execução.

É necessário ser administrador global na região global para executar este procedimento.

1. Torne-se superusuário ou assuma a função de administrador principal.

   Para criar a função e atribuí-la a um usuário, consulte Using the Solaris Management Tools With RBAC (Task Map) no System Administration Guide: Basic Administration .

2. Liste as regiões no sistema.

   global# zoneadm list -v

   Você verá uma exibição semelhante a esta:

   ID NAME STATUS PATH BRAND IP 0 global running / native shared - my-zone installed /export/home/my-zone native shared

3. Use o comando zoneadm com a opção - z uninstall para remover my-zone da região.

   Você pode também usar a opção -F para forçar a ação. Se esta opção não for especificada, o sistema solicitará confirmação.

   global# zoneadm -z my-zone uninstall -F

4. Liste as regiões no sistema novamente para verificar se my-zone não está mais listado.

   global# zoneadm list -v

   Você verá uma exibição semelhante a esta:

   ID NAME STATUS PATH BRAND IP 0 global running / native shared

Solução de problemas

Se a desinstalação de uma região for interrompida, a região ficará no estado de incompleta. Use o comando zoneadm uninstall para redefinir a região como estado de configurada.

Use o comando uninstall com cuidado, porque a ação é irreversível.

Solaris 10 11/06: clonagem de uma região não global no mesmo sistema

A clonagem é usada para fornecer uma nova região a um sistema copiando os dados de um zonepath de origem a um zonepath de destino.

A partir do Solaris 10 5/09, quando o zonepath de origem e o zonepath de destino residirem no ZFS e estiverem no mesmo grupo, o comando zoneadm clone usará automaticamente o ZFS para clonar a região. No entanto, você pode especificar que o zonepath ZFS seja copiado e não clonado ZFS.

Como clonar uma região

É necessário configurar a nova região antes de você poder instalá-la. O parâmetro passado para o subcomando zoneadm create é o nome da região a ser clonada. Esta região de origem deve ser parada.

É necessário ser administrador global na região global para executar este procedimento.

1. Torne-se superusuário ou assuma a função de administrador principal.

   Para criar a função e atribuí-la a um usuário, consulte Using the Solaris Management Tools With RBAC (Task Map) no System Administration Guide: Basic Administration .

2. Pare a região de origem a ser clonada, que é my-zone neste procedimento.

   global# zoneadm -z my-zone halt

3. Inicie a configuração da nova região exportando a configuração da região de origem my-zone para um arquivo, por exemplo, master .

   global# zonecfg -z my-zone export -f /export/zones/master

   ---

   Observação –

   Você pode também criar a nova região de configuração usando o procedimento Como configurar a região, em vez de modificar uma configuração existente. Se você usar este método, passe para a Etapa 6 após criar a região.

   ---

4. Edite o arquivo master. Defina propriedades e recursos diferentes para os componentes que não podem ser idênticos para regiões diferentes. Por exemplo, você deve definir um novo zonepath. Para uma região com IP compartilhado, os endereços IP em quaisquer recursos de rede devem ser alterados. Para uma região com IP exclusivo, a propriedade física de quaisquer recursos de rede deve ser alterada.

5. Crie a nova região, zone1, usando os comandos no arquivo master.

   global# zonecfg -z zone1 -f /export/zones/master

6. Instale a nova região, zone1, clonando my-zone.

   global# zoneadm -z zone1 clone my-zone

   O sistema exibe:

   Cloning zonepath /export/home/my-zone...

   A partir do Solaris 10 5/09, se o zonepath de origem estiver em um grupo ZFS, por exemplo, zeepool, o sistema exibirá:

   Cloning snapshot zeepool/zones/my-zone@SUNWzone1 Instead of copying, a ZFS clone has been created for this zone.

7. Liste as regiões no sistema.

   ID NAME STATUS PATH BRAND IP 0 global running / native shared - my-zone installed /export/home/my-zone native shared - zone1 installed /export/home/zone1 native shared

Solaris 10 5/09: Quando um zonepath de origem de um sistema de arquivos ZFS é clonado

Quando o comando zoneadm clona um zonepath de origem que está em seu próprio sistema de arquivos ZFS, as seguintes ações são executadas:

• O comando zoneadm toma um inventário de software.

• O comando zoneadm toma um instantâneo ZFS e o nomeia SUNWzoneX, por exemplo, SUNWzone1.

• O comando zoneadm usa clone ZFS para clonar o instantâneo.

Solaris 10 5/09: Como clonar uma região de um instantâneo existente

Você pode clonar uma região de origem várias vezes a partir de um instantâneo existente que foi originalmente tomado quando uma região foi clonada.

É necessário ser administrador global na região global para executar este procedimento.

1. Torne-se superusuário ou assuma a função de administrador principal.

   Para criar a função e atribuí-la a um usuário, consulte Using the Solaris Management Tools With RBAC (Task Map) no System Administration Guide: Basic Administration .

2. Configure a região zone2.

3. Especifique que um instantâneo existente seja usado para criar new-zone2 .

   global# zoneadm -z zone2 clone -s zeepool/zones/my-zone@SUNWzone1 my-zone

   O sistema exibe:

   Cloning snapshot zeepool/zones/my-zone@SUNWzone1

   O comando zoneadm valida o software a partir do instantâneo SUNWzone1 e clona o instantâneo.

4. Liste as regiões no sistema.

   ID NAME STATUS PATH BRAND IP 0 global running / native shared - my-zone installed /zeepool/zones/my-zone native shared - zone1 installed /zeepool/zones/zone1 native shared - zone2 installed /zeepool/zones/zone2 native shared

Solaris 10 5/09: Como usar cópia em vez de clone do ZFS

Use este procedimento para impedir a clonagem automática de uma região em um sistema de arquivos ZFS especificando que zonepath seja copiado.

É necessário ser administrador global na região global para executar este procedimento.

1. Torne-se superusuário ou assuma a função de administrador principal.

   Para criar a função e atribuí-la a um usuário, consulte Using the Solaris Management Tools With RBAC (Task Map) no System Administration Guide: Basic Administration .

2. Especifique que zonepath em ZFS seja copiado, e não clonado ZFS.

   global# zoneadm -z zone1 clone -m copy my-zone

Exclusão de uma região não global do sistema

O procedimento descrito nesta seção exclui completamente uma região de um sistema.

Como remover uma região não global

1. Desligue a região my-zone.

   global# zlogin my-zone shutdown -y -g0 -i0

2. Remova o sistema de arquivos raiz para my-zone.

   global# zoneadm -z my-zone uninstall -F

3. Exclua a configuração para my-zone.

   global# zonecfg -z my-zone delete -F

4. Liste as regiões no sistema novamente para verificar se my-zone não está mais listado.

   global# zoneadm list -iv

   Você verá uma exibição semelhante a esta:

   ID NAME STATUS PATH BRAND IP 0 global running / native shared