Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Gerencie pacotes, módulos e scripts YANG em dispositivos Junos

RESUMO Carregue pacotes YANG personalizados em dispositivos Junos para adicionar suas próprias chamadas de procedimento remoto (RPCs) e modelos de dados ao dispositivo.

Você pode carregar módulos YANG personalizados em dispositivos Junos para adicionar RPCs e modelos de dados que não são suportados nativamente pelo OS, mas podem ser suportados pela tradução. Quando você carrega modelos de dados YANG não nativos no dispositivo, você também deve carregar quaisquer scripts de tradução, scripts de ação e módulos de desvio exigidos por esses modelos de dados.

Nota:

A partir do Junos OS Release 17.3R1, quando você carrega modelos de dados YANG personalizados no dispositivo, você não precisa carregar explicitamente nenhum módulo de extensão Junos OS necessário. Em versões anteriores, você deve carregar os módulos de extensão do Junos OS para quaisquer pacotes que usem os módulos.

Os dispositivos Junos usam pacotes para identificar uma coleção de módulos YANG relacionados, scripts de tradução e scripts de ação. Cada pacote tem um identificador único. Ao adicionar módulos e scripts YANG ao dispositivo, você deve associá-los a um pacote novo ou existente. Este tópico discute como criar, atualizar e excluir pacotes YANG e adicionar ou atualizar seus módulos e scripts associados.

Nota:

Para evitar erros de banco de dados relacionados à CLI ou de configuração, recomendamos que você não realize nenhuma operação CLI, altere a configuração ou encerre a operação enquanto um dispositivo estiver em processo de adicionar, atualizar ou excluir um pacote YANG e modificar o esquema.

Criação de um pacote YANG e inclusão de módulos e scripts

Para validar módulos e scripts YANG e adicioná-los a um novo pacote:

  1. Baixe os módulos YANG e quaisquer scripts necessários para qualquer diretório no dispositivo.
  2. Certifique-se de que quaisquer scripts de ação python não assinados sejam de propriedade de um root ou de um usuário na classe de login do Junos OS super-user e que apenas o proprietário do arquivo tenha permissão de gravação para o arquivo.
    Nota:

    Os usuários só podem executar scripts python não assinados em dispositivos Junos quando as permissões de arquivo do script incluem a permissão de leitura para a primeira classe em que o usuário se encaixa, na ordem do usuário, do grupo ou de outros.

  3. (Opcional) Valide a sintaxe dos módulos e scripts.
  4. Crie um pacote YANG com um identificador exclusivo e especifique os caminhos de arquivo para os módulos e scripts que fazem parte desse pacote, bem como para quaisquer módulos de desvio que identifiquem desvios para os módulos nesse pacote.
    Nota:

    Você pode especificar o caminho absoluto ou relativo a um único arquivo, ou pode adicionar vários arquivos especificando uma lista de caminhos de arquivo delimitados em espaço em parênteses.

    Nota:

    Para instalar módulos OpenConfig que são embalados como um arquivo de piche comprimido, use o request system software add comando. Os módulos e scripts do OpenConfig instalados pela emissão do request system software add comando estão sempre associados ao identificador openconfigde pacotes.

    Nota:

    A partir do Junos OS Release 18.3R1, adicionar, excluir ou atualizar pacotes YANG no modo de configuração com o run comando não é suportado.

  5. Quando o sistema solicita que você reinicie o Junos OS CLI, pressione Enter para aceitar o valor padrão de yes.
  6. Verifique se o pacote foi criado e contém os módulos e scripts corretos.
  7. Se o pacote incluir scripts de tradução ou scripts de ação escritos em Python, permita que o dispositivo execute scripts python não assinados configurando a declaração ou language python3 a language python declaração, conforme apropriado para a versão do Junos OS.
    Nota:

    A partir do Junos OS Release 20.2R1 e Junos OS Evolved Release 22.3R1, o dispositivo usa Python 3 para executar scripts de ação e tradução YANG. Em versões anteriores, o Junos OS usa apenas o Python 2.7 para executar esses scripts, e o Junos OS Evolved usa o Python 2.7 por padrão para executar os scripts.

  8. Em sistemas de multichassis, repita as etapas 1 a 7 em cada nó do sistema.

Quando você cria um novo pacote, o dispositivo armazena cópias do módulo e arquivos de script em um novo local. O dispositivo também armazena cópias do script de ação e arquivos de script de tradução nos diretórios /var/db/scripts/ação e /var/db/scripts/translation directories, respectivamente. Depois que os módulos e scripts são validados e adicionados ao dispositivo, o Junos OS reconstrói seu esquema para incluir os novos modelos de dados e, em seguida, valida a configuração ativa contra este esquema. Os RPCs recém-adicionados e as hierarquias de configuração estão imediatamente disponíveis para uso.

Nota:

Os dispositivos que usam o banco de dados de configuração efêmero excluirão todos os dados de configuração efêmeros no processo de reconstrução do esquema.

Nota:

O Junos OS não oferece suporte ao modo de uso configure private para configurar declarações correspondentes a modelos de dados YANG de terceiros, por exemplo, modelos de dados OpenConfig ou YANG personalizados.

Atualização de um pacote YANG com módulos e scripts novos ou modificados

