Linux용 AlloyDB Omni 설치

문서 버전을 선택합니다.

RHEL 9 런타임을 지원하는 Linux 머신 또는 베어메탈 서버에 AlloyDB Omni의 단일 인스턴스를 설치할 수 있습니다.

이 배포 모델을 시작하려면 이 양식을 제출하여 액세스를 요청하세요.

시작하기 전에

AlloyDB Omni를 설치하기 전에 AlloyDB Omni 설치 계획을 읽으세요.

AlloyDB Omni가 데이터를 저장하는 디렉터리 만들기

AlloyDB Omni를 다른 애플리케이션과 함께 실행하는 스토리지 시스템을 사용하는 경우 기기의 기존 파일 시스템에 AlloyDB Omni 디렉터리를 만들 수 있습니다. 그렇지 않으면 전용 기기에 새 파일 시스템을 만들 수 있습니다.

기존 파일 시스템

기존 파일 시스템에 디렉터리를 만들려면 다음 명령어를 실행합니다.

mkdir -p DATA_DIR

다음 변수를 바꿉니다.

  • DATA_DIR: 데이터가 저장된 호스트 디렉터리 경로

전용 기기

전용 파일 시스템에 디렉터리를 만들려면 다음 단계를 실행하세요.

  1. 디스크가 마운트될 호스트에 디렉터리를 만듭니다.

    mkdir -p MOUNT_POINT

    다음 변수를 바꿉니다.

    • MOUNT_POINT: AlloyDB Omni 인스턴스를 포함해야 하는 최상위 디렉터리 경로

  2. gpt 파티션 테이블과 파일 시스템을 만들고 디스크 기기를 마운트합니다.

    EXT4

    parted -s DEVICE_PATH mklabel gpt
parted -s DEVICE_PATH mkpart primary 0% 100%
mkfs.ext4 -q -m 1 -L FS_LABEL -F PARTITION_PATH
echo -e "LABEL=FS_LABEL\tMOUNT_POINT\text4\tdefaults\t0 0" | tee -a /etc/fstab
mount MOUNT_POINT

    다음 변수를 바꿉니다.

    • DEVICE_PATH: 운영체제에서 디스크 기기에 할당한 경로입니다.
    • FS_LABEL: 파일 시스템 라벨입니다. xfs의 최대 길이는 12자(영문 기준)입니다.
    • PARTITION_PATH: 파일 시스템 데이터를 저장하는 데 사용되는 디스크 파티션의 경로

    XFS

    parted -s DEVICE_PATH mklabel gpt
parted -s DEVICE_PATH mkpart primary 0% 100%
dnf install xfsprogs
mkfs.xfs -L FS_LABEL -f PARTITION_PATH
echo -e "LABEL=FS_LABEL\tMOUNT_POINT\txfs\tdefaults\t0 0" | tee -a /etc/fstab
mount MOUNT_POINT

    다음 변수를 바꿉니다.

    • DEVICE_PATH: 운영체제에서 디스크 기기에 할당한 경로입니다.
    • FS_LABEL: 파일 시스템 라벨입니다. ext4의 최대 길이는 16자입니다.
    • PARTITION_PATH: 파일 시스템 데이터를 저장하는 데 사용되는 디스크 파티션의 경로

  3. 이 파일 시스템에 데이터 디렉터리를 만듭니다. 마운트 포인트(예: MOUNT_POINT/17) 내에 DATA_DIR을 하위 디렉터리로 만드는 것이 좋습니다.

    mkdir -p DATA_DIR

    DATA_DIR를 데이터베이스 관련 데이터를 저장할 호스트 디렉터리 경로로 바꿉니다(예: MOUNT_POINT/17).

SELinux 정책 구성

AlloyDB Omni RPM 패키지를 설치하는 동안 AlloyDB Omni 데이터베이스 서비스를 허용하도록 SELinux 정책이 구성되도록 필요한 policycoreutils-python-utils 패키지를 설치합니다.

AlloyDB Omni 설치

  1. 로컬 디렉터리에서 YUM 저장소를 구성합니다.

    sudo tee -a /etc/yum.repos.d/alloydbomni.repo << EOF
[alloydbomni]
name=alloydbomni
baseurl=ALLOYDB_OMNI_URL
enabled=1
repo_gpgcheck=0
gpgcheck=1
gpgkey=https://dl.google.com/linux/linux_signing_key.pub
EOF

$ sudo yum makecache

    ALLOYDB_OMNI_URL을 액세스 권한을 신청한 후 받은 AlloyDB Omni URL로 바꿉니다.

  2. AlloyDB Omni RPM 패키지를 설치합니다.

    sudo dnf install alloydbomni17

  3. AlloyDB Omni 데이터베이스를 초기화하고 구성합니다.

    sudo PGPASSWORD=POSTGRES_PASSWORD PGDATA=DATA_DIR /usr/lib/postgresql/17/bin/alloydbomni17-setup initdb

    원하는 경우 표준 initdb 옵션을 POSTGRES_INITDB_ARGS 변수에 단일 문자열로 전달할 수 있습니다.

  4. AlloyDB Omni 데이터베이스를 준비합니다.

    sudo PGPASSWORD=POSTGRES_PASSWORD /usr/lib/postgresql/17/bin/alloydbomni17-setup preparedb

  5. 선택사항입니다. AlloyDB Omni 서비스의 실행을 최적화하려면 다음 명령어를 실행합니다.

    sudo /usr/lib/postgresql/17/bin/alloydbomni17-setup-host

  6. AlloyDB Omni systemd 서비스를 시작합니다.

    sudo systemctl enable alloydbomni17
$ sudo systemctl start alloydbomni17

  7. AlloyDB Omni 서비스가 정상적으로 실행되고 있는지 확인합니다.

    sudo systemctl status alloydbomni17

    다음은 응답의 예입니다. 상태가 활성 (실행 중)인지 확인합니다.

        Loaded: loaded (/usr/lib/systemd/system/alloydbomni17.service; enabled; preset: disabled)
   Drop-In: /etc/systemd/system/alloydbomni17.service.d
     Active: active (running) since Wed 2025-11-19 07:37:31 UTC; 1 day 6h ago "
   Process: 120228 ExecStartPre=/usr/lib/postgresql/17/bin/alloydbomni17-check-db-dir ${PGDATA} (code=exited, status=0 SUCCESS)
  Main PID: 120231 (postgres)
     Tasks: 19 (limit: 203438)
    Memory: 161.7M (peak: 170.0M)
       CPU: 28min 10.149s
    CGroup: /system.slice/alloydbomni17.service
            ├─120231 /usr/lib/postgresql/17/bin/postgres -D /var/lib/postgresql/17/data
            ├─120232 "postgres: alloydb internal logger "
            ├─120233 "postgres: checkpointer "
            ├─120234 "postgres: background writer "
            ├─120237 "postgres: walwriter "
            ├─120243 "postgres: lux wal preallocator "
            ├─120244 "postgres: autovacuum launcher "
            ├─120246 "postgres: free buffer manager "
            ├─120247 "postgres: buffer control "

다음 단계