지침 기반 패키지의 콘텐츠 지정
지침 기반 패키지를 만들기 위한 사전 요구 사항과
패키지 만들기의 1~6단계를 완료한 후 다음을 수행하여 지침 기반 패키지에 대한 콘텐츠를 지정하십시오.
1. 패키지 만들기 페이지에서 지침 기반 패키지 탭을 선택합니다.
2. 자산에 배달할 지침 유형을 선택하려면 지침 추가를 클릭합니다.
3. 지침 유형 목록에서 다음 지침 중 하나를 선택한 다음 연관된 단계를 완료합니다. 각 지침 유형에 대한 세부 정보는 이 절차 다음에 나오는 섹션에 나와 있습니다.
4. 지침을 추가하려면 3단계를 반복합니다. 단일 지침 기반 패키지에 여러 지침을 추가할 수 있습니다.
5. 다음 세부 정보를 제공하는 지침 목록의 지침을 검토합니다.
◦ 순서 - 에이전트에서 지침이 실행되는 순서를 지정합니다.
◦ 유형 - 지침의 유형을 지정합니다.
◦ 세부 정보 - 지침을 만들 때 지정한 지침의 세부 정보를 지정합니다.
목록에서 지침을 선택하고 다음 옵션 중 하나를 사용하여 지침을 수정합니다.
◦ 지침을 편집하려면

을 클릭합니다.
◦ 지침의 순서를 다시 지정하려면

또는

을 클릭합니다.
|
|
목록에 재시작 지침이 하나만 있고 재시작 지침이 마지막 지침인지 확인하십시오.
|
◦ 지침을 삭제하려면

을 클릭합니다.
6. 저장을 클릭하여 패키지를 저장합니다.
다음 섹션에서는 각 지침 유형을 정의하는 세부 정보를 설명합니다.
다운로드
에이전트에 다운로드하려는 파일을 ThingWorx 저장소에서 선택하려면 다음 단계를 완료하십시오.
1. 대상 저장소 필드에는 다운로드를 위해 구성된 대상 저장소가 표시됩니다. 대상 다운로드 저장소를 변경하려면

을 클릭한 다음

을 클릭합니다.
대상 다운로드 저장소 구성에 대한 자세한 내용은
배포 설정을 참조하십시오.
2. 디렉터리 구조 및 디렉터리 콘텐츠 창에 선택한 저장소의 콘텐츠가 표시됩니다. 이러한 창을 사용하여 자산으로 다운로드하려는 스크립트 파일로 이동합니다.
디렉터리 콘텐츠 창의 각 파일에 대해 다음 정보가 제공됩니다.
◦ 이름 - 파일 이름과 확장자를 지정합니다. 파일이 저장소에 업로드되면 파일 이름에 타임스탬프(Epoch 시간)가 추가됩니다. 이 타임스탬프는 동일한 이름을 가진 두 개의 파일을 구분합니다.
◦ 업로드 날짜 - 파일이 ThingWorx 저장소에 추가된 날짜와 시간을 지정합니다.
◦ 크기 - 파일의 크기(바이트)를 지정합니다.
◦ 경로 - ThingWorx 저장소에 있는 파일의 절대 경로를 지정합니다.
3. 디렉터리 콘텐츠 창에서 스크립트 파일을 선택하여 선택한 콘텐츠 파일 이름 필드에 해당 이름을 표시합니다.
디렉터리 콘텐츠 섹션에서 다음 작업을 수행할 수 있습니다.
◦ 자산으로 배달하려는 파일을 선택한 저장소에서 찾을 수 없으면

을 클릭하여
ThingWorx 저장소에 파일을 업로드합니다.
◦ 저장소에서 파일을 삭제하려면

