통합 노드를 시작할 때의 문제점 해결

여기에 제공된 권고를 사용하여 통합 노드를 시작할 때 발생할 수 있는 공통 문제점을 해결하는 데 도움을 받으십시오.

태스크 정보

mqsistart 명령을 사용하여 통합 노드를 시작하면 mqsicvp 명령이 자동으로 실행되어 환경이 올바르게 설정되었는지 확인합니다 (예를 들어, Java™ 의 설치된 레벨이 지원됨). Linux® 및 UNIX에서 mqsicvp 명령은 ODBC 환경 (지정된 경우) 이 올바르게 구성되었는지도 확인합니다. 자세한 정보는 mqsicvp 명령을 참조하십시오.

통합 노드를 시작할 때 발생할 수 있는 특정 문제점에 대한 조언은 다음 절을 참조하십시오.

Java TMPDIR 디렉토리에 충분한 공간이 없거나 Java TMPDIR 디렉토리에 대한 액세스 권한이 충분하지 않으므로 통합 노드가 시작되지 않습니다.

프로시저

  • 시나리오: 통합 노드가 시작되지 않고 오류 메시지가 사용 가능한 공간이 충분하지 않음을 표시하거나 BIP4512 예외가 스택 추적에서 java.lang.NoClassDefFoundError 를 표시합니다.
  • 설명: 이 오류에는 두 가지 가능한 원인이 있습니다.
    • 통합 노드는 Java JAR 파일을 사용합니다. 통합 노드가 시작되면 Java 런타임 환경은 JAR 파일을 임시 디렉토리인 Java TMPDIR로 추출합니다. Linux및 UNIX 컴퓨터에서 TMPDIR 디렉토리는 일반적으로 /tmp이고, Windows 컴퓨터에서는 c:\temp입니다. 이 디렉토리가 JAR 파일을 보유할 만큼 충분히 크지 않은 경우에는 통합 노드가 시작되지 않습니다.
    • 프로그램이 PAR 파일로 패키지된 경우 사용자는 시스템 임시 디렉토리에 대한 액세스 권한이 있어야 하며 임시 디렉토리에서 적절한 공간을 사용할 수 있어야 합니다.
  • 솔루션: 다음 방법 중 하나를 사용하여 이 임시 JAR 디렉토리의 위치를 지정하십시오.
    • 환경 변수 TMPDIR을 사용하십시오. (통합 서버가 Java11 또는 Java17 를 사용하도록 구성된 경우, 환경 변수 _JAVA_OPTIONS 를 사용하여 JVM 시스템 속성에 java.io.tmpdir 적절한 값을 지정하십시오)
    • JVM 시스템 속성을 설정하려면 다음처럼 java.io.tmpdir 파일의 server.conf.yaml jvmSystemProperty 를 업데이트하십시오:
      jvmSystemProperty: -Djava.io.tmpdir=<path to new location>
    이 디렉터리에서 통합 서버당 최소 50MB의 공간을 IBM® App Connect Enterprise 구성 요소를 위해 확보하십시오. 큰 사용자 정의 노드나 기타 JAR을 통합 노드에 배치하는 경우에는 더 많은 공간이 필요할 수도 있습니다. Compute 노드 클래스의 모든 종속 항목이 통합 노드에 배치되었는지 확인해야 합니다.

Linux 또는 UNIX 에서 두 번째 통합 노드를 시작하려고 할 때 오류 메시지 BIP2228 이 발행됨

