Como instalar o Omada Software Controller em um sistema Linux

Knowledgebase
Configuration Guide
Controladora
08-11-2026
Este Artigo se aplica a

Sumário

Introdução

Requisitos

Instalar o Controlador de Software Omada no Ubuntu 22.04.. 2

Abrir um Terminal 2

Instalar OpenJDK.. 2

Instale o OpenJDK 17. 2

Instale o OpenJDK 8. 3

Instale o OpenJDK 11. 3

Instalar o MongoDB.. 4

Instalar o MongoDB v4.4. 4

Instalar o MongoDB v7. 5

Instalar o MongoDB v8. 6

Instalar o Controlador de Software Omada. 7

Para o pacote de software deb. 7

Para o pacote de software tar.gz. 7

Instale o navegador Chromium (opcional) 7

Verificação

Conclusão

 

Introdução

Este artigo explica como instalar o Controlador de Software Omada em sistemas Linux, incluindo Ubuntu e Debian. Ele aborda as dependências de software necessárias, como OpenJDK, MongoDB e JSVC, e fornece instruções de instalação passo a passo usando o Ubuntu 22.04 como exemplo. O mesmo procedimento também se aplica ao Debian.

Requisitos

  • Pacote de instalação do controlador SDN Omada
  • Ubuntu 16.04, 18.04, 20.04, 22.04, 24.04 (v5.15.20 e superior)
  • Debian 8, 9, 10, 11, 12

Instalar o Controlador de Software Omada no Ubuntu 22.04

Abra um Terminal

No Ubuntu ou Debian, pressione Ctrl + Alt + T para abrir uma janela do Terminal. Em seguida, execute os comandos nas seções a seguir para instalar o Controlador de Software Omada.

Janela de terminal aberta em um sistema Linux, pronta para inserir comandos de instalação.

Instalar OpenJDK

A versão do Java necessária depende da versão do seu Controlador de Software Omada:

  • O Controller v5.15.20 e versões posteriores requerem Java 17 de 64 bits ou posterior.
  • Controladores anteriores à versão 5.15.20 são compatíveis com Java 8 de 64 bits ou posterior.

Siga as instruções abaixo para instalar a versão apropriada do OpenJDK para o seu Controlador.

 

Para o Controlador de Software Omada v5.15.20 e superior

O Controller v5.15.20 e versões posteriores requerem Java 17 de 64 bits ou posterior. Siga os passos abaixo para instalar o OpenJDK 17 e o JSVC.

 

Instalar o OpenJDK 17

Etapa 1. Atualize as fontes do apt.

sudo apt update

Etapa 2. Instale o OpenJDK-17 com o comando.

sudo apt install -y openjdk-17-jre-headless

Etapa 3. Verifique a versão do Java.

versão java

Etapa 4. Instale as dependências do JSVC.

sudo apt install -y jsvc

Etapa 5. Verifique a versão do JSVC (a versão 1.0.15 é recomendada).

versão jsvc

 

Para o Controlador de Software Omada v5.15.20 e versões anteriores

O Omada Software Controller v5.15.20 e versões anteriores são compatíveis com Java 8 de 64 bits e versões superiores. Você pode instalar o OpenJDK 8 ou o OpenJDK 11, de acordo com suas necessidades.

 

Instalar o OpenJDK 8

Passo 1. Instale o OpenJDK-8 com o comando.

sudo apt install –y openjdk-8-jre-headless

Etapa 2. Instale o JSVC para OpenJDK 8 com o comando.

sudo apt install jsvc

 

Instalar o OpenJDK 11

Passo 1. Instale o OpenJDK-11 com o comando.

sudo apt install –y openjdk-11-jre-headless

Etapa 2. Instale as dependências do JSVC.

sudo apt install autoconf make gcc

Passo 3. Baixe o código-fonte do JSVC do site oficial. Neste exemplo, será utilizada a versão 1.2.4 do JSVC.

wget https://archive.apache.org/dist/commons/daemon/source/commons-daemon-1.2.4-src.tar.gz

tar zxvf commons-daemon-xyz-src.tar.gz

cd commons-daemon-xyz-src/src/native/unix

Etapa 4. Compile e instale

sh support/buildconf.sh./configure --with-java=/usr/lib/jvm/java-11-openjdk-amd64 (caminho padrão do OpenJDK-11-JDK)

Faça

Etapa 5. Crie um link simbólico a partir do seu caminho JSVC:

ln –s /SEU_CAMINHO_ABSOLUTO/commons-daemon-1.2.4-src/src/native/unix/jsvc /usr/bin/

Nota : Você pode consultar o seguinte link para baixar o código-fonte mais recente do JSVC (v1.1.0 e superior):https://archive.apache.org/dist/commons/daemon/source/

 

Instalar o MongoDB

Versão do Controlador de Software Omada

Versões do MongoDB suportadas

Anterior à versão 5.14.20

MongoDB v3.4 ~ v4.4 (até a versão 4.4 do MongoDB)

da versão 5.14.20 até versões anteriores à 5.15.20

