설치

WebSquare5 Engine은 JAR 파일 형태로 제공되어 웹 서버에 설치됩니다. WebSquare5 Engine의 설치 사양은 WebSquare5 Engine이 설치되는 웹 서버 사양을 따릅니다. 단, 대용량 파일 업로드/다운로드와 같은 웹을 통해 제공하는 서버스 종류 및 규모에 따라 웹서버 환경을 구성할 것을 권장합니다.

좀 더 자세한 내용은 웹스퀘어 서버 설치 가이드를 참고하십시오.

사양

브라우저 지원

웹

IE11 이상

IE 제외 기타 웹 브라우저는 에버그린 브라우저 정책 따름. (최신 버전 및 직전 버전을 지원.)

모바일

Android

Safari (iPhone, iPad)

설정

프로젝트의 WebSquare Configure 폴더에 있는 client.config.xml 및 server.config.xml 파일을 클릭하여 직접 설정을 변경할 수 있습니다.

client.config.xml (클라이언트)

다음은 client.config.xml 파일을 클릭하면 표시되는 화면입니다. 각 설정 항목에 대한 설명이 표시되며, 설정 값을 직접 입력하거나 선택할 수 있습니다. 하단의 카테고리를 클릭하면 해당 부분으로 직접 이동할 수 있습니다.

server.config.xml (서버)

다음은 serverconfig.xml 파일을 클릭하면 표시되는 화면입니다. 각 설정 항목에 대한 설명이 표시되며, 설정 값을 직접 입력하거나 선택할 수 있습니다. 하단의 카테고리를 클릭하면 해당 부분으로 직접 이동할 수 있습니다.

설치 관련 문제 해결

본 단락은 WebSquare5 엔진 설치 시 발생할 수 있는 주요 상황 및 그 해결책을 정리한 것입니다. 아래의 이슈에 대한 해결책을 참고하십시오.

"WebSquare.startApplication is not function"

"WebSquare.startApplication is not function" 경고 창은 라이센스가 유효하지 않을 경우 발생합니다. "WebSquare.startApplication is not function" 경고 창이 발생할 경우 아래의 방법으로 확인하십시오.

1. 브라우저 개발자도구의 네트워크 탭을 선택합니다.

2. javascriptLoader.wq 파일을 선택하고 응답 탭을 클릭합니다.

3. 정상인 경우 응답 탭에 코드가 표시되어야 합니다. (라이센스가 유효하지 않을 경우 아무 내용도 표시되지 않습니다.)

WebServer와 WAS 분리

WebServer와 WAS를 분리해서 사용할 경우, .jar 및 .jsp 파일은 WAS에 나머지 파일은 WebServer에 저장하십시오.

1. WebServer와 WAS에 동일한 폴더 구조를 구성합니다.

2. 이후 웹스퀘어 화면 file은 모두 WebServer의 해당 경로로 업로드 해야합니다. (WAS에 올릴 경우, xml 헤더 중복 에러가 발생할 수 있습니다.)

3. 브라우저 개발자 도구에서 GET /websquare/javascript.wq?q=/bootloader 이상 진행하지 못하는 경우, .wq 관련 설정을 확인하십시오.

javascript.wq?q=/bootloader 404 error

WebSquare5를 정상 설치했으나 페이지 로딩 시 javascript.wq?q=/bootloader 404 error가 발생할 수 있습니다. 이 경우 다음을 확인하십시오.

1. WAS 및 WebServer가 설치 경로를 정확히 바라보고 있는가? (일반적인 html파일 등을 올려놓고 확인 가능)

2. WAS 및 WebServer에 설치된 WebSquare5의 권한은 어떠한가?

javascript.wq?q=/bootloader 400(Bad Request) error

WebSquare5를 정상 설치했으나 페이지 로딩 시 javascript.wq?q=/bootloader 400 error 가 발생할수 있습니다. 이 경우 다음을 확인하십시오.

1. 클라이언트의 잘못된 파라미터 정보 또는 타입 request 시 발생합니다.

   1. spring, @requestParm 어노테이션 사용 시 빈 파라미터 일 때 ( required = false 처리 필요 )

   2. http 전송 header 크기 또는 header의 특정 값 (apache의 경우 크기 조정 가능)

   3. 브라우저 캐시 및 쿠키, 설정상의 문제

   4. 웹방화벽 문제

2. 웹 방화벽에서 해당 페이지 예외 처리 후, 정상 수행되는 것을 확인합니다.

3. 웹 방화벽에서 해당 페이지 예외 처리 후, 정상 수행되는 것을 확인합니다.

websquare.html 전송 이후 반응이 없을 때

