7.제품설치 및 실행

7.1넥사크로플랫폼 HTML5 14

7.1.1nexacro platform API설치

nexacro platform API 설치 전 확인사항

설치 전 확인사항

1) WAS 설치 및 Web Application(Context) 구성이 완료 되었는지 확인
2) FTP를 이용하여 nexacro platform API 파일 업로드를 위한 WAS 계정 확인
3) WAS Application(Context)의 lib 폴더 위치 확인
   예) [application 경로]/WEB-INF/lib
4) WAS Restart 방법 확인
5) 넥사크로플랫폼(nexacro platform)라이선스 확인

라이선스 발급 방법

영업대표에게 아래 정보를 확인 후 라이선스 발급 요청

가) 서버 장비 Core 수 
나) WAS IP 주소 
다) WAS 접근 Domain Name(Client 라이선스 발급 시 사용)

넥사크로플랫폼(nexacro platform) HTML5 API 설치

설치방법 개요

WAS에 Application(Context) 구성 후 application 경로의 lib 폴더에 nexacro platform API(nexacro-xapi-1.0.jar, commons-logging-1.1.jar)파일 및 라이선스(nexacro14_server_license.xml)파일을 업로드 후 WAS를 재기동 합니다.

설치방법 상세

가) WAS 권한을 가진 사용자 ID를 이용하여 WAS에 로그인
나) WAS의 Lib 폴더로 이동 
다) FTP 유틸리티를 통해 Jar파일 및 라이선스 파일을 복사 (바이너리 방식으로 업로드)

그림 7-1License_1

※ 업로드 위치 예

/WAS/WEB-INF/lib/nexacro-xapi-1.0.jar
/WAS/WEB-INF/lib/commons-logging-1.1.1jar
/WAS/WEB-INF/lib/nexacro14_server_license.xml

그림 7-2License_2

라) WAS를 Restart 합니다.

nexacro14lib 폴더 추가

nexacro platform의 개발된 화면 소스 (xfdl, xjs 등)는  Generate과정을 거쳐 확장자가 js로 변경되는 과정이 필요합니다. 
이때 필요한 모듈이 nexacro14lib폴더입니다. 
해당 폴더는 nexacro studio 개발시와 운영시 WAS경로의  ADL경로에 존재해야 합니다. 
최초 nexacro studio에서 전체 Generate 과정을 거쳐 생성된 폴더에 nexacro14lib를 추가해 주셔야
합니다.
가)   nexacro studio 설치경로에 nexacro14lib 복사
nexacro14lib는 nexacro studio 의 설치 폴더에 위치해 있습니다.
설치경로 ) C:\Program Files (x86)\nexacro\14

그림 7-3License_0

나) WAS(Web Application Server) 의 Application경로(ADL 경로)에 nexacro14lib 폴더 복사 .

그림 7-4xapi_ftp_5

nexacro studio 설정

가) nexacro studio에서 Tool > Option>HTML5를 선택합니다.
나) Generate할 위치를 지정해줘야 합니다. Local PC나 서버를 연결한 network 드라이브로 설정합니다.
- 메뉴에서 Tools 선택 후 Options선택 화면

그림 7-5xapi_ftp_3

- Environment - General 항목 
- Working Folder : 현재 개발중인 프로젝트 폴더를 선택
  Working Folder의 경우 생략이 가능합니다. 생략을 하였을 경우 현재 Load되어 있는 
  Project 경로를 가져오게 되어 있습니다.
- Generate Path : HTML5형식으로 generate할 경로 선택

설치 확인 및 테스트

서버 설치 확인 테스트

가) 첨부파일의 설치 테스트 Jsp파일을 application의 context(Web) root에 업로드 
    (JSP 파일이 호출 가능한 위치)
나) Internet Explorer 브라우저 실행
다) 주소 창에 테스트 페이지 호출함(Jsp 파일 호출 가능한 웹 경로를 의미)
라) 아래 화면과 같이 발급받은 라이선스 정보가 브라우저에 표시되면 설치 성공

그림 7-6xapi_ftp_4

nexacro studio 설치 확인 테스트

가) 폼에서 임의의 화면을 하나 만듭니다.

그림 7-7xapi_ftp_6

나) Generate Application 버튼을 통해 프로젝트를 최초 1회 전체 컴파일 후 구동합니다.
    A. 컴파일 위치를 로컬 pc에 지정했으면 컴파일 후 해당 위치로가 컴파일된 
       파일을 복사하여 서버세팅한 application에 붙여 넣습니다.
다) 그림처럼 QuickView 버튼이나 Launch Project를 선택하면 아래와 같이 URL 설정 창이 나타납니다.
라) URL설정 창에 서버에 세팅한 application URL을 입력하세요

그림 7-8xapi_ftp_8

마) 아래 그림과 같이 실행이 되면 세팅이 완료 된 것입니다.

그림 7-9xapi_ftp_7