프로시저

  • 시나리오: Linux 또는 UNIX에서 두 번째 통합 노드를 시작하려고 할 때 syslog에서 semctl 를 언급하는 오류 메시지 BIP2228이 표시됩니다.
  • 설명: 이 오류는 일반적으로 ` IBM App Connect Enterprise `에서 사용하는 세마포어의 권한 문제로 발생합니다. 세마포어는 시스템 재시작 후에(또는 초기 설치 후에) 첫 번째 통합 노드가 시작되고 세마포어 작성자의 1차 그룹 멤버만 이 세마포어에 액세스할 수 있을 때 작성됩니다. 이 문제는 IBM App Connect Enterprise 에서 사용하는 UNIX System V IPC 기본 기능의 결과입니다.

    BIP2228 메시지는 세마포어 작성자의 1차 그룹 멤버가 아닌 사용자가 시작한 통합 노드를 통해 로그 기록됩니다. 통합 노드는 세마포어에 액세스하려 시도하지만 권한 관련 오류로 실패합니다. 그러면 통합 노드가 BIP2228 메시지와 함께 종료됩니다.

  • 해결 방법: IBM App Connect Enterprise 를 시작하는 데 사용되는 모든 사용자 ID가 동일한 기본 그룹을 가지도록 하여 이 문제를 방지하십시오. 이 조치가 비실용적이면 모든 사용자 ID가 다른 모든 사용자 ID의 1차 그룹 멤버인지 확인하십시오. 추가 도움이 필요한 경우 IBM 지원 센터에 문의하십시오.

통합 노드에서 MQIsdp 클라이언트 연결이 거부됨

프로시저

  • 시나리오: 새 MQIsdp 클라이언트가 통합 노드에 연결을 시도할 때 해당 연결이 거부됩니다.
  • 설명: MQIsdp 클라이언트 ID 필드는 고유해야 합니다. 클라이언트가 동일한 클라이언트 ID를 현재 연결된 클라이언트로 포함한 CONN 패킷을 송신하는 경우 작동이 정의되지 않습니다.
  • 솔루션: 클라이언트 ID가 고유한지 확인하십시오.

오류 메시지 BIP8875는 통합 노드를 시작할 때 발행됩니다.

프로시저

  • 시나리오: 예를 들어 mqsistart 명령을 실행하여 연동 노드를 시작하려고 하지만 연동 노드가 시작되지 않고 시스템 로그에 BIP8875 메시지가 표시됩니다:
    The component verification for INODE has finished, 
but one or more checks failed.
  • 설명: 이 명령어는 통합 노드 환경, IBM MQ 큐, 그리고 Java가 올바르고 접근 가능한지 확인하기 위해 일련의 검사를 수행합니다.
    메시지에 식별된 통합 노드에 대한 하나 이상의 검사가 실패해서 통합 노드가 시작되지 않습니다.
  • 솔루션: Windows의 이벤트 뷰어에서 시스템 로그 또는 애플리케이션 로그를 찾으십시오.
    실패한 검사를 표시하기 위하여 추가 메시지가 이 메시지 앞에 기록되었습니다. 모든 검사는 노드가 시작될 때마다 수행되므로 모든 오류가 로그에 포함됩니다. 명령행에서 명령을 실행할 때에는 일부 메시지가 리턴되기도 합니다.

    보고된 하나 이상의 오류를 조사하고 리턴 코드와 추가 세부사항을 확인하십시오. 전체 메시지 컨텐츠를 확인해서 오류의 일반 원인을 파악하고 로그에 표시된 메시지의 권고를 따르십시오. 진단 메시지 참조 주제에서 전체 메시지 텍스트를 보십시오.

    예를 들어, 하나 이상의 다음 메시지를 볼 수 있습니다.

    • BIP8875W: 'component_name'의 컴포넌트 확인이 완료되었지만 하나 이상의 검사가 실패했습니다.
    • BIP8877W: 컴포넌트 'component_name'의 환경 확인이 완료되었지만 하나 이상의 검사가 실패했습니다.
    • BIP8883W : 구성 요소 'component_name '에 대한 IBM MQ 검증이 완료되었으나 하나 이상의 검사가 실패했습니다.
    • BIP8885E: 확인에 실패했습니다. 큐 관리자 'queue_manager_name'에 연결하지 못했습니다. MQRC: 반환_코드 MQCC: 완료_코드
    • BIP8887E: 'operation' 발행 중 큐 관리자 'queue_manager_name'의 큐 'queue_name'에 대한 확인이 실패했습니다. MQRC: 반환_코드 MQCC: 완료_코드
    • BIP8888E: 확인에 실패했습니다. 큐 관리자 'queue_manager_name' 연결을 끊지 못했습니다. MQRC: 반환_코드 MQCC: 완료_코드
    • BIP8893E: 환경 변수 'variable_name'에 대한 확인에 실패했습니다. 사용자 ID 'user_ID'로 파일 'file_name'에 액세스할 수 없습니다. IBM 지원에 대한 추가 정보: data1 data2.
    • BIP8895E: 확인에 실패했습니다. 환경 변수 'variable_name'은 올바르지 않거나 누락되었습니다.
    • BIP8896E: 확인에 실패했습니다. 사용자 ID 'user_ID'로 레지스트리에 액세스할 수 없습니다. IBM 지원에 대한 추가 정보: data1 data2
    • BIP8897E: 확인에 실패했습니다. 'variable_name' 환경 변수가 컴포넌트 이름 'component_name'에 일치하지 않습니다.
    • BIP8903E: 확인에 실패했습니다. 'file_name' 파일에 대한 APF 권한 검사가 실패했습니다.
    • BIP8904E: 확인에 실패했습니다. 'file_name' 파일을 시작하는 데 실패했습니다(리턴 코드 'return_code' 및 errno 'error_number').

    보고된 문제점을 해결할 수 없고 추가 정보를 포함하는 BIP8893 과 같은 메시지를 수신하는 경우 IBM 서비스에 문의할 때 제공하는 정보에 이러한 항목을 포함시키십시오.

