Como atualizar o MongoDB da versão 4.4 para a versão 7 em um sistema Linux
Conteúdo
Atualizar o MongoDB da v4.4 para a v5
Atualizar o MongoDB da v5 para a v6
Atualizar o MongoDB da v6 para a v7
Aqui apresentamos os comandos que os nossos clientes podem utilizar para atualizar o MongoDB para a versão mais recente em sistemas Linux.
- Ubuntu 20.04, Ubuntu 22.04
- Omada Software Controller
- MongoDB
No sistema Linux, a dependência do MongoDB precisa ser instalada manualmente pelo cliente. O MongoDB possui requisitos estritos de compatibilidade de dados entre versões. Se você precisar atualizar o MongoDB em seu sistema Linux, deverá atualizá-lo versão por versão. Neste artigo, tomamos o Ubuntu 20.04 como exemplo para apresentar os comandos de atualização do MongoDB da v4.4 para a v5, da v5 para a v6 e da v6 para a v7. Você pode utilizar os comandos correspondentes de acordo com a sua necessidade.
Atualizar o MongoDB da v4.4 para a v5
Passo 1. Fazer backup do banco de dados e desinstalar o Controller.
Você pode utilizar os seguintes comandos para desinstalar o Controller:
sudo dpkg -r omadac
Uma janela pop-up será exibida. Escolha Yes.

Escolha Yes

Nota: o arquivo de backup do banco de dados será armazenado em /opt/tplink/omada_db_backup
![]()
Faça uma cópia de segurança do arquivo db.tar.gz em outra pasta para restaurá-lo caso ocorra alguma falha; aqui nós o copiamos para a pasta /Document/dbbackupv4

Passo 2. Desinstalar o MongoDB v4.4
Utilize os seguintes comandos para desinstalar o MongoDB v4.4:
sudo apt remove mongodb-*
Digite y

Utilize o seguinte comando para remover o arquivo mongodb-org-4.4.list
sudo rm /etc/apt/sources.list.d/mongodb-org-4.4.list
Passo 3. Instalar o MongoDB v5
Utilize os seguintes comandos para instalar o MongoDB v5:
curl -fsSL https://www.mongodb.org/static/pgp/server-5.0.asc | \
sudo gpg -o /usr/share/keyrings/mongodb-server-5.0.gpg \
--dearmor

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

sudo apt-get update

sudo apt-get install -y mongodb-org

Passo 4. Reinstalar o Omada Software Controller
Acesse o diretório onde o arquivo deb do Omada Software Controller está armazenado; aqui tomamos o omada_v5.14.26.1_linux_x64_20240621095737.deb como exemplo.
sudo dpkg -i omada_v5.14.26.1_linux_x64_20240621095737.deb

Escolha "yes", o controller importará automaticamente o arquivo de backup do banco de dados localizado em /opt/tplink/omada_db_backup.

Após a instalação, o Controller será iniciado automaticamente.
Passo 5. Alterar a FeatureCompatibilityVersion
Quando o Controller iniciar com sucesso, utilize os seguintes comandos para abrir o Mongo Shell:
mongosh -port 27217

db.adminCommand( { setFeatureCompatibilityVersion: "5.0" } )
![]()
Atualizar o MongoDB da v5 para a v6
Passo 1. Fazer backup do banco de dados e desinstalar o Controller.
Utilize os seguintes comandos para desinstalar o Controller:
sudo dpkg -r omadac
Uma janela pop-up será exibida. Escolha Yes

Escolha Yes

Nota: o arquivo de backup do banco de dados será armazenado em /opt/tplink/omada_db_backup
![]()
Faça uma cópia de segurança do arquivo db.tar.gz em outra pasta para restaurá-lo caso ocorra alguma falha; aqui nós o copiamos para a pasta /Document/dbbackupv5

Passo 2. Desinstalar o MongoDB v5
Utilize os seguintes comandos para desinstalar o MongoDB v5:
sudo apt remove mongodb-*
Digite y

sudo rm /etc/apt/sources.list.d/mongodb-org-5.0.list
Passo 3. Instalar o MongoDB v6
Utilize os seguintes comandos para installar o MongoDB v6:
curl -fsSL https://www.mongodb.org/static/pgp/server-6.0.asc | \
sudo gpg -o /usr/share/keyrings/mongodb-server-6.0.gpg \
--dearmor

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

sudo apt-get update

sudo apt-get install -y mongodb-org

Passo 4. Reinstalar o Omada Software Controller
Acesse o diretório onde o arquivo deb do Omada Software Controller está armazenado; aqui tomamos o omada_v5.14.26.1_linux_x64_20240621095737.deb como exemplo.
sudo dpkg -i omada_v5.14.26.1_linux_x64_20240621095737.deb

Escolha yes, o controller importará automaticamente o arquivo de backup do banco de dados localizado em /opt/tplink/omada_db_backup.

Após a instalação, o Controller será iniciado automaticamente.
Passo 5. Alterar a FeatureCompatibilityVersion
Quando o Controller iniciar com sucesso, utilize os seguintes comandos para abrir o Mongo Shell:
mongosh -port 27217

db.adminCommand( { setFeatureCompatibilityVersion: "6.0" } )
![]()
Atualizar o MongoDB da v6 para a v7
Passo 1. Fazer backup do banco de dados e desinstalar o Controller
Utilize os seguintes comandos para desinstalar o Controller:
sudo dpkg -r omadac
Uma janela pop-up será exibida. Escolha yes

Escolha yes

Nota: o arquivo de backup do banco de dados será armazenado em /opt/tplink/omada_db_backup
![]()
Faça uma cópia de segurança do arquivo db.tar.gz em outra pasta para restaurá-lo caso ocorra alguma falha; aqui nós o copiamos para a pasta /Document/dbbackupv6

Passo 2. Desinstalar o MongoDB v6
Utilize os seguintes comandos para desinstalar o MongoDB v6:
sudo apt remove mongodb-*
Digite y

sudo rm /etc/apt/sources.list.d/mongodb-org-6.0.list
![]()
Passo 3. Instalar o MongoDB v7
Utilize os seguintes comandos para instalar o MongoDB v7:
curl -fsSL https://www.mongodb.org/static/pgp/server-7.0.asc | \
sudo gpg -o /usr/share/keyrings/mongodb-server-7.0.gpg \
--dearmor

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

sudo apt-get update

sudo apt-get install -y mongodb-org

Passo 4. Reinstalar o Omada Software Controller
Acesse o diretório onde o arquivo deb do Omada Software Controller está armazenado; aqui tomamos o omada_v5.14.26.1_linux_x64_20240621095737.deb como exemplo.
sudo dpkg -i omada_v5.14.26.1_linux_x64_20240621095737.deb

Escolha yes, o controller importará automaticamente o arquivo de backup do banco de dados localizado em /opt/tplink/omada_db_backup.

Após a instalação, o Controller será iniciado automaticamente.
Passo 5. Alterar a FeatureCompatibilityVersion
Quando o Controller iniciar com sucesso, utilize os seguintes comandos para abrir o Mongo Shell:
mongosh -port 27217

db.adminCommand( { setFeatureCompatibilityVersion: "7.0", confirm: true } ) 
Após alterar a FeatureCompatibilityVersion, você pode utilizar o seguinte comando para checar o resultado:
db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )
- Se você alterou a FeatureCompatibilityVersion para 5.0, o resultado deve ser:
![]()
- Se você alterou a FeatureCompatibilityVersion para 6.0, o resultado deve ser:
![]()
- Se você alterou a FeatureCompatibilityVersion para 7.0, o resultado deve ser:
![]()
Agora você atualizou com sucesso o seu MongoDB da v4.4 para a v7 no sistema Linux.
Para saber mais detalhes de cada função e configuração, por favor acesse o Centro de Downloads para baixar o manual do seu produto.