Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Substitua a configuração usando o protocolo Junos XML

Em uma sessão de protocolo Junos XML com um dispositivo que executa o Junos OS, um aplicativo do cliente pode substituir toda a configuração do candidato ou uma cópia privada dele, seja com novos dados ou revertendo para uma configuração anterior ou uma configuração de resgate. A partir do Junos OS Release 18.1R1, um aplicativo do cliente também pode substituir todos os dados de configuração em uma instância de banco de dados de configuração efêmera por novos dados.

Nota:

O Junos OS não aceita reverter a configuração comprometida com uma instância do banco de dados de configuração efêmero.

As seções a seguir discutem como substituir todos os dados de configuração na configuração do candidato ou no banco de dados de configuração aberta. O aplicativo do cliente deve comprometer a configuração após substituir os dados para torná-los a configuração ativa no dispositivo. Para obter instruções que modifiquem elementos de configuração individuais, consulte Criar, modificar ou excluir elementos de configuração usando o protocolo Junos XML.

Substituindo a configuração do candidato por novos dados

Para descartar todos os dados de configuração na configuração do candidato ou no banco de dados de configuração aberta e substituí-los por novos dados de configuração, um aplicativo do cliente executa a <load-configuration> operação e inclui o action="override" atributo. Se um aplicativo do cliente emitir a <open-configuration> operação para abrir um banco de dados de configuração específico antes de executar a <load-configuration> operação, o servidor carregará os dados de configuração no banco de dados de configuração aberta. Caso contrário, o servidor carrega os dados de configuração na configuração do candidato.

Para obter mais informações sobre os atributos e format a sintaxe para os novos dados de configuração, consulte dados de configuração de upload e formatação em uma sessão de protocolo Junos XML.url

O exemplo a seguir mostra como especificar que o conteúdo do arquivo /tmp/new.conf substitui toda a configuração do candidato. O arquivo contém elementos de tag Junos XML (o padrão), de modo que o format atributo é omitido.

Aplicativo do cliente

Servidor de protocolo Junos XML

Revertendo a configuração do candidato para uma configuração previamente comprometida

Os dispositivos que executam o Junos OS armazenam uma cópia da configuração mais recentemente comprometida e até 49 configurações anteriores, dependendo da plataforma. Você pode reverter para qualquer uma das configurações armazenadas. Isso é útil quando as mudanças de configuração causam resultados indesejáveis, e você quer voltar para uma configuração de trabalho conhecida. Reverter a configuração é semelhante ao processo de fazer mudanças de configuração no dispositivo, mas, em vez de carregar dados de configuração, você executa uma reversão, que substitui toda a configuração do candidato por uma configuração previamente comprometida.

Quando você confirma com sucesso uma configuração, o Junos OS atribui essa configuração a um identificador de revisão de configuração exclusivo. A configuração também está associada a um índice de reversão, onde a configuração mais recentemente comprometida tem índice de reversão 0. Enquanto o índice de reversão para incrementos de configuração previamente comprometidos com cada commit, o identificador de revisão de configuração permanece estático para a mesma configuração. Quando você volta para uma configuração previamente comprometida, você pode fazer referência à configuração pelo índice de reversão atual ou pelo identificador de revisão de configuração.

Para substituir a configuração do candidato (ou banco de dados de configuração aberta) por uma configuração previamente comprometida, os clientes de protocolo Junos XML podem usar um dos seguintes métodos:

  • Execute a <load-configuration/> operação com o rollback="index" atributo de reverter para a configuração com o determinado índice de reversão.

  • Execute a <load-configuration/> operação com o configuration-revision="revision-id" atributo de reverter para a configuração com o identificador de revisão de configuração.

  • Execute o <rollback-config> RPC com o <index> elemento infantil, que define um índice de reversão. Este RPC, que está disponível a partir do Junos OS Release 18.1R1, é útil quando um aplicativo não oferece suporte à execução de RPCs que incluam atributos XML.

Nota:

O Junos OS não aceita reverter a configuração comprometida com uma instância do banco de dados de configuração efêmero. Assim, o banco de dados efêmero não suporta o uso do <rollback-config> RPC ou da <load-configuration> operação com os rollback atributos ou os configuration-revision atributos.

Para usar a <load-configuration> operação para substituir a configuração do candidato ou o banco de dados de configuração aberta por uma configuração previamente comprometida, um aplicativo do cliente executa a <load-configuration/> operação e inclui o rollback ou configuration-revision atributo. O rollback valor é o índice de reversão numérica da configuração anterior apropriada. Os valores válidos são 0 (zero, para a configuração mais recentemente comprometida) por meio de um a menos do que o número de configurações anteriores armazenadas (o máximo é 49). O configuration-revision valor é o identificador de revisão de configuração para carregar, por exemplo, re0-1605228066-332.

O servidor de protocolo Junos XML indica que a operação de carga foi bem sucedida devolvendo os elementos e <load-success/> a <load-configuration-results> resposta de RPC.

Para usar o <rollback-config> RPC para carregar uma configuração previamente comprometida, um aplicativo do cliente executa o <rollback-config> RPC com o <index> elemento. O <index> elemento especifica o índice de reversão para a configuração carregar.

O servidor de protocolo Junos XML indica que a operação de carga foi bem sucedida devolvendo os elementos e <load-success/> a <rollback-config-results> resposta de RPC.

Se a operação de carga for bem-sucedida, o aplicativo do cliente deve comprometer a configuração para torná-la a configuração ativa do dispositivo. Se o servidor encontrar um erro ao carregar a configuração de reversão, ele retorna um <xnm:error> elemento com informações sobre o erro.

Substituindo a configuração do candidato por uma configuração de resgate

Uma configuração de resgate permite definir uma configuração de trabalho conhecida ou uma configuração com um estado conhecido que você pode restaurar a qualquer momento. Você usa a configuração de resgate quando precisa reverter para uma configuração conhecida ou como último recurso se a configuração do dispositivo e os arquivos de configuração de backup ficarem danificados sem reparo. Quando você cria uma configuração de resgate, o dispositivo economiza a configuração mais recentemente comprometida como a configuração de resgate.

Para substituir a configuração do candidato ou o banco de dados de configuração aberta pela configuração de resgate do dispositivo, um aplicativo de protocolo Junos XML pode usar um dos seguintes métodos. A configuração de resgate deve existir no dispositivo antes que você possa carregá-la.

  • Execute a <load-configuration/> operação com o rescue="rescue" atributo.

  • Execute o <rollback-config> RPC com o <rescue/> elemento infantil. Este RPC, que está disponível a partir do Junos OS Release 18.1R1, é útil quando um aplicativo não oferece suporte à execução de RPCs que incluam atributos XML.

Para usar a <load-configuration/> operação para substituir a configuração do candidato pela configuração de resgate, inclua o rescue="rescue" atributo na <load-configuration/> tag.

O servidor de protocolo Junos XML indica que a operação de carga foi bem sucedida devolvendo os elementos e <load-success/> a <load-configuration-results> resposta de RPC.

Para usar o <rollback-config> RPC para carregar a configuração de resgate, um aplicativo do cliente emite o <rollback-config> elemento e a <rescue/> tag infantil.

O servidor de protocolo Junos XML indica que a operação de carga foi bem sucedida devolvendo os elementos e <load-success/> a <rollback-config-results> resposta de RPC.

Se a operação de carga for bem-sucedida, o aplicativo do cliente deve comprometer a configuração para torná-la a configuração ativa do dispositivo. Se a configuração de resgate não existir ou o servidor encontrar outro erro ao carregar os dados de configuração, ele retorna um <xnm:error> elemento com informações sobre o erro.

Tabela de histórico de lançamento
Lançamento
Descrição
18.1R1
A partir do Junos OS Release 18.1R1, um aplicativo do cliente também pode substituir todos os dados de configuração em uma instância de banco de dados de configuração efêmera por novos dados.