Omnissa Access에서 JDBC URL 연결 매개 변수 수정

Omnissa Access에서 JDBC URL 연결 매개 변수 수정하여 데이터베이스 서버 호스트 이름, 포트 번호 또는 데이터베이스 이름을 업데이트할 수 있습니다. 이 작업은 일반적으로 새 데이터베이스 서버로 마이그레이션하거나, 보안 규정 준수를 위해 데이터베이스 포트를 변경하거나, 데이터베이스 구성을 업데이트할 때 필요합니다.

사전 요구 사항

Omnissa Access 장치에 대한 루트 액세스 권한
호스트 이름, 포트 및 데이터베이스 이름과 같은 새 데이터베이스 연결 매개 변수
새 포트의 Omnissa Access 장치에서 데이터베이스 서버에 대한 액세스 권한

JDBC URL 구조 이해

Omnissa Access의 JDBC URL 문자열은 다음 데이터베이스 유형과 관련된 형식을 따릅니다.

Microsoft SQL Server

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

PostgreSQL

jdbc:postgresql://hostname:port/database_name

연결 매개 변수 위치

hostname: 데이터베이스 서버의 FQDN 또는 IP 주소
port: TCP 포트 번호
- SQL Server의 경우 기본값은 1433입니다.
- PostgreSQL의 경우 기본값은 5432입니다.
database_name: Omnissa Access 데이터베이스의 이름

JDBC URL 예시

사용자 지정 포트가 있는 SQL Server: jdbc:sqlserver://dbserver.example.com:14330;databaseName=saasdb
기본 포트가 있는 PostgreSQL: jdbc:postgresql://dbserver.example.com:5432/saasdb

절차

SSH 클라이언트를 사용하여 Omnissa Access 장치에 루트 사용자로 로그인합니다.
(선택 사항) 변경하기 전에 데이터베이스 연결을 확인합니다.
```
/usr/local/horizon/bin/dbConnCheck '<jdbc_url>' '<db_username>' '<encrypted_password>'
```
여기서 다음이 적용됩니다.
- <jdbc_url>: runtime-config.properties 파일의 현재 JDBC 연결 문자열입니다.
- <db_username>: 데이터베이스 사용자 이름입니다(일반적으로 horizon).
- <encrypted_password>: secure.datastore.jdbc.password 매개 변수의 암호화된 암호입니다.
  
  연결이 성공하면 다음과 같은 메시지가 표시됩니다. SUCCESS: Connection verified
편집을 위해 런타임 구성 파일을 엽니다.
예:
```
vi /usr/local/horizon/conf/runtime-config.properties
```
JDBC URL 매개 변수를 찾습니다.
매개 변수 이름은 데이터베이스 유형에 따라 다릅니다.
- 기본 데이터스토어의 경우: datastore.jdbc.url=
- SAAS 데이터스토어의 경우: saas.datastore.jdbc.url=
JDBC URL 문자열을 수정하여 연결 매개 변수를 업데이트합니다.
- 포트 번호를 변경하려면 다음을 수행합니다.
  - 호스트 이름 뒤에 있는 포트 번호를 찾습니다(예: :1433).
  - 새 포트 번호로 바꿉니다(예: :14330).
- 호스트 이름을 변경하려면 다음을 수행합니다.
  - 호스트 이름 부분을 새 서버 FQDN 또는 IP 주소로 바꿉니다.
- 데이터베이스 이름을 변경하려면 다음과 같이 적절한 데이터베이스 이름을 업데이트합니다.
  - SQL Server:databaseName= 매개 변수
  - PostgreSQL: 최종 / 다음에 나오는 데이터베이스 이름
    
    변경 예시:
    
    시작:
```
datastore.jdbc.url=jdbc:sqlserver://oldserver.example.com:1433;databaseName=saasdb
```
끝:
```
datastore.jdbc.url=jdbc:sqlserver://newserver.example.com:14330;databaseName=saasdb
```
다음 세부 정보를 포함하여 전체 JDBC URL이 올바른지 확인합니다.
- 프로토콜 접두사(jdbc:sqlserver:// 또는 jdbc:postgresql://)
- 올바른 호스트 이름 또는 IP 주소
- 올바른 포트 번호
- 올바른 데이터베이스 이름
- 데이터베이스 유형의 적절한 구문
데이터베이스 암호도 변경하는 경우 동일한 파일에서 암호 매개 변수를 업데이트합니다.
```
secure.datastore.jdbc.password=encrypted_password
```
참고: 암호 암호화 지침에 대해서는 외부 데이터베이스 암호를 수동으로 업데이트하고 Omnissa Access에서 JDBC 암호 속성 업데이트를 참조하십시오.
runtime-config.properties 파일을 저장합니다.
다시 시작하기 전에 새 데이터베이스 서버 및 포트에 대한 네트워크 연결을 확인합니다.
```
telnet new_hostname new_port_number
```
또는:
```
nc -zv new_hostname new_port_number
```
Omnissa Access 서비스를 다시 시작하여 변경 사항을 적용합니다.

service horizon-workspace restart

서비스 상태를 검토하여 서비스가 성공적으로 시작되는지 확인합니다.
```
service horizon-workspace status
```
로그 파일에서 연결 오류가 있는지 모니터링합니다.
```
tail -f /opt/vmware/horizon/workspace/logs/horizon.log
```
클러스터링된 배포의 경우 Omnissa Access 클러스터의 모든 노드에서 이 절차의 모든 이전 단계를 반복합니다.

검증

Omnissa Access 관리 콘솔에 로그인합니다.
대시보드로 이동하여 시스템 상태를 확인합니다.
데이터베이스 연결이 제대로 작동하는지 확인합니다.
사용자 인증 및 리소스 액세스를 테스트합니다.

문제 해결

변경 후 서비스가 시작하지 못하는 경우:

데이터베이스 유형에 맞는 JDBC URL 구문을 사용했는지 확인합니다.
방화벽 규칙이 새 포트에 대한 연결을 허용하는지 확인합니다.
데이터베이스 서버가 지정된 포트에서 수신 중인지 확인합니다.
/opt/vmware/horizon/workspace/logs/horizon.log에서 특정 오류 메시지를 검토합니다.
데이터베이스 자격 증명이 여전히 유효한지 확인합니다.