P XAPI 클라이언트 인터페이스

이 장에서는 ACSLS에 대한 XAPI 클라이언트 인터페이스를 소개합니다.

ACSLS 서버에 대한 XAPI 클라이언트 인터페이스

XAPI(XML API)는 StorageTek 클라이언트 및 서버가 TCP/IP를 통한 일반 프로토콜을 사용하여 통신할 수 있는 API입니다. ACSLS 8.4 이상 릴리스는 XAPI 지원과 함께 구성될 수 있습니다.

MVS 기반 서버(실제 테이프의 경우 HSC 및/또는 가상 테이프의 경우 VTCS)를 사용해야 했던 클라이언트는 이제 ACSLS를 사용하여 StorageTek 라이브러리를 관리할 수 있습니다.

XAPI 및 XCMD 구성, 관리 및 운영자 명령과 지원되는 XAPI 사용자 요청 및 ACSLS XAPI 컨트롤 변수에 대한 자세한 내용은 ELS 설명서 세트에 있는 StorageTek Enterprise Library Software XAPI Client Interface to ACSLS Server 설명서를 참조하십시오.

ACSLS XAPI 서비스

ACSLS XAPI 서비스 설치 및 설치 해제 절차는 StorageTek ACSLS 8.4 Installation Guide를 참조하십시오.

설치되면 ACSLS를 사용하여 XAPI 구성 요소가 시작되고 중지됩니다.

  • XAPI 서비스와 함께 ACSLS를 시작하려면 Unix 명령 프롬프트에 다음을 입력합니다.

    acsss enable
    
  • ACSLS 및 XAPI 서비스를 중지하려면 Unix 명령 프롬프트에 다음을 입력합니다.

    acsss disable
    
  • ACSLS, XAPI 서비스, ACSLS 데이터베이스 및 모든 ACSLS 구성 요소를 중지하려면 Unix 명령 프롬프트에 다음을 입력합니다.

    acsss shutdown
    

XAPI 변수

ACSLS acsss_config 또는 dv_config 유틸리티를 사용하여 ACSLS XAPI 정적 변수를 표시하고 설정합니다.

변경사항을 적용하려면 ACSLS를 다시 시작해야 합니다.

  • dv_config

    • dv_config -d - 모든 ACSLS 변수를 표시합니다.

    • dv_config -p <variable_name> - XAPI 변수를 업데이트합니다.

    ACSLS 동작을 제어하는 변수 설정을 참조하십시오.

  • acsss_config

    옵션 9를 선택하여 XAPI 변수를 표시하고 변경합니다. 이 옵션은 XAPI 서버가 설치된 경우에만 표시됩니다.

    ACSLS Feature Configuration
    
    Enter the number followed by Return for your choice from the following menu to configure product behavior in that area.
    
    Press ? followed by the Return key for help.
    
       1: Set CSI tuning variables
       2: Set event logging variables
       3: Set general product behavior variables
       4: Set access control variables
       5: Set automatic backup parameters
       6: Rebuild Access Control information
       7: Event Notification settings
       8: Define or Change Library Configuration
       9: Set XAPI server variables
       E: Exit
    
    Menu choice: 
    