MongoDB v4.4 ~ v7 (até MongoDB v7)

v5.15.20 e superior

MongoDB v4.4 ~ v8

Nota:

1. O MongoDB 5.0 e versões posteriores exigem suporte a AVX em CPUs x86_64/amd64. Você pode verificar o suporte a AVX {{amd64-avx}} executando:

sudo cat /proc/cpuinfo | grep avx

Se o AVX for compatível, ele deverá destacar {{avx}}; caso contrário, retornará uma string vazia.

2. Se você já instalou uma versão anterior do MongoDB e deseja atualizá-la, consulte o guia de atualização do MongoDB correspondente à sua versão atual. Não pule versões principais e certifique-se de fazer backup do banco de dados antes de atualizar.

Como atualizar o MongoDB da versão 3.6 para a versão 4.4 | TP-Link

Como atualizar o MongoDB da versão 4.4 para a versão 7 em um sistema Linux | TP-Link

Como atualizar o MongoDB da versão 7 para a versão 8 em um sistema Linux | Suporte da Omada Network

Esta seção fornece exemplos de instalação para o MongoDB v4.4, v7 e v8. Selecione a versão do MongoDB que corresponde à versão do seu Controlador de Software Omada e aos requisitos do sistema.

 

Instalar o MongoDB v4.4

Passo 1. Baixe a dependência Libssl.

No Ubuntu 22.04, a biblioteca libssl1.1 é necessária para instalar o MongoDB v4.4. Se você estiver usando uma versão do Ubuntu anterior à 22.04, ignore os passos 1 e 2.

wget http://archive.ubuntu.com/ubuntu/pool/main/o/openssl/libssl1.1_1.1.1-1ubuntu2.1~18.04.23_amd64.deb

Passo 2. Instale o libssl.

sudo dpkg -i libssl1.1_1.1.1-1ubuntu2.1~18.04.23_amd64.deb

Observação: O link para download será atualizado periodicamente. Você pode consultar o link a seguir para escolher o link de download mais recente : http://archive.ubuntu.com/ubuntu/pool/main/o/openssl/

Etapa 3. Importe a chave GPG pública do MongoDB.

wget -qO - https://www.mongodb.org/static/pgp/server-4.4.asc | sudo apt-key add –

Etapa 4. Crie o arquivo de repositório do MongoDB 4.4 /etc/apt/sources.list.d/mongodb-org-4.4.list usando o comando que corresponde à sua versão do Ubuntu.

  • Para Ubuntu 16.04

echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu xenial/mongodb-org/4.4 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.4.list

  • Para Ubuntu 18.04

echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu bionic/mongodb-org/4.4 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.4.list

  • Para Ubuntu 20.04

echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/4.4 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.4.list

  • Para Ubuntu 22.04

echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/4.4 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.4.list

Etapa 5. Recarregue o banco de dados de pacotes local.

sudo ap update

Etapa 6. Instalar o MongoDB

sudo apt install -y mongodb-org

Observação: você também pode seguir o guia oficial do MongoDB abaixo para instalar o MongoDB :

MongoDB v4.4: https://www.mongodb.com/docs/v4.4/tutorial/install-mongodb-on-ubuntu/

 

Instalar o MongoDB v7

Passo1. Importe a chave pública usada pelo sistema de gerenciamento de pacotes. Em um terminal, instale o gnupg e o curl, caso ainda não estejam disponíveis:

sudo apt-get install gnupg curl

Etapa 2. Importe a chave GPG pública do MongoDB

curl -fsSL https://www.mongodb.org/static/pgp/server-7.0.asc | \\

sudo gpg -o /usr/share/keyrings/mongodb-server-7.0.gpg \\

--desarmadura

Passo 3. Crie o arquivo de repositório do MongoDB 7.0 /etc/apt/sources.list.d/mongodb-org-7.0.list para a sua versão do Ubuntu.

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-7.0.gpg ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/7.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list

Etapa 4. Recarregar o banco de dados de pacotes local:

sudo apt-get update

Etapa 5. Instale os pacotes do MongoDB v7.0.7:

sudo apt-get install -y mongodb-org=7.0.7 mongodb-org-database=7.0.7 mongodb-org-server=7.0.7 mongodb-mongosh=7.0.7 mongodb-org-mongos=7.0.7 mongodb-org-tools=7.0.7

Nota: Você também pode consultar o guia oficial do MongoDB abaixo para obter instruções detalhadas de instalação:

https://www.mongodb.com/docs/manual/tutorial/install-mongodb-on-ubuntu/

 

Instalar o MongoDB v8

Passo1. Importe a chave pública usada pelo sistema de gerenciamento de pacotes. Em um terminal, instale o gnupg e o curl, caso ainda não estejam disponíveis:

sudo apt-get install gnupg curl

Etapa 2. Para importar a chave GPG pública do MongoDB, execute o seguinte comando:

curl -fsSL https://www.mongodb.org/static/pgp/server-8.0.asc | \

sudo gpg -o /usr/share/keyrings/mongodb-server-8.0.gpg \\

