Todos os produtos
Search
Central de documentação

Smart Access Gateway:Implantar a imagem do SAG vCPE

Última atualização: Jul 03, 2026

Após criar uma instância do SAG vCPE, use o script fornecido pela Alibaba Cloud para implantar a imagem do SAG vCPE no seu host.

Pré-requisitos

  • Você criou uma instância do SAG vCPE e obteve o número de série e a chave correspondentes. Para mais informações, consulte Criar uma instância do SAG vCPE.

  • Antes de implantar a imagem do SAG vCPE no host, verifique se ele atende aos requisitos de ambiente. Para mais detalhes, consulte Requisitos de ambiente.

Parâmetros do script

O script de implantação da imagem do SAG vCPE aceita os seguintes parâmetros e comandos:

Usage: deploy.sh [command] [options]
SAG-VCPE install tool 2021.06
Options:
      -u        run uninstall process
      -h        print this help message and exit
      -P        update an existing installation
      -C        run service state check
      -w        traffic ingress interface(default eth0)
      -t        platform, available platform:ens/aliyun/aws
      -n        sag-sn, get sn from user console platform
      -k        sag-key, get key from user console platform
      -v        ha-vip, get ha_vip from user console platform
Commands:
    ping        the standard ping command
    traceroute  the standard traceroute command
    mtr         the standard mtr command
    check       display main information

Parâmetro

Descrição

-n (Obrigatório)

Número de série da instância do SAG vCPE.

-k (Obrigatório)

Chave da instância do SAG vCPE.

-t (Obrigatório)

Plataforma onde a imagem do SAG vCPE será implantada. Valores válidos:

  • aliyun (Padrão): A imagem do SAG vCPE é implantada em uma instância ECS da Alibaba Cloud.

  • aws: A imagem do SAG vCPE é implantada em uma instância Amazon EC2.

  • azure: A imagem do SAG vCPE é implantada em uma máquina virtual no Microsoft Azure.

  • Para servidores em redes locais (on-premises), defina este parâmetro com qualquer string em inglês diferente de aliyun, ENS, aws ou azure.

-v

Endereço IP virtual para Alta Disponibilidade (HA) entre duas instâncias do SAG vCPE. Este recurso tem suporte apenas na plataforma aliyun.

Nota

Para ativar o HA, use o HAVIP da Alibaba Cloud. O produto HAVIP está em preview público. Para mais informações, consulte High-Availability Virtual IP (HAVIP).

-w

Nome da NIC para a porta WAN. O valor padrão é eth0.

Execute o comando ifconfig ou ip -br address para visualizar os nomes das NICs no host.

-u

Desinstala a imagem do SAG vCPE.

-h

Exibe a mensagem de ajuda do script.

-P

Atualiza a imagem do SAG vCPE.

-C

Verifica o status de execução do host.

check

Mostra o status da implantação, as informações do sistema do host e a versão da imagem do SAG vCPE.

ping

Testa a conectividade de rede.

traceroute

Rastreia o caminho percorrido pelos pacotes até o destino.

mtr

Combina as funcionalidades de ping e traceroute para diagnosticar a conectividade de rede.

Implantar a imagem do SAG vCPE

  1. Faça login no host e baixe o script para o diretório /root.

    Importante
    • Para obter instruções sobre como fazer login no host, entre em contato com o provedor do host.

    • Baixe o script em um diretório personalizado, se necessário. Nesse caso, use o caminho personalizado nos comandos subsequentes.

    • Não modifique o conteúdo ou o nome do script após o download.

    • Se o host estiver em uma região na China continental, execute o seguinte comando para baixar o script:

      wget -O /root/sag_vcpe_v2.3.0_deployment.sh https://sdwan-oss-shanghai.oss-cn-shanghai.aliyuncs.com/vcpe_vm/sag_vcpe_v2.3.0_deployment.sh
    • Se o host estiver em uma região fora da China continental, execute o seguinte comando para baixar o script:

      wget -O /root/sag_vcpe_v2.3.0_deployment.sh https://sdwan-oss-shanghai.oss-accelerate.aliyuncs.com/vcpe_vm/sag_vcpe_v2.3.0_deployment.sh
  2. Torne o script executável.

    chmod +x /root/sag_vcpe_v2.3.0_deployment.sh
  3. Execute o script.

    Execute o script em um dos dois modos a seguir:

    • Modo automático

      Ao especificar os parâmetros na linha de comando, o sistema executa automaticamente o comando de implantação. Exemplo de comando:

      /root/sag_vcpe_v2.3.0_deployment.sh -n <serial_number> -k <key> -t <platform>  -w <wan_nic_name>                
    • Modo interativo

      Se você executar o comando /root/sag_vcpe_v2.3.0_deployment.sh sem especificar parâmetros, o script iniciará no modo interativo. Insira os parâmetros conforme solicitado no terminal.

      Missing dependency packages docker , are you sure want to install these packages? [yes|no]
      >>> yes
      2021-07-28 09:47:28 INFO: Download the vcpe installation package
      2021-07-28 09:47:29 INFO: Unzip package
      ########################################## [100%]
      input the sn:sagexxx3jr
      input the key:X8Sxxx25ssFM7yg==
      input the traffic ingress:eth0
      input platform(ens/aliyun/aws):ens
      input ha_vip(default none):none
      Generating init config as following:
      Specify traffic ingress interface: eth0
      Specify platform: ens
      Specify sag sn:  sagexxx3jr
      Specify sag key:  X8SxxxssFM7yg==
      Specify ha vip:  none
      Specify package path:  /tmp/sag_install
      2021-07-28 09:48:02 INFO: Install vcpe
  4. O script verifica automaticamente se o ambiente de implantação atende aos requisitos. Se alguns componentes obrigatórios não estiverem instalados, o prompt a seguir será exibido. Insira yes para que o sistema instale os componentes automaticamente.

    Missing dependency packages python3 telnet vim traceroute sshpass mtr docker inotify wget netifaces==0.10.9, are you sure want to install these packages? [yes|no]
    [no] >>>
  5. Se o ambiente atender aos requisitos, o script implantará a imagem do SAG vCPE e exibirá a seguinte mensagem de confirmação.

    2021-07-28 10:00:40 INFO: Install complete, please wait for few minutes to check state
    ==============================================================================================
  6. Verifique o resultado da implantação.

    Após uma implantação bem-sucedida, execute o comando docker ps e confirme se a saída inclui os dois contêineres a seguir:

    [root@iZbp11vxxx wx8Z ~]# docker ps
    CONTAINER ID        IMAGE               COMMAND                CREATED           STATUS            PORTS               NAMES
    0b8xxx92c           vsag-core           "sh -c 'ln -s /lib..."   4 minutes ago     Up 4 minutes                          vsag-core
    fbexxx432           centos:7            "/sbin/init"             4 minutes ago     Up 4 minutes                          vsag-manager-base
    [root@iZbp11xxx x8Z ~]#

Próximas etapas

Após implantar a imagem do SAG vCPE, configure a rede na Alibaba Cloud e na rede do host para estabelecer conectividade. A configuração necessária varia conforme o ambiente. Use os tutoriais de ponta a ponta a seguir como referência: