16 de julho de 2026

Modificar os parâmetros de conexão da URL do JDBC no Omnissa Access

Você pode modificar os parâmetros da URL de conexão do JDBC no Omnissa Access para atualizar o nome do host do servidor de banco de dados, o número da porta ou o nome do banco de dados. Normalmente, isso é necessário ao migrar para um novo servidor de banco de dados, alterar as portas do banco de dados para conformidade de segurança ou atualizar as configurações do banco de dados.

Pré-requisitos

Acesso raiz ao dispositivo do Omnissa Access.
Os novos parâmetros de conexão do banco de dados, como nome do host, porta e nome do banco de dados.
Acessibilidade do servidor de banco de dados do dispositivo do Omnissa Access na nova porta

Entender a estrutura da URL do JDBC

A cadeia de caracteres da URL do JDBC no Omnissa Access segue o formato específico para o seu tipo de banco de dados:

Microsoft SQL Server

jdbc:sqlserver://hostname:port;databaseName=database_name

PostgreSQL

jdbc:postgresql://hostname:port/database_name

Localizações dos parâmetros de conexão

nome do host: O FQDN ou o endereço IP do seu servidor de banco de dados
porta: o número da porta TCP
- O padrão é 1433 para o SQL Server.
- O padrão é 5432 para o PostgreSQL.
database_name: o nome do banco de dados do Omnissa Access

Exemplo de URLs do JDBC

SQL Server com porta personalizada: jdbc:sqlserver://dbserver.example.com:14330;databaseName=saasdb
PostgreSQL com porta padrão: jdbc:postgresql://dbserver.example.com:5432/saasdb

Procedimento

Usando um cliente SSH, faça login no dispositivo do Omnissa Access como o usuário raiz.
(Opcional) Verifique a conectividade do banco de dados antes de fazer alterações:
```
/usr/local/horizon/bin/dbConnCheck '<jdbc_url>' '<db_username>' '<encrypted_password>'
```
em que:
- <jdbc_url> é a cadeia de caracteres de conexão do JDBC atual do arquivo runtime-config.properties.
- <db_username> é o nome de usuário do banco de dados (normalmente horizon).
- <encrypted_password> é a senha criptografada do parâmetro secure.datastore.jdbc.password.
  
  Uma conexão bem-sucedida exibe: SUCCESS: Connection verified.
Abra o arquivo de configuração de tempo de execução para edição.
Por exemplo:
```
vi /usr/local/horizon/conf/runtime-config.properties
```
Localize o parâmetro da URL do JDBC.
O nome do parâmetro varia de acordo com o tipo de banco de dados:
- Para o repositório de dados principal: datastore.jdbc.url=
- Para o repositório de dados do SAAS: saas.datastore.jdbc.url=
Modifique a cadeia de caracteres da URL do JDBC para atualizar os parâmetros de conexão:
- Para alterar o número da porta:
  - Localize o número da porta após o nome do host (exemplo :1433).
  - Substitua pelo novo número de porta (exemplo :14330).
- Para alterar o nome do host:
  - Substitua a parte do nome do host pelo novo FQDN ou endereço IP do servidor.
- Para alterar o nome do banco de dados, atualize o nome apropriado do banco de dados, como:
  - SQL Server: o parâmetro databaseName=
  - PostgreSQL: o nome do banco de dados após o / final
    
    Exemplo de alteração:
    
    De:
```
datastore.jdbc.url=jdbc:sqlserver://oldserver.example.com:1433;databaseName=saasdb
```
Para:
```
datastore.jdbc.url=jdbc:sqlserver://newserver.example.com:14330;databaseName=saasdb
```
Verifique se a URL completa do JDBC está correta, incluindo os seguintes detalhes:
- Prefixo do protocolo (jdbc:sqlserver:// ou jdbc:postgresql://)
- Nome do host ou endereço IP
- Número da porta correto
- Nome correto do banco de dados
- Sintaxe adequada para o seu tipo de banco de dados
Se você também estiver alterando a senha do banco de dados, atualize o parâmetro de senha no mesmo arquivo:
```
secure.datastore.jdbc.password=encrypted_password
```
Nota: consulte Atualizar manualmente a senha do banco de dados externo e atualizar a propriedade da senha do JDBC no Omnissa Access para obter instruções sobre criptografia de senha.
Salve o arquivo runtime-config.properties.
Antes de reiniciar, verifique a conectividade de rede com o novo servidor de banco de dados e a porta:
```
telnet new_hostname new_port_number
```
Ou:
```
nc -zv new_hostname new_port_number
```
Reinicie o serviço do Omnissa Access para aplicar as alterações:

service horizon-workspace restart

Verifique se o serviço é iniciado com êxito verificando o status do serviço:
```
service horizon-workspace status
```
Monitore os arquivos de log em busca de erros de conexão:
```
tail -f /opt/vmware/horizon/workspace/logs/horizon.log
```
Para implantações agrupadas em cluster, repita todas as etapas anteriores neste procedimento em todos os nós no cluster Omnissa Access.

Verificação

Faça login no console de administração do Omnissa Access.
Navegue até o Dashboard para verificar a integridade do sistema.
Confirme se a conectividade do banco de dados está funcionando corretamente.
Teste a autenticação do usuário e o acesso a recursos.

Solução de problemas

Se o serviço não for iniciado após fazer alterações:

Verifique se a sintaxe da URL do JDBC está correta para o seu tipo de banco de dados.
Confirme se as regras de firewall permitem a conectividade na nova porta.
Verifique se o servidor do banco de dados está escutando na porta especificada.
Revise /opt/vmware/horizon/workspace/logs/horizon.log para as mensagens de erro específicas.
Verifique se as credenciais do banco de dados ainda são válidas.

Tópicos relacionados

Esta página foi útil?