--desarmadura

Etapa 3. Crie o arquivo de repositório do MongoDB 8.0 /etc/apt/sources.list.d/mongodb-org-8.0.list para a sua versão do Ubuntu.

  • Para Ubuntu 20.04, crie o arquivo de lista para Ubuntu 20.04 (Focal):

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list

  • Para Ubuntu 22.04, crie o arquivo de lista para Ubuntu 22.04 (Jammy):

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list

  • Para Ubuntu 24.04,Crie o arquivo de lista para Ubuntu 24.04 (Noble):

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list

Etapa 4.Recarregue o banco de dados do pacote.

sudo apt-get update

Etapa 5.Instale o MongoDB Community Server. Você pode instalar a versão estável mais recente do MongoDB ou uma versão específica do MongoDB.

  • Para instalar a versão estável mais recente, execute o seguinte comando:

sudo apt-get install -y mongodb-org

  • Para instalar uma versão específica do MongoDB, especifique o número da versão para cada pacote de componente do MongoDB, conforme mostrado no exemplo a seguir:

sudo apt-get install -y \\

mongodb-org=8.0.12 \\

mongodb-org-database=8.0.12 \

mongodb-org-server=8.0.12 \

mongodb-mongosh \\

mongodb-org-shell=8.0.12 \\

mongodb-org-mongos=8.0.12 \

mongodb-org-tools=8.0.12 \

mongodb-org-database-tools-extra=8.0.12

Nota: Se você instalar apenas o mongodb-org=8.0.12 sem especificar as versões dos pacotes de componentes, a versão mais recente de cada pacote do MongoDB será instalada em vez da versão especificada.

Para obter mais informações, consulte o guia de instalação oficial do MongoDB:

Instalar o MongoDB Community Edition - Manual do Banco de Dados - Documentação do MongoDB

 

Instalar o Controlador de Software Omada

Faça o download do pacote de instalação do Omada Software Controller no site oficial e use o seguinte comando para acessar o diretório onde o pacote de instalação está salvo:

cd <diretório_onde_o_pacote_deb_está_salvo>

Por exemplo:

cd ~/Downloads

em seguida, instale-o usando o seguinte comando:

 

Para o pacote de software deb

sudo dpkg -i Omada_SDN_Controller_v5.xyz_Linux_x64.deb

Nota: Se você estiver usando o OpenJDK 11 ou posterior e o JSVC v1.1.0 ou posterior, instale o Omada Software Controller usando o seguinte comando:

sudo dpkg --ignore-depends=jsvc -i Omada_SDN_Controller_v5.xyz_Linux_x64.deb

 

Para o pacote de software tar.gz

Se você baixou o pacote tar.gz, descompacte-o e execute o script de instalação:

  1. Abaixo, o comando para descompactar o pacote de instalação:

tar zxvf Omada_SDN_Controller_v5.xyz_Linux_x64.tar.gz

  1. Use o seguinte comando para entrar na pasta descompactada:

cd Omada_SDN_Controller_v5.xyz_Linux_x64

  1. Use o comando abaixo para instalar o Controller:

sudo bash ./install.sh

Instale o navegador Chromium (opcional)

O navegador Chromium é uma dependência opcional usada para exportar relatórios em formato PDF. Se você não precisa exportar relatórios como arquivos PDF, pode ignorar esta seção.

Nota:

1. Baixe o pacote Chromium que corresponde à versão do seu sistema operacional. Você pode encontrar os pacotes disponíveis em:

2. A versão do Chromium suportada depende da versão do seu Controlador de Software Omada.

Versão do controlador

Versão do Chromium

Anterior à versão 6.0.0

v90–v128

v6.0.0 e superior

v120–v140

 

Passo 1. Baixe o pacote Chromium Debian do Linux Mint.

Wgethttp://packages.linuxmint.com/pool/upstream/c/chromium/chromium_x.yz~linuxmint1+xxx_amd64.deb

Etapa 2. Instale o Chromium

sudo dpkg -i chromium_x.yz~linuxmint1+xxx_amd64.deb

Etapa 3. Verifique a instalação retornando a versão

Chromium –versão

 

Verificação

Use os seguintes comandos para gerenciar e verificar o status do serviço do Controlador de Software Omada.

Passo 1. Inicie o Controlador Omada

início do tpeap

Etapa 2. Exibir o status do Controlador

status tpeap

Passo 3. Pare de executar o Controlador Omada

tpeap pare

 

Conclusão

Você concluiu a instalação do Controlador de Software Omada em seu sistema Linux. Antes de acessar o controlador, verifique se todas as dependências necessárias, incluindo OpenJDK, MongoDB e JSVC, estão instaladas corretamente e se o serviço do controlador está em execução. Após a verificação da instalação, acesse o controlador por meio de um navegador da web compatível para começar a configurar e gerenciar seus dispositivos Omada.

 

Para saber mais sobre cada função e configuração, visite Página Inicial de Suporte para baixar ou consultar o manual do seu produto.

Por favor, avalie este documento