Substitua a configuração do candidato usando o NETCONF
Em uma sessão netconf com um dispositivo executando o Junos OS, um aplicativo do cliente pode substituir toda a configuração do candidato ou todos os dados no banco de dados de configuração aberta, seja com novos dados ou revertendo para uma configuração anterior ou uma configuração de resgate.
Se um aplicativo do cliente emitir a operação de protocolo <open-configuration>
Junos XML para abrir um banco de dados de configuração específico antes de carregar os dados de configuração, o Junos OS executa a operação solicitada no banco de dados de configuração aberta. Caso contrário, a operação é realizada na configuração do candidato.
As seções a seguir discutem como substituir dados de configuração na configuração do candidato ou 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.
Usando <configuração de <copia> para substituir a configuração
Um método para substituir toda a configuração do candidato ou todos os dados no banco de dados de configuração aberta é usar a <copy-config>
operação. A <target>
tag inclui a <candidate/>
tag para indicar que os novos dados de configuração substituem os dados no banco de dados de configuração aberta (se o aplicativo do cliente emitiu a operação de protocolo <open-configuration>
Junos XML antes de executar a <copy-config>
operação) ou se não houver banco de dados aberto, os dados na configuração do candidato.
O <source>
elemento envolve o <url>
elemento, que especifica o nome de arquivo que contém os novos dados de configuração. Quando os dados de configuração são formatados como elementos de tag Junos XML, defina o <url>
format
atributo xml
ou omite o atributo. Quando os dados de configuração são formatados como declarações de configuração CLI, defina o atributo do <url>
formato para text
.
<rpc> <copy-config> <target> <candidate/> </target> <source> <url format="(xml | text)"> <!-- location specifier for file containing the new configuration --> </url> </source> </copy-config> </rpc> ]]>]]>
Usando <edit-config> para substituir a configuração
Outro método para substituir toda a configuração do candidato ou todos os dados no banco de dados de configuração aberta é usar a <edit-config>
operação e definir o modo replace
de configuração de edição como uma variável global. O aplicativo inclui o <default-operation>
elemento tag com o valor replace
no <edit-config>
elemento tag, conforme descrito no Modo de Configuração de Edição em uma Sessão NETCONF. A <target>
tag inclui a <candidate/>
tag para indicar que os novos dados de configuração substituem os dados no banco de dados de configuração aberta (se o aplicativo do cliente emitiu a operação de protocolo <open-configuration>
Junos XML antes de executar a <edit-config>
operação) ou se não houver banco de dados aberto, os dados na configuração do candidato.
Para especificar os novos dados de configuração, o aplicativo inclui um elemento ou <config-text>
tag que contém os dados, ou inclui um <url>
elemento de tag que nomeia o arquivo contendo os dados conforme discutido em Dados de Configuração de Upload e Formato em uma Sessão NETCONF.<config>
<rpc> <edit-config> <target> <candidate/> </target> <default-operation>replace</default-operation> <!-- EITHER --> <config> <configuration> <!-- Junos XML configuration data --> </configuration> </config> <!-- OR --> <config-text> <configuration-text> <!-- configuration data in text format --> </configuration-text> </config-text> <!-- OR --> <url> <!-- location specifier for file containing changes --> </url> </edit-config> </rpc> ]]>]]>
Voltando a 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.
A partir do Junos OS Release 18.1R1, um aplicativo NETCONF pode executar o <rollback-config>
RPC para substituir a configuração do candidato ou todos os dados no banco de dados de configuração aberta por uma configuração previamente comprometida. Para reverter a configuração, o aplicativo emite o <rollback-config>
elemento com o <index>
elemento infantil, que especifica o índice numérico da configuração anterior para carregar. 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).
Os aplicativos NETCONF também podem usar a operação de protocolo <load-configuration>
Junos XML com o rollback
atributo para reverter a configuração.
Por exemplo, para carregar a configuração com um índice de reversão de 1, o aplicativo do cliente emite o seguinte RPC:
<rpc> <rollback-config> <index>1</index> </rollback-config> </rpc> ]]>]]>
O servidor NETCONF indica que a operação de carga foi bem sucedida devolvendo os elementos e <ok/>
a <rollback-config-results>
resposta do RPC.
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" xmlns:junos="http://xml.juniper.net/junos/18.1R1/junos"> <rollback-config-results> <ok/> </rollback-config-results> </rpc-reply> ]]>]]>
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 <rpc-error>
elemento com informações sobre o erro.
Substituindo a configuração do candidato pela 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.
A partir do Junos OS Release 18.1R1, um aplicativo NETCONF pode executar o <rollback-config>
RPC para substituir a configuração do candidato ou todos os dados no banco de dados de configuração aberta pela configuração de resgate do dispositivo. Para carregar a configuração de resgate, o aplicativo emite o elemento e <rescue/>
a <rollback-config>
tag infantil. A configuração de resgate deve existir no dispositivo antes que você possa carregá-la.
Os aplicativos NETCONF também podem usar a operação de protocolo <load-configuration>
Junos XML com o rescue
atributo para carregar a configuração de resgate.
Por exemplo, para carregar a configuração de resgate, o aplicativo do cliente emite o seguinte RPC:
<rpc> <rollback-config> <rescue/> </rollback-config> </rpc> ]]>]]>
O servidor NETCONF indica que a operação de carga foi bem sucedida devolvendo os elementos e <ok/>
a <rollback-config-results>
resposta do RPC.
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" xmlns:junos="http://xml.juniper.net/junos/18.1R1/junos"> <rollback-config-results> <ok/> </rollback-config-results> </rpc-reply> ]]>]]>
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 <rpc-error>
elemento com informações sobre o erro.