을 클릭합니다.
4. 대상 디렉터리 필드에 파일을 다운로드할 자산의 위치를 지정합니다.
5. 대상 디렉터리 필드에 절대 경로를 제공한 경우 대상 디렉터리는 절대값입니다 확인란을 선택합니다.
6. 파일을 다운로드한 후 자산에서 해당 파일의 압축을 풀도록 하려면 에이전트가 다운로드 후 이 파일의 압축을 풀 것입니다 확인란을 선택합니다.
|
|
eMessage 에이전트는 tar.gz 형식의 파일만 추출할 수 있습니다.
다른 형식의 파일을 추출하려면 추출 실행 파일과 함께 패키지에 실행 지침을 추가하십시오.
|
7. 파일을 지정한 디렉토리로 다운로드할 때 기존 파일을 덮어쓰려면 이 파일이 주어진 디렉터리로 다운로드되면 기존 파일을 덮어 씁니다 확인란을 선택합니다.
8. 지침 목록에 지침을 추가하려면 추가를 클릭합니다.
실행
원격 사물에서 명령을 실행하는 실행 지침을 정의하려면 다음 단계를 완료하십시오.
1. 실행 파일 필드에 실행하려는 명령을 입력합니다.
2. 인수 필드에 실행 파일 필드에서 정의한 명령의 인수를 지정합니다. 이 필드는 선택 사항입니다.
|
|
실행된 명령은 실행 파일과 인수 필드 값의 조합입니다.
|
3. 실행 파일의 경로가 절대 경로인 경우 실행 파일 경로는 절대값입니다 확인란을 선택합니다.
4. 실행하는 동안 명령이 비동기적이거나 서로 독립적으로 실행되도록 하려면 이 명령을 비동기적으로 실행 확인란을 선택합니다. 실행은 기본적으로 동기적으로 수행됩니다.
5. 지침 목록에 지침을 추가하려면 추가를 클릭합니다.
스크립트 등록
하나 이상의 자산에 배포할 수 있는 스크립트로 Axeda Agent에 대한 지침을 추가하려면 다음 단계를 완료하십시오. 스크립트를 등록한 후 다음을 수행할 수 있습니다.
• 하나의 자산 또는 여러 자산에 대해 실행할 지침의 유효성을 검사할 수 있습니다.
• 등록한 스크립트 이름을 사용하여 동일한 자산 또는 여러 자산에 대해 스크립트를 여러 번 실행할 수 있습니다.
1. 스크립트 파일 필드에 등록할 파일의 절대 경로를 입력합니다.
|
|
유효성 검사 오류가 발생할 경우 파일 경로에 접두사나 접미어로 입력된 공백이 있는지 확인하십시오.
|
2. 스크립트 이름 필드에 지침으로 추가할 스크립트 이름을 입력합니다.
3. 지침 목록에 지침을 추가하려면 추가를 클릭합니다.
재시작
에이전트를 재시작하기 위한 지침을 정의하려면 다음 단계를 완료하십시오.
1. 현재 에이전트 프로세스를 종료하고 새 에이전트 프로세스를 시작하려면 하드 재시작. 소프트 재시작 선택 취소 확인란을 선택 취소합니다.
현재 에이전트 프로세스를 종료하지 않고 모든 구성 요소를 다시 초기화한 후 디스크에서 데이터를 다시 로드하려면 하드 재시작. 소프트 재시작 선택 취소 확인란을 선택 취소합니다.
2. 지침 목록에 지침을 추가하려면 추가를 클릭합니다.
|
|
재시작 지침이 지침 목록의 마지막 지침인지 확인합니다.
|
스크립트 실행
하나 이상의 자산에 배포할 수 있는 등록된 스크립트를 실행하기 위한 Axeda Agent용 지침을 정의하려면 다음 단계를 완료하십시오.
1. 스크립트 이름 필드에 실행할 스크립트 이름을 입력합니다.
2. 지침 목록에 지침을 추가하려면 추가를 클릭합니다.
속성 설정
원격 자산에 지정된 속성 값을 설정하는 지침을 정의하려면 다음 단계를 완료하십시오.
1. 속성 이름 및 속성 값 필드에 속성의 이름과 값을 지정합니다.
|
|
속성 이름은 ThingWorx Composer의 사물 속성 이름입니다. 속성 설정 지침이 작동하려면 사물 속성 이름을 원격 속성 이름에 올바르게 매핑해야 합니다. 원격 속성 이름이 자산으로 전송됩니다.
사물 속성이 원격으로 구성되지 않았거나 지정된 사물 속성이 누락된 경우 배포가 부적격으로 표시됩니다.
|
2. 지침 목록에 지침을 추가하려면 추가를 클릭합니다.
스크립트 등록 취소
하나 이상의 자산에 대해 스크립트를 등록 취소하기 위한 Axeda Agent용 지침을 정의하려면 다음 단계를 완료하십시오.
1. 스크립트 이름 필드에 등록을 취소할 스크립트 이름을 입력합니다.
2. 지침 목록에 지침을 추가하려면 추가를 클릭합니다.
업로드
Axeda eMessage 에이전트가 ThingWorx 플랫폼에 하나 이상의 파일을 업로드하도록 지침을 정의하려면 다음 단계를 완료하십시오.
1. 대상 저장소 필드에서