통합 노드를 시작할 때 경고 메시지 BIP8288-BIP8297이 syslog에 표시됩니다.

프로시저

  • 시나리오: Linux 및 UNIX 시스템에서 통합 노드를 시작할 때 경고 메시지 BIP8288-BIP8297 이 syslog에 표시됩니다.
  • 설명: Linux 및 UNIX 시스템의 ODBC 환경에서 하나 이상의 문제점이 발견되었습니다.
    연동 노드를 시작하면 mqsicvp 명령이 자동으로 실행되어 연동 노드 환경이 올바르게 설정되었는지 확인합니다. 켜기 Linux 및 UNIX 시스템에서 이 명령은 ODBC 환경이 올바르게 구성되었는지 확인합니다. 다음의 경우 syslog에 경고 메시지가 기록됩니다.
    • ODBCINI 환경 변수에 참조된 파일이 존재하지 않거나 통합 노드에 파일을 읽거나 쓰기 위한 액세스가 없습니다.
    • ODBCSYSINI 환경 변수가 설정되지 않았습니다.
    • ODBCSYSINI 환경 변수에 참조된 디렉토리에 odbcinst.ini라는 파일이 포함되지 않았거나, 통합 노드에 파일을 읽거나 쓰기 위한 액세스가 없습니다.
    • IE02_PATH가 설정되지 않았습니다.
  • 솔루션: syslog에서 경고 메시지를 검사하십시오. 자세한 정보를 보려면 명령행에서 mqsicvp 명령을 실행하십시오.

통합 노드를 시작하려 시도할 때 오류 메시지 AMQ7626 및 BIP8048이 표시됨

프로시저

  • 설명: Oracle과의 글로벌 조정을 위해 구성된 큐 관리자에서 통합 노드를 사용할 때 이러한 메시지가 표시됩니다.
  • 솔루션: 통합 노드를 시작하기 전에 -si 플래그를 사용하여 큐 관리자를 수동으로 시작하십시오.

통합 노드를 시작하려 시도할 때 오류 메시지 BIP8048 및 BIP8059가 표시됨

프로시저

  • 설명: 연결된 대기열 관리자가 없는 연동 노드를 시작하거나 노드의 연결된 대기열 관리자가 시작되지 않은 경우 이러한 메시지가 표시됩니다.
  • 해결 방법 strmqm 명령을 사용하여 대기열 관리자를 시작한 다음 통합 노드를 시작합니다.