[Confluence Server/Data Center] Heap size 오류로 인한 공동 편집 문제 해결하기

Owned by 구단희, created
Last updated: 2024-02-08 by 심경남
2 min read

 문제

페이지 생성 및 편집 시 무한로딩이 발생하면서 화면이 나타나지 않습니다.
브라우저 캐시 문제로 예상되어 캐시 삭제를 하였으나 일부 사용자는 원활하게 작동되지만 다른 사용자들은 여전히 같은 장애가 발생합니다.

 

 해결책

  1. 오류를 확인하고자 1차적으로 시스템의 공동편집을 확인합니다.

  2. > 시스템 > 관리 - 공동편집 으로 이동합니다.

 

  1. 정확한 확인을 위해 Confluence 로그를 확인해볼 수 있습니다.
    로그에서 아래와 같이 동기화 힙공간과 관련된 오류를 알 수 있습니다.

  1. 정상적인 사용을 위해 원인이 되는 공동편집 기능을 OFF 합니다.

  2. 아래의 힙 사이즈 증량 작업 후 공동편집 기능을 ON 합니다.

  3. 페이지 편집에서 공동편집이 가능한지 확인합니다.

 

아래의 변경 사항을 적용하려면 Confluence의 인스턴스를 다시 시작해야 합니다.

  1. 서버에서 Confluence를 정지합니다.

  2. 해당 디렉토리로 접근합니다.
    Confluence-Installation-Directory/bin.

  3. 서비스 정지 명령어를 실행합니다.
    ./stop-confluence.sh

  4. 서비스 정지 후 힙 사이즈를 할당합니다.

    1. Confluence-Installation-Directory/bin 에서 setenv.sh 파일을 엽니다.

    2. synchrony.memory.max 를 검색합니다. 이 설정이 되어있다면 해당 값을 변경하기만 하면 됩니다.
      설정이 없다면, synchrony에 대한 기본 힙 사이즈가 설정되어있습니다.
      이 설정은 confluence 버전에 따라 상이합니다.

    3. 증량이 필요한 만큼 GB단위로 숫자를 변경합니다.

      CATALINA_OPTS="-Dsynchrony.memory.max=2g ${CATALINA_OPTS}" // -Dsynchrony.memory.max는 GB 또는 MG 형식으로 값을 설정할 수 있습니다. // MG로 설정하는 경우 메모리 수준에 1024를 곱하여 값을 설정합니다. // -Dsynchrony.memory.max=2048m = -Dsynchrony.memory.max=2g.

  5. 힙 사이즈 할당 후 서비스를 재기동 합니다.

    1. 해당 디렉토리로 접근합니다.
      Confluence-Installation-Directory/bin.

    2. 서비스 구동 명령어를 실행합니다.
      ./start-confluence.sh

 

 관련 문서