을 클릭하여 파일을 업로드할 저장소를 선택합니다.
UploadRepository와 같이 업로드 전용 파일 저장소를 만들 수 있습니다.
2. 대상 경로 필드에 업로드된 파일을 저장할 저장소의 위치를 지정합니다.
예: /UploadFiles를 입력하면 파일이 /UploadRepository/UploadFiles 디렉터리에 저장됩니다.
/를 입력하면 업로드된 파일이 1단계에서 정의한 저장소에 저장됩니다.
|
|
파일은 파일을 업로드한 사물의 이름을 따서 지정된 디렉터리에 저장됩니다. 이 디렉터리는 대상 저장소 또는 대상 경로 필드의 값 아래에 위치합니다.
예를 들어, 패키지가 MyThing 사물에 배포되고 대상 저장소 및 대상 경로 필드의 값이 /UploadRepository/UploadFiles일 경우, 파일이 /UploadRepository/UploadFiles/MyThing 디렉터리에 업로드됩니다.
|
|
|
대상 경로 필드에 지정된 위치가 없을 경우 배포 과정에서 대상 저장소 아래에 위치가 생성됩니다.
|
3. 업로드할 파일 필드에 업로드할 파일의 이름을 입력하고

을 클릭합니다. 이 파일이 사용자 장치의 상대 경로에 존재하는지 확인하십시오.
패키지가 성공적으로 배포된 후 저장소에서 파일을 삭제하려면

을 클릭하기 전에
업로드 후 파일 삭제 확인란을 선택합니다.
파일 이름에 * 또는 ?와 같은 와일드카드를 사용할 수 있습니다. 여러 문자를 나타내려면 *를 사용하고 단일 문자를 나타내려면 ?를 사용합니다. Windows에서 실행되는 에이전트의 경우 ? 문자는 * 문자와 동일한 결과를 반환합니다.
4. 업로드할 파일 필드 아래의 테이블에는 업로드 후 파일 삭제 상태와 함께 ThingWorx Platform으로 업로드할 파일 목록이 표시됩니다. 이 테이블에서 다음 작업을 수행할 수 있습니다.
◦ 목록에서 파일을 제거하려면 항목을 목록에서 선택한 후 제거(Remove)를 클릭합니다. 모든 파일을 선택하려면 파일 이름 옆에 있는 도구 모음에서 확인란을 선택합니다.
◦ 파일의
업로드 후 파일 삭제 상태를 변경하려면

을 클릭하고 필요에 따라
업로드 후 파일 삭제 확인란을 선택하거나 선택 취소합니다.
5. 지침 목록에 지침을 추가하려면 추가를 클릭합니다.