Dados de configuração de upload e formato em uma sessão NETCONF
Em uma sessão netconf com um dispositivo executando o Junos OS, um aplicativo do cliente pode especificar o mecanismo de entrega e o formato dos dados de configuração usados ao fornecer alterações de configuração no dispositivo. Os aplicativos do cliente podem usar um arquivo de texto ou dados de streaming para carregar dados de configuração em um dos formatos aceitos para a configuração do candidato ou banco de dados de configuração aberta.
Um cliente pode optar por transmitir alterações de configuração dentro dos arquivos de dados de sessão ou de referência que incluam as alterações de configuração desejadas. Cada método tem vantagens e desvantagens. Os dados de streaming permitem que você envie seus dados de mudança de configuração na linha, usando sua conexão NETCONF. Isso é útil quando o dispositivo está por trás de um firewall e você não pode estabelecer outra conexão para carregar um arquivo de dados. Com arquivos de texto, você pode manter os comandos de configuração de edição simples; com arquivos de dados, não há necessidade de incluir o fluxo de dados de configuração possivelmente complexo.
A e <edit-config> as <copy-config> operações aceitam um dos dois formatos para os dados de configuração do Junos OS: declarações de configuração do Junos XML ou CLI. A escolha entre um formato de dados em relação ao outro é a preferência pessoal.
Ao gerenciar dispositivos que executam o Junos OS, um aplicativo do cliente pode usar a operação de protocolo <load-configuration> Junos XML em uma sessão NETCONF para carregar dados de configuração formatados usando comandos JSON ou modo set de configuração, além de formatos de declaração de configuração Junos XML ou CLI.
O mecanismo de entrega e o formato são discutidos detalhadamente nas seguintes seções:
Referenciando arquivos de dados de configuração
Para carregar dados de configuração armazenados em um arquivo, um aplicativo do cliente emite a localização do arquivo entre as <url> tags dentro dos <rpc> <edit-config> elementos ou <copy-config> tag.
<rpc> <copy-config> <target> <candidate/> </target> <source> <url> <!-- location and name of file containing configuration data --> </url> </source> </copy-config> </rpc> ]]>]]>
<rpc> <edit-config> <target> <candidate/> </target> <url> <!-- location and name of file containing configuration data --> </url> </edit-config> </rpc> ]]>]]>
Os dados nesses arquivos podem ser formatados como elementos Junos XML ou declarações de configuração CLI. Quando os dados de configuração são formatados como declarações de configuração de CLI, inclua o format="text" atributo na <url> tag.
<url format="text">
<!-- location and name of file containing configuration data -->
</url>
O arquivo de configuração pode ser colocado localmente ou como um recurso de rede.
-
Quando colocado localmente, o caminho do arquivo de configuração pode ser relativo ou absoluto:
-
Caminho de arquivo relativo — a localização do arquivo é baseada no diretório doméstico do usuário.
-
Caminho de arquivo absoluto — a localização do arquivo é baseada na estrutura de diretório do dispositivo, por exemplo <drive>:filename ou <drive>/:path/filename, Se você estiver usando mídia removível, a unidade pode ser no formato MS-DOS ou UNIX (UFS).
-
-
Quando localizado na rede, o arquivo de configuração pode ser acessado usando FTP ou HTTP:
-
Exemplo de FTP:
ftp://username:password@hostname/path/filename
Nota:O valor padrão para a variável FTP path é o diretório doméstico do usuário. Assim, por padrão, o caminho do arquivo para o arquivo de configuração é relativo ao diretório do usuário. Para especificar um caminho absoluto ao usar FTP, inicie o caminho com os caracteres %2F; por exemplo: ftp://username:password@hostname/%2Fpath/filename.
-
Exemplo de HTTP:
http://username:password@hostname/path/filename
-
Antes de carregar o arquivo, o aplicativo do cliente ou um administrador economiza elementos de tag Junos XML ou declarações de configuração de CLI como o conteúdo do arquivo. O arquivo inclui os elementos da tag ou as declarações de configuração que representam todos os níveis da hierarquia de configuração desde a raiz (representada pelo <configuration> elemento tag) até cada elemento a ser alterado. A notação é a mesma usada para solicitar informações de configuração. Para obter informações mais detalhadas sobre a representação do Junos XML das declarações de configuração do Junos OS, consulte as declarações de configuração do mapa para o Junos XML Tag Elements.
O exemplo a seguir mostra como incorporar dados de configuração armazenados no arquivo /var/tmp/configFile no servidor FTP chamado ftp.myco.com:
Dados de configuração de streaming
Para fornecer dados de configuração como um fluxo de dados, um aplicativo do cliente emite os <config> elementos ou <config-text> tag dentro dos <rpc> elementos de <edit-config> tag. Para especificar os elementos de configuração para mudar, o aplicativo emite declarações de configuração Junos XML ou CLI representando todos os níveis da hierarquia de configuração desde a raiz (representada pelo <configuration> elemento ou <configuration-text> elemento de tag) até cada elemento a ser alterado. A notação do Junos XML é a mesma usada para solicitar informações de configuração.
<rpc> <edit-config> <target> <candidate/> </target> <config> <configuration> <!-- configuration changes --> </configuration> </config> </edit-config> </rpc> ]]>]]>
<rpc> <edit-config> <target> <candidate/> </target> <config-text> <configuration-text> <!-- configuration changes --> </configuration-text> </config-text> </edit-config> </rpc> ]]>]]>
Para obter informações mais detalhadas sobre os mapeamentos entre os elementos de configuração do Junos OS e os elementos de tag Junos XML, consulte as Declarações de Configuração do Mapa aos Elementos de Tag Junos XML. A notação da declaração de configuração da CLI é descrita no Guia do Usuário da CLI.
O exemplo a seguir mostra como fornecer dados de configuração do Junos XML em um fluxo de dados para configurar o arquivo de log do sistema de mensagens :
Dados de formatação: Declarações de configuração Junos XML versus CLI
O NETCONF <copy-config> e <edit-config> as operações aceitam um dos dois formatos para dados de configuração do Junos OS: declarações de configuração do Junos XML ou CLI. A escolha entre um formato de dados em relação ao outro é a preferência pessoal.
Ao gerenciar dispositivos que executam o Junos OS, um aplicativo do cliente pode usar a operação de protocolo <load-configuration> Junos XML em uma sessão NETCONF para carregar dados de configuração formatados usando comandos JSON ou modo set de configuração, além de formatos de declaração de configuração Junos XML ou CLI.
Se você estiver fornecendo as alterações de configuração na forma de arquivos de dados, você inclui o nome e o caminho dos arquivos de dados dentro <url> das tags. Por padrão, essas tags especificam que os arquivos de dados mencionados contêm dados de configuração em formato Junos XML. Assim, o código a seguir declara que os dados dentro do arquivo são elementos Junos XML:
<url>dataFile</url>
Para especificar que o arquivo de dados contém declarações de configuração CLI, inclua o format="text" atributo na <url> tag.
<url format="text">dataFile</url>
Ao transmitir dados, você especifica o formato de dados selecionando uma das duas tags: <config> para elementos Junos XML e <config-text> para declarações de configuração de CLI.
No exemplo a seguir, o <configuration> elemento inclui dados de configuração em formato Junos XML:
<config>
<configuration>
<system>
<services>
<ssh>
<protocol-version>v2</protocol-version>
</ssh>
</services>
</system>
</configuration>
</config>
No exemplo a seguir, o <configuration-text> elemento inclui os mesmos dados formatados que as declarações de configuração da CLI:
<config-text>
<configuration-text>
system {
services {
ssh {
protocol-version v2;
}
}
}
</configuration-text>
</config-text>