Você cria um novo pacote YANG executando o request system yang add comando. Para atualizar um pacote existente para adicionar novos módulos e scripts ao pacote ou atualizar módulos e scripts existentes no pacote, você deve usar o request system yang update comando.

Atualizar um pacote YANG com módulos e scripts novos ou modificados:

  1. Baixe os módulos e scripts para qualquer diretório do dispositivo.
  2. Certifique-se de que quaisquer scripts de ação python não assinados sejam de propriedade de um root ou de um usuário na classe de login do Junos OS super-user e que apenas o proprietário do arquivo tenha permissão de gravação para o arquivo.
    Nota:

    Os usuários só podem executar scripts python não assinados em dispositivos Junos quando as permissões de arquivo do script incluem a permissão de leitura para a primeira classe em que o usuário se encaixa, na ordem do usuário, do grupo ou de outros.

  3. (Opcional) Valide a sintaxe dos módulos e scripts.
  4. Atualize o pacote YANG emitindo o request system yang update comando e especifique os caminhos de arquivo para os novos módulos e scripts modificados.
    Nota:

    Você pode especificar o caminho absoluto ou relativo para um único arquivo, ou pode atualizar vários arquivos especificando uma lista delimitada em espaço de caminhos de arquivo fechados em parênteses.

    Nota:

    A partir do Junos OS Release 18.3R1, adicionar, excluir ou atualizar pacotes YANG no modo de configuração com o run comando não é suportado.

  5. Quando o sistema solicita que você reinicie o Junos OS CLI, pressione Enter para aceitar o valor padrão de yes.
  6. Se o pacote incluir scripts de tradução ou scripts de ação escritos em Python, permita que o dispositivo execute scripts python não assinados configurando a declaração ou language python3 a language python declaração, conforme apropriado para a versão do Junos OS, se ainda não estiver configurado.
    Nota:

    A partir do Junos OS Release 20.2R1 e Junos OS Evolved Release 22.3R1, o dispositivo usa Python 3 para executar scripts de ação e tradução YANG. Em versões anteriores, o Junos OS usa apenas o Python 2.7 para executar esses scripts, e o Junos OS Evolved usa o Python 2.7 por padrão para executar os scripts.

  7. Em sistemas multichassis, repita as etapas 1 a 6 em cada nó do sistema.

Ao atualizar um pacote, o dispositivo armazena cópias dos novos módulos e arquivos de script modificados. O Junos OS reconstrói seu esquema para incluir quaisquer alterações nos modelos de dados associados a esse pacote e valida a configuração ativa contra este esquema.

Nota:

Os dispositivos que usam o banco de dados de configuração efêmero excluirão todos os dados de configuração efêmeros no processo de reconstrução do esquema.

Exclusão de um pacote YANG

CUIDADO:

Antes de excluir um pacote YANG de um dispositivo Junos, certifique-se de que a configuração ativa não contenha dados de configuração que têm dependências dos modelos de dados adicionados por esse pacote.

Para excluir um pacote YANG e todos os módulos e scripts associados a esse pacote de um dispositivo Junos:

  1. Analise a configuração ativa para determinar se há alguma dependência nos módulos YANG que serão excluídos.
  2. Se a configuração conter dependências dos módulos, atualize a configuração para remover as dependências.
  3. Exclua o pacote e os módulos e scripts associados emitindo o request system yang delete comando com o identificador de pacotes apropriado.
    Nota:

    Você deve usar o request system software delete comando para remover os pacotes OpenConfig que foram instalados de um arquivo de piche comprimido emitindo o request system software add comando.

    Nota:

    A partir do Junos OS Release 18.3R1, adicionar, excluir ou atualizar pacotes YANG no modo de configuração com o run comando não é suportado.

  4. Se o sistema solicitar que você reinicie o Junos OS CLI, pressione Enter para aceitar o valor padrão de yes.

Ao excluir um pacote, o Junos OS reconstrói seu esquema para remover os modelos de dados associados a esse pacote e, em seguida, valida a configuração ativa contra este esquema. O dispositivo remove as cópias do módulo e arquivos de script que foram gerados quando o pacote foi criado. O dispositivo também remove as cópias do script de ação e arquivos de script de tradução do pacote que são armazenados sob os diretórios /var/db/scripts/ação e /var/db/scripts/translation directories. Se você baixar o módulo original e os arquivos de script para um local diferente, os arquivos originais permanecerão inalterados.

Nota:

Os dispositivos que usam o banco de dados de configuração efêmero excluirão todos os dados de configuração efêmeros no processo de reconstrução do esquema.

Tabela de histórico de lançamentos
Lançamento
Descrição
22.3R1-EVO
A partir do Junos OS Evolved Release 22.3R1, o Junos OS Evolved usa o Python 3 para executar scripts de ação e tradução YANG.
20.2R1
A partir do Junos OS Release 20.2R1, o Junos OS usa o Python 3 para executar scripts de ação e tradução YANG. Em versões anteriores, o Junos OS usa o Python 2.7 para executar esses scripts.
18.3R1
A partir do Junos OS Release 18.3R1, adicionar, excluir ou atualizar pacotes YANG no modo de configuração com o run comando não é suportado.
17.3R1
A partir do Junos OS Release 17.3R1, quando você carrega modelos de dados YANG personalizados no dispositivo, você não precisa carregar explicitamente nenhum módulo de extensão Junos OS necessário.