참고사항

아래 소스 내용을 복사하여 JSP파일로 만들어 
WAS의 JSP실행가능 경로에 복사 후 테스트를 하시기 바랍니다.

X-API Check JSP소스

XApiCheck.jsp

<%@ page contentType="text/html; charset=UTF-8" %>
 
<html>
 <head>
 <title>JarInfo</title>
 <style>
 * { font-family: Verdana }
 </style>
 </head>
 <body>
 <pre>
 <%
 new com.nexacro.xapi.util.JarInfo().info(out);
 %>
 </pre>
 </body>
 </html>

WAS의 환경정보를 확인할 수 있는 소스

Info.jsp

<%@ page import = "java.util.*" %>
<%@ page contentType="text/html; charset=UTF-8" %>
<%
out.println("==========================================================================<br/>");
out.println("Client User-Agent Information<br/>");
out.println("==========================================================================<br/>");
java.util.Enumeration headerNames = request.getHeaderNames();   
while(headerNames.hasMoreElements()) {   
   String headerName = headerNames.nextElement().toString();   
   String headerValue = request.getHeader(headerName);   
   out.println(headerName+"&nbsp;:&nbsp;"+headerValue);
}
out.println("<br/><br/>");
out.println("==========================================================================<br/>");
out.println("Server Environment Information<br/>");
out.println("==========================================================================<br/>");
out.println("SERVER_PROTOCOL : " + request.getProtocol() + "<br/>");   
out.println("SERVER_PORT : " + request.getServerPort() + "<br/>");    
out.println("REQUEST_METHOD : " + request.getMethod() + "<br/>");   
out.println("PATH_INFO : " + request.getPathInfo() + "<br/>");   
out.println("PATH_TRANSLATED : " + request.getPathTranslated() + "<br/>");   
out.println("SCRIPT_NAME : " + request.getServletPath() + "<br/>");   
out.println("DOCUMENT_ROOT : " + request.getRealPath("/") + "<br/>");   
out.println("QUERY_STRING : " + request.getQueryString() + "<br/>");   
out.println("REMOTE_HOST : " + request.getRemoteHost() + "<br/>");   
out.println("REMOTE_ADDR : " + request.getRemoteAddr() + "<br/>");   
out.println("AUTH_TYPE : " + request.getAuthType() + "<br/>");   
out.println("REMOTE_USER : " + request.getRemoteUser() + "<br/>");   
out.println("CONTENT_TYPE : " + request.getContentType() + "<br/>");   
out.println("CONTENT_LENGTH : " + request.getContentLength() + "<br/>");   
out.println("HTTP_ACCEPT : " + request.getHeader("Accept") + "<br/>");   
out.println("HTTP_USER_AGENT : " + request.getHeader("User-Agent") + "<br/>");   
out.println("HTTP_REFERER : " + request.getHeader("Referer") + "<br/>");   
out.println("CONTEXT_PATH : " + request.getContextPath() + "<br/>");
out.println("REQUEST_CHARACTER_ENCODE : " + request.getCharacterEncoding() + "<br/>");
out.println("RESPONSE_CHARACTER_ENCODE : " + response.getCharacterEncoding() + "<br/>");
%>

7.2X-API (ASP/.Net) API설치 가이드

[ASP.NET ASPXAPI Server설치] 관련 참고자료입니다.

X-API의 경우에는 제품을 구매한 경우에 한해 제공되는 모듈입니다.

또한 설치파일 및 라이선스 정보는 사전 영업대표를 통해 받으셔야 합니다.

7.2.1설치 전 체크사항

시스템 종류가 64bit 운영체제 인가?

32bit, 64bit 환경에 따라 설치모듈이 다름

Windows installer는 이상이 없는가? [설치중 오류가 발생한 경우]

Regsvr32 명령어는 제대로 수행되는가? [설치중 오류가 발생한 경우]

7.2.2X-API 연동을 위한 체크사항

IIS 서버가 설치 되어 있는가?

웹사이트 서비스 설정이 되어 있는가?

ASP/.NET 서비스 환경이 구성되어 있는가? (웹브라우져를 통한 .NET소스 실행이 가능한가?)

임의의 페이지를 만들어(예:test.aspx) 브라우져를 통해 호출시 정상적으로 실행되는가?

nexacro14_server_license.xml 파일이 Windows > (System32 / SysWOW64) 폴더에 존재하는가?

제공된 ServiceSample 폴더에 테스트 페이지가 웹사이트에 올라와 있는가?

API 설치 후 IIS 확인 옵션 확인 사항

그림 7-10iis

가) 운영체제 64bit PC에서 32bit ASP API 설치 했을 경우 32비트 응용 프로그램 사용

TRUE 선택

나) 운영체제 64bit PC에서 64bit ASP API 설치 했을 경우 32비트 응용 프로그램 사용

FASE 선택

그림 7-11iis_set

