Ferramenta de configuração de porta Ethernet FS Intel X710BM2-2SP
Especificações do produto
- Modelos: X710BM2-2SP; XL710BM1-4SP; XXV710AM2-2BP; XL710BM2-2QP; X550AT2-2TP; 82599ES-2SP; E810CAM2-2CP; E810XXVAM2-2BP
- Ferramenta: Ferramenta de configuração de porta Ethernet Intel (EPCT)
Sobreview
Sobreview de EPCT
A Ethernet Port Configuration Tool (EPCT) é um utilitário de linha de comando que permite que os usuários alterem o tipo de link de um dispositivo. Os tipos suportados são definidos dentro do NVM do adaptador. Este utilitário exibe apenas os dispositivos que potencialmente suportam reconfiguration.et.
OBSERVAÇÃO:
É necessária uma reinicialização para aplicar as alterações de configuração.
Você pode perder o link se alterar o tipo de link do seu dispositivo de qualquer opção de porta que contenha de três a sete portas para uma opção de porta que habilite interfaces multi-lane, como 2x100Gbps, 2x50Gbps ou 1x100Gbps. Um dos seguintes métodos pode resolver o problema:
- Use o utilitário para alterar a opção de porta para 8x10 Gbps; reinicie o sistema; altere para a configuração desejada originalmente.
- Reinicie o sistema completamente.
Se a ferramenta exibir um erro como “Erro de acesso” ou “Não é possível inicializar a porta”, você pode estar usando um driver desatualizado. Baixe o driver mais recente em https://support.intel.com e tente novamente.
Sistemas operacionais suportados
- Servidor Microsoft Windows*
- Kernel Linux*
- Red Hat* Enterprise Linux*
- Servidor SUSE* Linux Enterprise
- openEuler* para AArch64 (apenas em Intel® Ethernet E810 Series
- VMware* ESXi*
- FreeBSD*
OBSERVAÇÃO
Em sistemas que executam Linux, FreeBSD ou ESXi, o driver base deve estar presente para que o EPCT funcione corretamente.
Instalação
Instalando a ferramenta no Microsoft* Windows*
Para instalar os drivers das ferramentas no Windows, execute install.bat no diretório apropriado do pacote de instalação.
Embora as ferramentas não sejam instaladas com install.bat, o driver que a ferramenta requer é copiado para o diretório de driver do Windows da máquina local. Para executar a ferramenta, inicie uma janela do Prompt de Comando no Menu Iniciar do Windows. Vá para a mídia e o diretório onde a ferramenta está localizada e execute o utilitário. O arquivo leia-me files para cada ferramenta são encontrados no mesmo diretório que a ferramenta. Essas ferramentas podem ser instaladas manualmente no disco rígido local em qualquer diretório.
A ferramenta usa seu próprio driver file (não é o mesmo que o driver de rede do sistema). Se o driver do sistema file já existe no diretório de drivers, install.bat pode falhar ao copiar. Usar a opção /y com install.bat substituirá e copiará o driver file independentemente. No entanto, isso pode ser perigoso se uma versão mais antiga do driver estiver sendo usada por outro aplicativo, como o Intel® PROSet. Se um driver já estiver presente no diretório de drivers, tente executar a ferramenta a partir do prompt de comando. Se ele executar, o driver está bom. A ferramenta não será executada se a versão do driver presente não corresponder à versão do driver esperada.
Observe que você deve ter acesso ao diretório %systemroot%\system32\drivers. Somente a conta de administrador tem esses privilégios. Você deve estar logado como administrador ou as ferramentas devem ser executadas como administrador.
Observe que no Windows, qualquer dispositivo que esteja desabilitado no Gerenciador de Dispositivos não será acessível por ferramentas devido à falta de recursos de memória. Você obteria um código de erro 0xC86A800E. Para resolver esse problema, você pode fazer um dos seguintes:
Reative o dispositivo no Gerenciador de Dispositivos. Nunca desative este dispositivo ao usar ferramentas.
Instale um driver de dispositivo NDIS para o dispositivo e certifique-se de que não haja um ponto amarelo ou vermelho ao lado dele no Gerenciador de Dispositivos.
Exclua o dispositivo do Gerenciador de Dispositivos e reinicie o sistema. O assistente de instalação de novo hardware deve aparecer na próxima reinicialização. Não cancele isso. Apenas mova a janela para o lado e execute a(s) ferramenta(s). Geralmente, você pode clicar em Cancelar no assistente, mas há alguns casos em que o Windows desabilitará os recursos de memória, fazendo com que você volte ao mesmo estado.
Instalando a ferramenta no EFI
As ferramentas EFI 1.x não são suportadas.
Não há necessidade de instalação para ferramentas EFI. As ferramentas podem ser simplesmente copiadas do diretório apropriado para a unidade de onde serão executadas. Os binários EFI2 são para uso com o UEFI Shell 2.X com o protocolo UEFI 2.3 HII. As ferramentas EFI2 não serão executadas no EFI Shell 1.X ou se o protocolo UEFI 2.3 HII não estiver presente.
Observe que, embora o EFI suporte drives USB, pode haver problemas ao executar ferramentas a partir do drive USB. Se há ou não problemas é algo específico do BIOS. Se você tiver problemas, execute a ferramenta a partir do disco rígido.
Instalando a ferramenta no Linux*
Para executar ferramentas no Linux*, um stub de driver deve ser criado e instalado no sistema. Este driver não está relacionado ao driver de dispositivo de rede que é usado para executar a rede durante o tráfego ativo. É um driver separado usado explicitamente para ferramentas. Devido à natureza do Linux com o número de kernels que podem existir, fornecemos a fonte para o módulo do driver e um script de instalação para criá-lo/instalá-lo.
As ferramentas suportam distribuições Linux baseadas em kernels 2.6.x. A validação é feita aleatoriamente em distribuições populares como Red Hat* ou Suse*. É necessário configurar a fonte do kernel que corresponde ao kernel instalado atualmente. Um GCC funcional também é necessário. Existem algumas versões do GCC que tinham um bug que não suportava estruturas sem nome. Essas versões do GCC não são suportadas. Se você tiver erros de compilação, tente atualizar sua versão do GCC. Se você tiver erros de linker ao instalar o driver, você deve atualizar seu kernel; baixe a versão estável mais recente www.kernel.org e construí-lo/instalá-lo.
Observe que algumas distribuições, como as versões recentes do núcleo do Fedora, não são fornecidas com o código-fonte do Kernel. Você deve baixar, instalar e configurar o código-fonte para obter o driver das ferramentas criado neste SO. Instalar o RPM do código-fonte do kernel não resolve o problema.
Este é o procedimento de instalação:
- Efetue login como root e crie um diretório temporário para compilar o driver do Intel® Network Connection Tools.
- Copie install e iqvlinux.tar.gz para o diretório temporário. Há 2 versões do Linux suportadas: Linux32 (x86) e Linux_ x64 (x64). Cópias dos arquivos acima files existem no diretório apropriado para sua plataforma.
- CD para o diretório temporário e execute ./install. O driver foi instalado agora, então o files no diretório temporário podem ser removidos.
- Copie as ferramentas que você deseja usar do diretório apropriado do CD.
Kernel 4.16 ou superior
No kernel Linux 4.16 e superior, o parâmetro iomem é definido como “strict” por padrão, o que pode impedir que a ferramenta acesse o MMIO do dispositivo. Tentar atualizar um dispositivo quando “strict” está definido faz com que o dispositivo perca o link durante o processo de atualização.
Se você deseja atualizar um dispositivo sem perder o link, você pode:
- Instale os drivers básicos do Linux (igb ou ixgbe) da versão 24.1 ou mais recente.
- Defina o parâmetro do kernel iomem como relaxado (ou seja, iomem=relaxed) e reinicie o sistema antes de executar o utilitário de atualização.
Instalando a ferramenta no FreeBSD*
Para executar ferramentas no FreeBSD*, um stub de driver deve ser construído e instalado no sistema. Este driver não está relacionado ao driver de dispositivo de rede que é usado para executar a rede durante o tráfego ativo. É um driver separado usado explicitamente para ferramentas. Devido à natureza do FreeBSD com o número de kernels que podem existir, fornecemos a fonte para o módulo do driver e um script de instalação para construí-lo/instalá-lo.
As ferramentas suportam distribuições FreeBSD versão 10.1 e posteriores.
Este é o procedimento de instalação:
- Efetue login como root e crie um diretório temporário para compilar o driver do Intel® Network Connection Tools.
- Copie install e iqvfreebsd.tar para o diretório temporário. Há duas versões do FreeBSD suportadas: FreeBSD32 (x86) e FreeBSD64e (x64). Cópias dos arquivos acima files existem no diretório apropriado para sua plataforma.
- CD para o diretório temporário e execute ./install. O driver foi instalado agora, então o files no diretório temporário podem ser removidos.
- Copie as ferramentas que você deseja usar do diretório apropriado do CD.
Instalando a ferramenta no VMware* ESXi*
Para executar ferramentas no VMWare* ESXi*, o driver base deve estar instalado no sistema.
VMWare ESXi 8.0 e posterior
Esta versão inclui uma versão de pacote assinada de ferramentas. Por motivos de segurança, o VMWare ESXi 8.0 (e posterior) impede que você execute binários que não foram instalados de um vSphere* Installation Bundle (VIB) assinado file.
Para instalar o pacote assinado, faça o seguinte:
- Extrair o zip file ou tarball para a ferramenta. Por exemploampem:
Instalar o VIB file usando o comando esxcli:
- Reinicie o sistema para garantir que todas as alterações feitas pela instalação do VIB entrem em vigor.
- Mude o diretório para a pasta onde as imagens NVM estão presentes. Por exemploample
OBSERVAÇÃO:
Este example é específico para um adaptador Intel® Ethernet série E810, mas o diretório real pode variar dependendo da ferramenta, versão e família de dispositivos. - Execute a ferramenta usando um dos comandos fornecidos. O comando correto depende de onde o binário da ferramenta está instalado. Veja o readme da ferramenta para detalhes sobre como usá-la.
Or 
Por exemploampem: 
Desinstalando o Intel Network Connection Tools
Execute o lote uninstall.bat file se você precisar remover manualmente a versão antiga (iqvw .sys) do driver do Intel Network Connection Tools.
No Windows, você também precisa remover manualmente o driver iqvsw64e.sys.Executando o utilitário
Executando o utilitário
Use a seguinte sintaxe para executar o EPCT: 
Usar a opção /? exibirá uma lista de opções de linha de comando suportadas.
Veja Opções abaixo para ver os parâmetros suportados por esta ferramenta.
OBSERVAÇÃO:
Se a ferramenta exibir o erro: “Não foi possível carregar o driver. Feche todos os outros aplicativos e tente novamente”, você tem uma mistura de versões antigas e novas da ferramenta de utilitário em seu sistema. Saia de todos os aplicativos abertos e tente a operação novamente. Se o problema persistir:
- Baixe a versão mais recente das ferramentas utilitárias.
- Execute o script de desinstalação para remover a versão antiga do driver da ferramenta.
- Execute o script de instalação do pacote de ferramentas baixado.
- Repita a operação.
Também pode ser necessário baixar e instalar o driver Intel Ethernet mais recente ou o pacote Intel® PROSet para o seu dispositivo.
Uso básico Exampos
A seguir mostramos alguns exemplos básicos de usoamparquivos para EPCT:
Veja o uso detalhado Exampveja abaixo para exemplos adicionaisamples.
Opções
A ferramenta de configuração de porta Ethernet pode ser executada com qualquer uma das seguintes opções de linha de comando.
OBSERVAÇÃO
- Você pode usar a barra / caractere no lugar do traço – caractere.
- Todas as opções diferenciam maiúsculas de minúsculas.
-h, -ajuda, -?
Exibe ajuda para o comando ou parâmetro.
Você também pode usar o seguinte para exibir ajuda para o parâmetro especificado:
-dispositivos [marca]
Exibe dispositivos suportados presentes no sistema. Se a marca for especificada, então a marca view é exibido. Se uma opção for especificada, o valor para essa configuração também será exibido.
- Valores possíveis para são:
- tx_balancing: Exibe a configuração de balanceamento de transmissão do dispositivo.
-pegar
Exibe a configuração da opção especificada no dispositivo especificado por -nic.
Se uma opção não for especificada, -get exibirá a configuração de porta para o dispositivo especificado.
- Ativo indica a configuração usada atualmente.
- Pendente indica a configuração que o dispositivo usará após a reinicialização do sistema.
Valores possíveis para são:
balanceamento_tx:
Exibe a configuração de balanceamento de transmissão do dispositivo. max_pwr:
- Exibe as opções de potência máxima das gaiolas QSFP/SFP.
- Veja -obtenha Examples abaixo por exampo uso desta opção.
-localização
Especifique um dispositivo para esta instância da ferramenta atualizar, onde significa:
SS:
O segmento PCI do dispositivo desejado.
BBB:
O barramento PCI do dispositivo desejado.
Não especifique -nic no mesmo comando que -location.
-nic=
Seleciona o dispositivo no índice especificado. Não especifique -location no mesmo comando que -nic.
-definir
Configura o dispositivo selecionado com a opção especificada. Valores válidos para são: tx_balancing enable|disable:
Habilita ou desabilita o recurso de balanceamento de transmissão para melhorar o desempenho da transmissão.
potência máxima X:
Define a potência máxima permitida para X para a gaiola QSFP/SFP.
:
Especifica a configuração a ser definida para o quad, porta ou velocidade desejados. Uma string de configuração de porta é definida como:
- QxPxS – se todas as velocidades de porta forem as mesmas em ambos os quads e todas as linhas, ou
- P1xS1-P2xS2 – se cada quad tem uma velocidade específica, ou
- P11xS11+<…>+P1nxS1n-P21xS21+<…>+P2mxS2m
Onde:
- P: O número do quad desejado.
- P: O número da porta desejada.
- S: A velocidade da porta desejada.
- n: A combinação desejada de porta/velocidade para o quad 0. m: A combinação desejada de porta/velocidade para o quad 1.
Por exemploampem:
Veja -set Examples abaixo por exampo uso dessas opções.
OBSERVAÇÃO: É necessário reinicializar após alterar as configurações da porta.
Uso detalhado Exampos
Observação: Algumas configurações mostradas no exampOs exemplos abaixo podem não se aplicar a todos os adaptadores. O exemplo a seguiramples mostram a opção -devices, a opção -get e a opção -set da ferramenta.
dispositivos Exampos
Digitando o seguinte no prompt:
Irá exibir
A seguir, mostramos como usar a opção de marca:
-Obter Exampos
Digitando o seguinte no prompt:
Será exibido:
Para exibir a configuração atual do recurso de balanceamento de transmissão em um dispositivo específico:
Para exibir a potência mínima e máxima permitida para a gaiola QSFP/SFP em um dispositivo específico:
Por exemploample, o acima será exibido:
Definir Exampos
Para definir duas portas para 50 Gbps (a primeira porta começa com a faixa L0 no quad 0 e a segunda com a faixa L4 no quad 1):
Para definir a primeira e a segunda portas para 25 Gbps (respectivamente faixas L0 e L1 no quad 0), a terceira e a quarta portas para 10 Gbps (respectivamente faixas L2 e L3 no quad 0) e a quinta e a sexta portas para 10 Gbps (respectivamente faixas L4 e L5 no quad 1):
Para habilitar o recurso de balanceamento de transmissão em um dispositivo específico:
Para definir a potência máxima permitida para uma gaiola QSFP:
OBSERVAÇÃO:
É necessário reinicializar após alterar as configurações de porta. No Windows, você deve usar aspas duplas em vez de aspas simples.
Por exemploampem:
Códigos de saída
Ao sair, quando possível, o EPCT relata um código de status geral para indicar os resultados da operação. Em geral, um código de retorno diferente de zero indica que ocorreu um erro durante o processamento.
| Descrição do valor | |
| 0 | Sucesso |
| 1 | Nenhum adaptador suportado encontrado |
| 2 | Privilégios insuficientes para executar a ferramenta |
|
3 |
Nenhum driver disponível |
| 4 | Versão do driver base não suportada |
|
5 |
Parâmetro de linha de comando inválido |
| 6 | Adaptador inválido selecionado |
| 7 | Configuração de portas não suportadas selecionada |
|
8 |
O adaptador não suporta configuração de portas |
|
9 |
Erro de alocação de memória |
|
10 |
Erro de acesso ao adaptador |
| 13 | Não é possível definir a nova opção de porta. Reinicialização pendente detectada |
| 14 | O dispositivo está em modo de recuperação |
| 15 | O recurso solicitado não é suportado neste dispositivo. Você pode receber este erro se sua combinação de sistema/dispositivo/sistema operacional não suportar a opção que você tentou definir. |
| 25 | O valor da configuração está fora do intervalo |
OBSERVAÇÃO
As versões EFI desta ferramenta podem relatar um código de erro incorreto quando nenhum adaptador estiver instalado. Isso ocorre devido a uma limitação conhecida no ambiente de construção do UDK2015 UEFI Development Kit (UDK).
Solução de problemas
Problemas com cabos de breakout
O uso da opção de porta quad breakout 4×25 ou 1×100 só funcionará na Porta 2 dos produtos Adaptador de rede Intel® Ethernet E810-C-Q2.
Mapeamento PF inesperado
O mapeamento da função física (PF) para a faixa física depende do hardware e pode mudar entre diferentes opções de porta MAC. Isso pode ser mais perceptível ao usar um cabo breakout, caso em que a rotulagem no cabo pode não estar alinhada com a atribuição da porta do dispositivo.
Por exemploamppor exemplo, inserir um cabo breakout de 4 portas em qualquer gaiola QSFP e configurar o dispositivo no modo 2x2x25 pode resultar na atribuição dos dois PFs ativos ao terceiro e quarto cabos do conector breakout.
Possível configuração incorreta da porta Ethernet
Você pode ver uma mensagem informativa informando que uma possível configuração incorreta da porta Ethernet foi detectada. Isso é para alertá-lo de que seu dispositivo está sendo subutilizado. Se isso foi intencional, você pode ignorar esta mensagem. Por ex.ample, definir seu Intel® Ethernet Network Adapter E810-C-Q2 para 2x2x25 é válido, mas não usa todos os recursos do dispositivo. Se você vir esta mensagem e a configuração não foi intencional, você pode usar o EPCT para corrigir a configuração.
Perguntas frequentes
P: O que devo fazer se a ferramenta apresentar o código de erro 0xC86A800E?
R: Você pode tentar reativar o dispositivo no Gerenciador de Dispositivos ou instalar um driver de dispositivo NDIS para o dispositivo. Como alternativa, você pode excluir o dispositivo do Gerenciador de Dispositivos e reiniciar o sistema para acionar uma nova instalação de hardware.
Documentos / Recursos
 |
Ferramenta de configuração de porta Ethernet FS Intel X710BM2-2SP [pdf] Manual de Instruções X710BM2-2SP, XL710BM1-4SP, XXV710AM2-2BP, XL710BM2-2QP, X550AT2-2TP, 82599ES-2SP, E810CAM2-2CP, E810XXVAM2-2BP, Intel X710BM2-2SP Ethernet Port Configuration Tool, Intel X710BM2-2SP, Ethernet Port Configuration Tool, Port Configuration Tool, Configuration Tool, Tool |