XAPI 변수는 다음과 같습니다.

  • XAPI_PORT

    프롬프트: XAPI 서버에 대한 사용자 정의 인바운드 포트 변경사항은 XAPI 서버를 다시 시작해야 적용됩니다. 수신 XAPI 요청을 받기 위해 XAPI 서버에서 사용되는 포트 번호입니다. [50020]:

    이 옵션은 클라이언트의 TCP 요청 수신을 위해 XAPI 서버에서 사용되는 포트를 지정합니다. XAPI 서버에서 사용되는 포트를 정의하려면 1024에서 65535 사이의 숫자를 입력하십시오. 포트 50003은 지정하지 마십시오.

    이 변수를 적용하려면 XAPI 서버를 다시 시작해야 합니다.

  • XAPI_WORK_PATH

    프롬프트: XAPI 작업 디렉토리 변경사항은 XAPI 서버를 다시 시작해야 적용됩니다. XAPI 로그 및 추적 정보를 [$ACS_HOME/log/xapi] 디렉토리에 배치합니다.

    XAPI 서버 작업 파일이 배치되는 디렉토리를 선택하십시오. 설치되면 XAPI 서버가 정보를 $ACS_HOME/log/xapi 디렉토리에 기록합니다. 일반적인 사용에서 이 변수의 값은 변경되지 않습니다. $ACS_HOME을 포함하는 파일 시스템에 디스크 공간 문제가 있는 경우 대체 경로를 지정할 수 있습니다. 지정된 경로가 절대 경로여야 합니다(/ 또는 $ACS_HOME으로 시작되는 경로).

    이 변수를 적용하려면 XAPI 서버를 다시 시작해야 합니다.

  • XAPI_LOG_SIZE

    프롬프트: XAPI 로그 크기 변경사항은 XAPI 서버가 다시 시작될 때까지 적용되지 않습니다. 최대 XAPI 로그 크기(MB)입니다. [20]:

    이 옵션에서는 MB로 표현된 XAPI 로그에 대한 임계값 크기를 지정합니다(여기서는 "1048576바이트"로 정의됨). 음수가 아닌 숫자를 입력하십시오. 이 옵션의 기본값은 20입니다.

    이 변수를 적용하려면 XAPI 서버를 다시 시작해야 합니다.

  • XAPI_LOG_FILE_NUM

    프롬프트: 보존할 XAPI 로그 아카이브 파일 수입니다. [10]:

    이 옵션에서는 보존할 아카이브된 XAPI 로그 파일 수를 지정합니다. 현재 vlog.file 크기가 임계값 크기를 초과하면 해당 로그 파일은 0-n 접미사가 붙은 이름으로 바뀝니다. 0은 가장 최근 파일이며, n은 가장 오래된 파일입니다. 아카이브된 파일은 API_WORK_PATH 디렉토리에 저장됩니다. 지정된 아카이브된 로그 수에 도달하는 경우 새 파일이 아카이브 디렉토리에 추가될 때마다 가장 오래된 파일이 이 디렉토리에서 제거됩니다. 1개에서 99개 사이의 아카이브된 파일을 보존할 수 있습니다. 보존할 아카이브된 로그 파일 수를 지정하려면 1에서 99 사이의 숫자를 입력하십시오.

    이 변수를 적용하려면 XAPI 서버를 다시 시작해야 합니다.

  • XAPI_TRACE_SIZE

    프롬프트: XAPI 추적 크기 변경사항은 xapi 서버를 다시 시작해야 적용됩니다. 최대 XAPI 추적 크기(MB)입니다. [50]:

    이 옵션은 XAPI 추적에 대한 임계값 크기(MB)를 지정합니다(여기서는 "1048576바이트"로 정의됨). 음수가 아닌 숫자를 입력하십시오. 이 옵션의 기본값은 50입니다.

    이 변수를 적용하려면 XAPI 서버를 다시 시작해야 합니다.

  • XAPI_TRACE_FILE_NUM

    프롬프트: 보존할 XAPI 추적 아카이브 파일 수입니다. [10]:

    이 옵션에서는 보존할 아카이브된 XAPI 추적 파일 수를 지정합니다. 현재 vtrace.file 크기가 임계값 크기를 초과하면 해당 추적 파일은 0-n 접미사가 붙은 이름으로 바뀝니다. 0은 가장 최근 파일이며, n은 가장 오래된 파일입니다. 아카이브된 파일은 XAPI_WORK_PATH 디렉토리에 저장됩니다. 지정된 아카이브된 로그 수에 도달하는 경우 새 파일이 아카이브 디렉토리에 추가될 때마다 가장 오래된 파일이 이 디렉토리에서 제거됩니다. 1개에서 99개 사이의 아카이브된 파일을 보존할 수 있습니다. 보존할 아카이브된 로그 파일 수를 지정하려면 1에서 99 사이의 숫자를 입력하십시오.

    이 변수를 적용하려면 XAPI 서버를 다시 시작해야 합니다.

  • XAPI_STARTUP_FILE

    프롬프트: XAPI 시작 파일 이름 변경사항은 XAPI 서버를 다시 시작해야 적용됩니다. 컨트롤 매개변수가 있는 XAPI 시작 파일의 이름입니다. [xapi_startup_file]:

    이 옵션은 XPI 시작 파일의 이름을 지정합니다. 이 파일은 XAPI_WORK_PATH 디렉토리에 있으며 XAPI 시작 매개변수를 포함합니다.

    이 변수를 적용하려면 XAPI 서버를 다시 시작해야 합니다.

  • XAPI_TAPEPLEX_NAME

    프롬프트: XAPI Tapeplex 이름 변경사항은 XAPI 서버를 다시 시작해야 적용됩니다. XAPI Tapeplex의 이름입니다. [ ]:

    이 옵션에서는 XAPI Tapeplex의 이름을 지정합니다. 이 변수를 적용하려면 XAPI 서버를 다시 시작해야 합니다.

    8자를 초과하지 않는 텍스트를 입력하십시오.