7.2.3X-API (ASP.NET)설치 가이드

서비스 API 설치

nexacroASPXAPI14.exe / nexacroASPXAPI14_64.exe 파일을 선택하여 실행합니다

오류없이 정상적으로 설치가 성공 되었다면 다음폴더
 (Windows > SysWOW64)에 아래의 파일들이 있는지 확인합니다
이상없이 아래의 해당 파일이 존재한다면 API가 정상적으로 설치가 
완료되었습니다
+ nexacroXAPI.dll, 
+ nexacroBasicLib.dll,
+ nexacroClassLib.dll,
+ nexacroMemLib.dll

예외사항

nexacroASPXAPI14.exe 을 통한 설치 중 에러가 발생할 경우 아래의 방법 으로 설치하시기 바랍니다.
-  nexacroXAPI.dll, 
- nexacroBasicLib.dll, 
- nexacroClassLib.dll,
- nexacroMemLib.dll 
파일을 다음폴더 (Windows >(System32 / SysWOW64))에 복사
nexacroXAPI.dll 파일을 regsvr32 명령어를 통해 레지스트리 등록
[레지스트리 등록 방법]
a) 시작 -> 보조프로그램 -> 명령프롬프트 실행
(Windows Vista 이상일 경우 관리자권한으로 실행)
b) nexacroXAPI.dll 파일이 있는 경로로 이동 후 regsvr32 nexacroXAPI.dll
입력 후 Enter 성공 메시지가 팝업이 되면 정상 설치 확인

서비스 확인 방법

제공된 nexacro14_server_license.xml l 파일을 다음폴더 (Windows > (System32 / SysWOW64))에 복사

제공된 ServiceSample 폴더내에 있는 테스트 .net소스를 서비스 웹루트에 복사

IIS 재시작후 웹 브라우저를 통해 CS_XAPI.asp 호출

CS_XAPI.asp
<%
 ' 변수 선언
 Dim oPlatformRequest
 Dim oPlatformResponse
 Dim oPlatformDataOut
 Dim oDS
 Dim nResult
 
 ' HTTP Request를 받을 Class 생성
 Set oPlatformRequest = Server.CreateObject("NexacroXAPI.PlatformRequest")
 
 ' 에러 코드를 기록하여 리턴하는 Dataset을 만듦
 Set oDS = Server.CreateObject("NexacroXAPI.DataSet")
 oDS.Name = "ds_list"
 nResult = oDS.AddColumn("filed1", "STRING",256)
 nResult = oDS.AddColumn("filed2", "STRING",256)
 nResult = oDS.AddColumn("filed3", "STRING",256)
 nResult = oDS.AddColumn("filed4", "STRING",256)
 nResult = oDS.AddColumn("filed5", "STRING",256)
 nResult = oDS.AddColumn("filed6", "STRING",256)
 nResult = oDS.AddColumn("filed7", "STRING",256)
 nResult = oDS.AddColumn("filed8", "STRING",256)
 nResult = oDS.AddColumn("filed9", "STRING",256)
 nResult = oDS.AddColumn("filed10","STRING",256)
  Dim nIdx
  
  For i = 0 to 2
    'Row를 추가하고, errocode를 셋팅                                      
    nIdx = oDS.NewRow                                                         
    oDS.SetValue nIdx, 0,  "nexacro"
    oDS.SetValue nIdx, 1,  "nexacro"
    oDS.SetValue nIdx, 2,  "nexacro"
    oDS.SetValue nIdx, 3,  "nexacro"
    oDS.SetValue nIdx, 4,  "nexacro"
    oDS.SetValue nIdx, 5,  "nexacro"
    oDS.SetValue nIdx, 6,  "nexacro"
    oDS.SetValue nIdx, 7,  "nexacro"
    oDS.SetValue nIdx, 8,  "nexacro"
    oDS.SetValue nIdx, 9,  "nexacro"
  Next 

 ' 출력에 쓰일 PlatformData를 생성한다.
 Set oPlatformDataOut = Server.CreateObject("NexacroXAPI.PlatformData")
 
 ' PlatformDataOut에 Error Dataset을 추가합니다.
 oPlatformDataOut.AddDataSet(oDS)
 
 ' 리턴되는 Class를 생성합니다.
 Set oPlatformResponse = Server.CreateObject("NexacroXAPI.PlatformResponse")
 oPlatformResponse.SetData oPlatformDataOut
  
 'oPlatformResponse.SetContentType(81)
 oPlatformResponse.SetCompressType(oPlatformRequest.GetCompressType)
  
 oPlatformResponse.SendData
 
 ' 사용을 마친 개체는 해제 합니다.
 Set oPlatformResponse = Nothing
 Set oPlatformRequest  = Nothing
 Set oPlatformDataOut  = Nothing
 Set oDS        = Nothing
%>

아래와 같은 화면이 호출이 되면 정상 설치 확인

그림 7-12iis_test