복제본 세트에서 호스트 이름 변경

전제 조건

다음 절차는 local 데이터베이스의 system.replset 컬렉션을 읽고 업데이트합니다.

배포서버에서 액세스 제어를 실시하는 경우, 절차를 수행하는 사용자에게는 system.replset 컬렉션에 대한 find 및 update 권한 조치가 있어야 합니다.

필요한 권한을 제공하는 역할을 생성하려면 다음을 수행합니다.

1. userAdminAnyDatabase 역할이 있는 사용자 등 사용자 및 역할을 관리하는 권한이 있는 사용자로 로그인합니다. 다음 절차에서는 액세스 제어 활성화에 생성된 myUserAdmin을 사용합니다.

   mongosh --port 27017 -u myUserAdmin --authenticationDatabase 'admin' -p

2. local 데이터베이스의 system.replset 컬렉션에 필요한 권한을 제공하는 사용자 역할을 생성합니다.

   db.adminCommand( {
      createRole: "systemreplsetRole",
      privileges: [
         { resource: { db: "local", collection: "system.replset" }, actions: ["find","update"] }
      ],
      roles: []
   } );

3. 이름 변경 절차를 수행할 사용자에게 역할을 부여합니다. 예를 들어 다음에서는 admin 데이터베이스에 기존 사용자 "userPerformingRename"가 있다고 가정합니다.

   use admin
   db.grantRolesToUser( "userPerformingRename", [ { role: "systemreplsetRole", db: "admin" } ] );

절차

1. 복제본 세트의 모든 멤버를 중지시킵니다.

2. --replSet 런타임 옵션을 사용하지 않고 다른 포트에서 각 멤버를 다시 시작합니다. 유지 관리 중에 포트 번호를 변경하면 유지 관리를 수행하는 동안 클라이언트가 이 호스트에 연결할 수 없습니다. 멤버의 일반적인 --dbpath를 사용합니다(이 예제에서는 /data/db1). 다음과 유사한 명령을 사용합니다.

   경고

   공개적으로 액세스할 수 있는 IP 주소에 인스턴스를 바인딩하기 전에 무단 액세스로부터 클러스터를 보호해야 합니다. 보안 권장 사항의 전체 목록은 보안 검사 목록을 참조하세요. 최소한으로 인증을 활성화하고 네트워크 인프라를 강화하는 것을 고려하세요.

   mongod --dbpath /data/db1/ --port 37017 --bind_ip localhost,<hostname(s)|ip address(es)>

   중요

   변경된 IP 주소로 인해 구성이 업데이트되는 것을 방지하려면 IP 주소 대신 DNS 호스트 이름을 사용하세요. 특히 복제본 세트 구성원 또는 샤드 클러스터 구성원을 구성할 때 IP 주소 대신 DNS 호스트 이름을 사용하는 것이 중요합니다.

   IP 주소 대신 호스트 이름을 사용하여 분할된 네트워크 범위에 걸쳐 클러스터를 구성합니다. MongoDB 5 부터 시작.0, IP 주소로만 구성된 노드는 시작 유효성 검사에 실패하여 시작되지 않습니다.

3. 복제본 세트의 각 멤버에 대해 다음의 작업 시퀀스를 수행합니다.

   1. mongosh mongod 새 임시 포트에서 실행 중인 에 를 연결합니다. 예를 들어, 임시 포트 에서 실행 중인 멤버의 37017 경우 다음 명령을 실행합니다.

      mongosh --port 37017

      액세스 제어와 함께 실행하는 경우 적절한 권한이 있는 사용자로 연결합니다. 전제 조건을 참조하세요.

      mongosh --port 37017 -u userPerformingRename --authenticationDatabase=admin  -p

   2. 복제본 세트 구성을 수동으로 편집합니다. 복제본 세트 구성은 local 데이터베이스의 system.replset 컬렉션에 있는 유일한 문서입니다.

      
      

      호스트 이름을 변경하려면 복제본 세트 구성을 편집하여 복제본 세트의 모든 멤버에 대한 새 호스트 이름 및 포트를 제공합니다.

      1. local 데이터베이스로 전환하세요.

         use local

      2. 구성 문서에 대한 JavaScript 변수를 생성합니다. _id 필드의 값을 복제본 세트와 일치하도록 수정합니다.

         cfg = db.system.replset.findOne( { "_id": "rs0" } )

      3. 복제본 세트의 각 멤버에 대해 새 호스트 이름과 포트를 제공합니다. 복제본 세트와 일치하도록 호스트 이름과 포트를 수정합니다.

         cfg.members[0].host = "mongodb0.example.net:27017"
         cfg.members[1].host = "mongodb1.example.net:27017"
         cfg.members[2].host = "mongodb2.example.net:27017"

      4. system.replset 컬렉션의 호스트 이름과 포트를 업데이트합니다.

         db.system.replset.updateOne( { "_id": "rs0" }, { $set: cfg } )

      5. 변경 사항을 확인합니다.

         db.system.replset.find( {}, { "members.host": 1 } )

   3. 멤버에 대한 mongod 프로세스를 중지하세요.

4. 세트의 모든 멤버를 다시 구성한 후 일반적인 방법으로 각 mongod 인스턴스를 시작합니다(일반적인 포트 번호 및 --replSet 옵션 사용). 예를 들면 다음과 같습니다.

   경고

   공개적으로 액세스할 수 있는 IP 주소에 인스턴스를 바인딩하기 전에 무단 액세스로부터 클러스터를 보호해야 합니다. 보안 권장 사항의 전체 목록은 보안 검사 목록을 참조하세요. 최소한으로 인증을 활성화하고 네트워크 인프라를 강화하는 것을 고려하세요.

   mongod --dbpath /data/db1/ --port 27017 --replSet rs0 --bind_ip localhost,<hostname(s)|ip address(es)>

5. 을(를) 사용하여 인스턴스 mongod 중 mongosh 하나에 연결합니다. 예를 들면 다음과 같습니다.

   mongosh --port 27017

6. 새 구성을 확인하려면mongosh 에서 rs.conf() 를 호출 .

   출력은 다음과 같아야 합니다.

   {
       "_id" : "rs0",
       "version" : 4,
       "members" : [
           {
               "_id" : 0,
               "host" : "mongodb0.example.net:27017"
           },
           {
               "_id" : 1,
               "host" : "mongodb1.example.net:27017"
           },
           {
               "_id" : 2,
               "host" : "mongodb2.example.net:27017"
           }
       ]
   }