지침 기반 패키지 만들기
지침 기반 패키지를 사용하면 에지가 수행해야 하는 지침 집합을 정의하는 패키지를 만들 수 있습니다. eMessage Connector에는 지침 기반 패키지에 대한 지원이 내장되어 있습니다.
 |
이 섹션에서는 지침 기반 패키지를 만들기 위한 사전 요구 사항을 완료했다고 가정합니다.
|
다음 단계를 완료하여 지침 기반 패키지를 만듭니다.
1. ThingWorx Software Content Management의 왼쪽 창에서 패키지 섹션 아래의 > 로 이동합니다.
패키지 만들기 페이지가 표시됩니다.
2. 패키지 이름 필드에 패키지의 이름을 입력합니다.
3. 패키지 설명 필드에 패키지에 대한 간단한 설명을 입력합니다.
4. 버전 필드에 패키지의 버전 번호를 입력합니다.
패키지 버전에 적용되는 규칙은 다음과 같습니다.
◦ 주 패키지 버전 번호를 입력해야 합니다.
◦ 음수가 아닌 정수만 입력할 수 있습니다.
◦ 다음 이미지와 같이 버전 필드의 각 상자에 패키지 버전의 최대 길이 4까지 숫자 문자열을 입력할 수 있습니다.
| | 기본적으로 주 버전 번호는 1로 채워지며 나머지 필드는 0 값을 갖는 것으로 간주됩니다. 다음은 잘못된 값의 예입니다. • 버전 필드의 마지막 필드에 값이 있는 경우 앞의 필드에 대한 빈 값이 유효하지 않게 되며 아래와 같이 빨간색으로 강조 표시됩니다.  필드는 공란으로 비워 두는 대신 빈 필드에 다음 값(또는 임의의 다른 값)을 입력합니다.  • 필드에 음수 값을 입력하면 아래와 같이 해당 필드가 빨간색으로 강조 표시됩니다.  필드에 음수가 아닌 정수만 입력하여 오류를 수정합니다. • 필드에 알파벳 또는 영숫자 문자열을 입력하면 아래와 같이 해당 필드가 빨간색으로 강조 표시됩니다.  필드에 음수가 아닌 정수만 입력하여 오류를 수정합니다. |
5. 패키지에 만료 날짜가 있는지 여부를 나타내려면 만료 필드에서 다음 옵션 중 하나를 선택합니다.
◦ 없음 - 패키지가 만료되지 않습니다. 기본적으로 이 옵션은 만료 날짜를 패키지 작성 날짜로부터 100년 후로 설정합니다.
◦ 날짜 - 날짜 및 시간 선택기 위젯을 사용하여 패키지 만료 시점을 지정합니다.
| | 이름과 버전 번호가 동일한 패키지를 두 개 만들 수 없습니다. 패키지 이름 및 버전이 있다는 메시지가 표시되면 고유한 이름 및 버전 조합을 제공하십시오. |
6. 자산 유형(사물 템플릿)을 패키지에 연결하려면 자산 유형 엔티티 선택기에서 자산 유형을 선택합니다. 기본적으로 이 엔티티 선택기는 ThingWorx Software Content Management 구성에 언급된 구성에 따라 모든 사물 템플릿을 나열합니다.
사용자가 지침 기반 패키지를 수신해야 하는 자산에 대한 사물 템플릿을 선택할 경우 지침 기반 패키지 탭만 표시되고 파일 기반 패키지 탭은 숨겨집니다.
엔티티 선택기에 표시되는 자산 유형도 패키지 유형 구성에 따라 달라집니다. 지침 기반 패키지 유형만 표시되도록 선택한 경우 지침 기반 패키지를 지원하는 템플릿만 엔티티 선택기에 표시됩니다.
7. 지침 기반 패키지 탭을 선택합니다.
8. 지침 추가를 클릭하여 자산에 배달할 지침 유형을 선택합니다.
9. 지침 유형 목록에서 추가하려는 지침에 따라 다음 지침 중 하나를 선택하고 해당 작업을 수행합니다.
지침 | 작업 | ||||||
다운로드 | 에이전트로 다운로드하려는 ThingWorx 저장소의 파일을 선택합니다. 다음 단계를 완료하여 ThingWorx 저장소에서 파일을 추가합니다. a. 대상 저장소 필드에는 배포 구성 페이지에 구성된 다운로드 대상 저장소가 표시됩니다. 구성된 다운로드 저장소를 수정하려면  을 클릭합니다.자세한 내용은 배포 설정을 참조하십시오. b. 디렉터리 구조 섹션에는 선택한 저장소의 콘텐츠가 표시됩니다. 디렉터리 구조 섹션에서 다음 작업을 수행할 수 있습니다. ◦ 자산으로 배달하려는 파일이 선택한 저장소에 없는 경우,  을 클릭하여 ThingWorx 저장소로 파일을 업로드합니다.◦ 파일을 컴퓨터의 기본 다운로드 위치로 다운로드하려면  를 클릭합니다.◦ 저장소에서 파일을 삭제하려면  을 클릭합니다.c. 디렉터리 구조 섹션에서 자산으로 다운로드하려는 스크립트 파일로 이동한 다음, 디렉터리 콘텐츠 섹션에서 파일을 선택하여 선택한 콘텐츠 Zip 파일 이름 필드에 이름을 표시합니다. 디렉터리 콘텐츠 섹션에서 각 파일에 대해 다음 정보를 사용할 수 있습니다. ◦ 이름 - ThingWorx 저장소에서 파일을 사용할 수 있는 경우 확장명을 포함한 파일의 이름을 지정합니다. 파일이 저장소에 업로드되면 파일 이름에 타임스탬프(Epoch 시간)가 추가됩니다. 이 타임스탬프는 동일한 이름을 가진 두 개의 파일을 구분합니다. ◦ 업로드 날짜 - 파일이 ThingWorx 저장소에 추가된 날짜와 시간을 지정합니다. ◦ 크기 - 파일의 크기(바이트)를 지정합니다. ◦ 경로 - ThingWorx 저장소에 있는 파일의 절대 경로를 지정합니다. d. 대상 디렉터리 필드에 파일을 다운로드할 자산의 위치를 지정합니다. e. 대상 디렉터리 필드에 절대 경로를 제공한 경우 대상 디렉터리는 절대값입니다 확인란을 선택합니다. 이 필드는 선택 사항입니다. 기본값으로 이 확인란은 선택되어 있지 않습니다. f. 에지 장치가 파일을 다운로드한 후 파일의 압축을 해제하도록 하려면 에이전트가 다운로드 후 이 파일의 압축을 풀 것입니다 확인란을 선택합니다. 이 필드는 선택 사항입니다. 기본값으로 이 확인란은 선택되어 있지 않습니다.
g. 지정한 디렉터리에 파일을 다운로드할 때 기존 파일을 덮어쓰도록 하려면 이 파일이 주어진 디렉터리로 다운로드되면 기존 파일을 덮어 씁니다 확인란을 선택합니다. 이 필드는 선택 사항입니다. 기본값으로 이 확인란은 선택되어 있지 않습니다. h. 추가를 클릭하여 지침 목록에 지침을 추가합니다. | ||||||
실행 | 원격 사물에서 명령을 실행합니다. a. 실행 파일 필드에 실행하려는 명령을 입력합니다. b. 인수 필드에 실행 파일 필드에서 정의한 명령의 인수를 지정합니다. 이 필드는 선택 사항입니다.
c. 실행 파일의 경로가 절대 경로인 경우 실행 파일 경로는 절대값입니다 확인란을 선택합니다. 기본값으로 이 옵션은 선택되어 있지 않습니다. d. 명령이 실행되는 동안 서로 독립적으로 실행되도록 명령을 비동기적으로 실행하려면 이 명령을 비동기적으로 실행 확인란을 선택합니다. 기본적으로 이 확인란은 선택되어 있지 않으며 명령이 동기적으로 실행됩니다. e. 추가를 클릭하여 지침 목록에 지침을 추가합니다. | ||||||
스크립트 등록 | 지침을 Axeda 에이전트에 대한 자산 또는 여러 자산에 대해 배포할 수 있는 스크립트로 추가할 수 있습니다. 스크립트 등록 단계에 대한 정보는 배포할 스크립트 실행을 참조하십시오. | ||||||
재시작 | 에이전트를 다시 시작합니다. a. 현재 에이전트 프로세스를 종료하고 새 에이전트 프로세스를 시작하려면 하드 재시작. 소프트 재시작 선택 취소 확인란을 선택합니다. 기본값으로 하드 재시작. 소프트 재시작 선택 취소가 선택되어 있습니다. 현재 에이전트 프로세스를 종료하지 않고 모든 구성 요소만 다시 초기화한 후 디스크에서 데이터를 다시 로드하려는 경우에는 하드 재시작. 소프트 재시작 선택 취소 확인란의 선택을 취소해야 합니다. 이를 소프트 재시작이라고 합니다. b. 추가를 클릭하여 지침 목록에 지침을 추가합니다.
| ||||||
스크립트 실행 | Axeda 에이전트에 대한 자산 또는 여러 자산에 대해 배포할 수 있는 등록된 스크립트를 실행할 수 있습니다. 스크립트 실행 단계에 대한 정보는 배포할 스크립트 실행을 참조하십시오. | ||||||
속성 설정 | 원격 에지 장치에 지정된 속성 값을 설정합니다. a. 속성 이름 및 속성 값 필드에 속성의 이름과 값을 지정합니다.
b. 추가를 클릭하여 지침 목록에 지침을 추가합니다. | ||||||
스크립트 등록 취소 | Axeda 에이전트에 대한 자산 또는 여러 자산에 대해 배포할 수 있는 등록된 스크립트의 등록을 취소할 수 있습니다. 스크립트 등록 취소 단계에 대한 정보는 배포할 스크립트 실행을 참조하십시오. | ||||||
업로드 | Axeda eMessage 에이전트가 하나 이상의 파일을 ThingWorx 플랫폼으로 업로드할 수 있도록 해줍니다. a. 대상 저장소 필드에서  를 클릭하여 파일을 업로드할 저장소를 선택합니다.업로드를 위한 파일 저장소를 만들어 이 파일 저장소를 선택할 수 있습니다(예: UploadRepository). b. 대상 경로 필드에 업로드된 파일을 저장할 저장소의 위치를 지정합니다. 예: /UploadFiles는 파일을 /UploadRepository/UploadFiles 디렉터리에 저장합니다. 값 /는 업로드된 파일을 UploadRepository 디렉터리에 저장합니다.
c.  옆에 있는 필드에 업로드하려는 파일의 이름을 입력하고 를 클릭합니다. 파일 이름에 * 또는 ?와 같은 와일드카드를 사용할 수 있습니다. 여러 문자를 나타내려면 *를 사용하고 단일 문자를 나타내려면 ?를 사용합니다. 이 파일이 사용자 장치의 상대 경로에 존재하는지 확인하십시오.Linux 에이전트에는 와일드카드 문자(*,?)가 허용됩니다. Windows에서 실행되는 에이전트의 경우, ? 문자는 * 문자와 같은 효과를 갖습니다.
업로드할 파일 그리드에는 ThingWorx 플랫폼에 업로드해야 하는 파일 목록이 해당 삭제 플래그 상태와 함께 표시됩니다. 목록에서 파일을 삭제하려면, 항목을 목록에서 선택한 후 를 클릭합니다.d. 업로드할 파일을 추가한 후 패키지를 성공적으로 배포한 다음에는 저장소에서 파일을 삭제할 수 있습니다. 업로드 후 파일을 삭제하려면 해당 파일을 선택하고 테이블 행 작업 버튼을 전환합니다. 이 버튼을 전환하면 업로드 후 파일 삭제 상태가 true로 변경되고 패키지가 성공적으로 배포된 후 파일이 삭제됩니다. 그리드에서 각 파일을 선택하여 개별 파일을 선택하거나 파일 이름 확인란을 선택하여 업로드를 위해 추가된 모든 파일을 선택할 수 있습니다. 기본값으로 업로드 후 파일 삭제 상태는 false입니다. 전환 버튼은 true에서 false로, 또는 false에서 true로 상태를 변경할 수 있습니다. e. 추가를 클릭하여 지침 목록에 지침을 추가합니다. |
| | 단일 지침 기반 패키지에 여러 지침을 추가할 수 있습니다. |
10. 다음 세부 정보를 제공하는 지침 목록의 지침을 검토합니다.
◦ 순서 - 에이전트에서 지침이 실행되는 순서를 지정합니다.
◦ 유형 - 다음 중 하나로 지침 유형을 지정합니다.
▪ 다운로드
▪ 실행
▪ 스크립트 등록
▪ 재시작
▪ 스크립트 실행
▪ 속성 설정
▪ 스크립트 등록 취소
▪ 업로드
◦ 세부 정보 - 지침을 작성하는 동안 지정한 지침의 세부 정보를 지정합니다.
목록에서 지침을 선택하고 다음 옵션 중 하나를 사용하여 지침을 수정합니다.
◦ 지침을 편집하려면 
를 클릭합니다.
를 클릭합니다.◦ 지침의 순서를 다시 매기려면 
또는 
를 클릭합니다.
또는 를 클릭합니다.| | 지침 목록에 재시작 지침이 하나만 있으며 재시작 지침이 지침 목록의 마지막 지침인지 확인합니다. |
◦ 지침을 삭제하려면 
를 클릭합니다.
를 클릭합니다.11. 저장을 클릭하여 패키지를 저장합니다.
종속성 추가 또는 수정 페이지가 나타납니다. 종속성 추가 또는 수정은 선택적 단계입니다. 자세한 내용은 패키지 종속성 추가 또는 수정을 참조하십시오.
12. 패키지 종속성을 추가한 경우 저장을 클릭합니다.
테스트 배포 만들기 페이지가 나타납니다. 테스트 배포 만들기는 선택적 단계입니다. 자세한 내용은 패키지 배포 테스트를 참조하십시오.
13. 선택적으로 특정 사용자나 사용자 그룹에 대해 제공할 액세스 수준을 지정할 수 있습니다. 자세한 내용은 사용자 액세스 제어 지정을 참조하십시오.
14. 패키지 게시를 계속합니다.