XPLATFORM License 적용시 오류 해결방안

XPLATFORM  설치 또는 라이선스 갱신작업시 발생할 수 있는 오류 유형을 살펴보고 해결방법을 기술합니다.

Server License 적용 오류시 기본 확인사항

• WAS Class Path로 설정된 Library 디렉토리에 XPLATFORM License 파일이 존재하는 지 확인 합니다.

사용 예)
WEB-INF/lib/XPLATFORM_Server_License.xml

• Vi(또는 notepad) editor로 license xml 의 date 를 확인 합니다.

• Vi editor(또는 에디터)로 license xml 의 date 를 확인 합니다.

<date>
      <activation>2012-03-01</activation>
      <term unit="month">2</term>
</date>

• WAS를 Restart합니다.

• XPLATFORM_Server_License.xml 파일을 삭제 또는 rename 하고 Restart 를 합니다.

• 이때 다음과 같이 오류가 나오는 지 확인 합니다.

Caused by: com.tobesoft.xplatform.license.InvalidLicenseException: License not found
   at com.tobesoft.xplatform.license.A.E.A(Unknown Source)
   at com.tobesoft.xplatform.license.A.E.B(Unknown Source)
   at

• 이와 같이 메시지가 나오지 않는 다면 다른 Libray(System Libray등)에 동일한 xml이 있거나 파일을 캐쉬하고 있다는 것입니다. 검색하여 해당 xml 파일이 있는 지 확인 합니다.

• License 파일을 갱신 하였는데도 만료 되었다고 나오는 경우 이 또한 다른 경로에 파일이 있거나 캐쉬를 하고 있는 경우 입니다.

• 검색 하여 다른 경로에 xml 파일이 있다면 삭제 후 restart 하십시오.

• 검색 하여 파일이 없다면 캐쉬를 하고 있으므로 파일의 시간을 갱신 하여 주십시오.

• > touch XPLATFORM_Server_License.xml

X-API 장애

X-API ASP모듈 사용시 receivedata 에서 에러 발생시 확인사항

오류내용

XapiRequest = (PlatformRequest)Server.CreateObject("XAPI.PlatformRequest");
XapiResponse = (PlatformResponse)Server.CreateObject("XAPI.PlatformResponse");
OutPlatformData= (PlatformData)Server.CreateObject("XAPI.PlatformData");
XAPILib.DataSet rs;
rs = (XAPILib.DataSet)Server.CreateObject("XAPI.DataSet");
{
    XapiRequest.ReceiveData();
    InPlatformData = XapiRequest.GetData();
    XapiRequest.ReceiveData();// 여기서 에러 발생합니다.

해결방안

• 오류유형과 같이 receivedata에서 에러발생원인이 있는 경우는 라이센스 파일 관련 에러로 현재 관련 에러내용을 출력하지 않음.

• system32에 서버라이센스 파일을 복사하고 정상작동됨.

클라이언트 라이선스 적용방법

XPLATFORM의 경우 서버라이선스와 클라이언트 라이선스를 체크를 하게 됩니다. 클라이언트 라이선스 전용방법을 설명합니다.

적용방법

ADL의 licenseurl에 클라이언트 라이선스 절대 또는 상대 주소를 기입합니다.

• 라이선스 파일명 : XPLATFORM_Client_License.xml

• 해당 프로젝트 ADL 선택 후 프로퍼티의 licensseurl에 해당 파일명을 입력합니다.

Ex) XPLATFORM_Client_License.xml
  ../ XPLATFORM_Client_License.xml
  http://www.tobesoft.com/ XPLATFORM_Client_License.xml

개발라이선스 사용법

• 개발 중이거나 실라이선스 발급전에는 trail라이선스를 사용합니다.

• Trail라이선스의 경우 ip체크(도메인체크)부분을 통과 할 수 있습니다. 단 2달 주기로 발급이 되므로 사용 기간이 있습니다.

클라이언트 라이선스 오류 유형

• 클라언트 라이선스의 경우 오류 메시지가 클라이언트(사용자) 화면에서 나오게 됩니다.

• 클라이언트 라이선스를 찾을수 없습니다.

• 해당 경로에 라이선스 파일이 없거나 ADL에 licensseurl에 라이선스 파일이 지정이 안되어 있으면 나오게 됩니다.

• License Domain이 유효하지 않습니다.

• 발급 된 라이선스 파일의 ip 및 domain이 실제 접속 경로와 틀리면 나오게 됩니다.

• Trail라이선싀 경우 체크 하지 않습니다.

• 기한이 만료 메세지

• Trail라이선스의 경우 라이선스 사용 기한이 있습니다.

• 분석 실패 메시지

• 라이선스 파일이 손상되거나 수정한경우 분석을 할수 없습니다.

라이센스 오류 해결방법 Invalid byte 1 of 1-byte UTF-8 sequence.

라이센스 오류 해결방법 Invalid byte 1 of 1-byte UTF-8 sequence.

발급된 라이센스 파일에 한글이 포함되어 있는 상태에서 
저장 문자열 형식이 Ansi로 저장되어 발생하는 문제로 

에디터 프로그램에서 파일 포멧을 Uncode(UTF-8)로 변환하면 해결이 됩니다.

테스트 할 경우 라이선스 체크를 하지 않는 방법

UXstudion에서 하거나 테스트html을 만들어서 .xal 설정 경로를 웹이 아닌 로컬경로로 로딩 하면 가능합니다. 그 외에는 라이선스를 체크 합니다.

XLauncher.xadl = "http://www.tobesoft.com/main.xadl"; 부분을
XLauncher.xadl = "C:\\test\\main.xadl";

주의사항

• 다른 도메인의 클라이언트 라이선스를 사용할수 없습니다.

• 상대 경로로 라이선스 적용이 안될경우 에디터(울트라에디터)로 열어서 직접 수정하여야 합니다.

• 라이선스 파일을 수정 했을 경우 정상 작동하지 않습니다.

• Trail 클라이언트 라이선스 의 경우 배포 버전이 2010.12월 이전 버전과 이후 버전이 각각 제공됩니다.

• 서버 라이선스 클라이언트 라이선스의 경우 XML 파일 자체가 라이선스 입니다.파일속의 XML키 부분만 카피 해서 사용시 오작동 하게 됩니다.

• 라이선스 발급의 경우 담당영업대표에게 발급 요청합니다.