개발자 도구에서 확인 결과 websquare.html 은 Status 200으로 정상인 경우에도 아무런 반응이 없을 수 있습니다. Window Server에 설치를 마친 후, 서버를 기동하고 Test페이지를 열어본 순간 아무런 반응이 없을 때가 있습니다. OS에 Chrome이 설치된 경우 아래의 테스트를 수행하십시오.

1. Chrome에서는 정상, IE에서는 반응이 없다면,

   1. IE – 인터넷 옵션 – 신뢰할 수 있는 사이트 – 사이트 – 추가를 선택합니다.

   2. 해당 주소를 신뢰할 수 있는 사이트로 등록합니다.

   3. http://{해당주소}/websquare/javascript.wq?q=/bootloader 를 실행하여 메시지를 확인합니다.

2. Chrome에서도 반응이 없다면,

   1. 설치 과정에 문제가 있는지 확인하십시오. (개발자 도구의 Network등)

WEBSQUARE_HOME 설정

해당 서버를 실행시키는 startUCMS1.sh 셀 스크립트를 아래와 같이 수정하십시오.

솔라리스OS 에서 CPU코어 개수 확인

psrinfo -pv 명령어로 확인하십시오.

아래 예제의 경우 CPU 코어 개수는 총 16개입니다

설치/패치 시 충돌 가능 jar 목록

기존에 서비스가 있는 곳에 설치/패치 시, 충돌 날 수 있는 jar 파일은 아래와 같습니다.

아래와 같은 에러 메시지가 발생합니다.

$r_title(에러 메시지)
WAS:Upload library(commons-fileupload-1.2.jar) loading error occurred. If file upload wasn't needed, turn off file upload in configuration file(websquare.xml). 이하 생략...

JBOSS 설치 시 유의사항

1. web.xml 에 <display-name> 태그가 없으면 정상적으로 .war 폴더를 로딩할 수 없습니다. display-name에 해당 .war 이름을 명시합니다.

2. 해당 WEB-INF 폴더에 jboss-web.xml 파일이 없으면 정상적으로 해당 폴더를 로딩할 수 없습니다.

3. jboss 모든 버전에서 class-loading 관련 설정이 필요합니다.

4. 해당 .war 폴더에 WEB-INF를 구성해도 무방합니다. (WAS 엔지니어와 확인 필요.)

설치 할 때 확인해야 할 contentType

설치 시 확인 해야 할 content-Type은 아래와 같습니다. websquare 기동 시 오류가 발생할 경우 개발자 도구를 통해 아래 내용을 확인하십시오. 잘못된 경우 WebsSrver 또는 WAS의 mime-type을 확인하십시오.

• confg.xml - application/xml

• websquare.html - text/html

• javascriptPluginAll.wq - text/javascript

• 화면 xml - application/xml

웹로직 설치 시 web.xml 파일에 mime-mapping 설정

web.xml 파일에 아래 내용을 추가하십시오.

$r_title(mime-mapping 설정)
<mime-mapping>
	<extension>xml</extension>
	<mime-type>application/xml</mime-type>
</mime-mapping>

JEUS에서 한글이 깨지는 경우

DB 등에서 조회한 값은 정상 호출하지만 WebSquare XML 파일의 한글이 깨지는 경우가 있습니다. 이 경우 아래 내용을 확인합니다.

1. config.xml 등의 한글 주석 등이 깨져있는가?

2. XML 파일만 응답 헤더가 contentType = application/xml;charSet=ISO_8859_1인가? (다른 확장자는 정상.)

이 현상은 서버쪽의 인코딩 설정에 관련된 것일 수 있습니다. JEUS의 WEBMain.xml을 확인하십시오. 참고로 아래는 한글이 정상 출력되는 인코딩 예입니다.

<encoding>
	<request-encoding>
		<default>UTF-8</default>
		<forced>UTF-8</forced>
	</request-encoding>
	<response-encoding>
		<default>UTF-8</default>
		<forced>UTF-8</forced>
	</response-encoding>
	<request-url-encoding>
		<default>UTF-8</default>
		<forced>UTF-8</forced>
	</request-url-encoding>
</encoding>

웹서버가 SUN iplanet(혹은 웹티어)인 경우

웹서버가 iplanet (혹은 웹티어) 인경우, .wq 확장자에 대한 처리 및 mime-type 설정이 약간 복잡합니다. 이 경우 아래 내용을 확인하십시오.

설정 파일 위치를 확인합니다.

아래 예제의 경우 mime.types 및 XXXX_obj.conf 파일을 변경해야합니다. (경우에 따라서magnus.conf를 변경할 때도 있습니다.

# mime-type을 설정합니다. (예: type=text/wq exts=wq)

다음은 XXXX_obj.conf 설정 예시입니다. ppath=".wq" 부분을 참고하십시오.

WAS가 websphere 일 경우 web.xml 추가 설정