설치 및 기본설정


기본 설정 가이드
※ 제품을 연동하기 전 꼭 아래내용을 읽어주세요! 
K Upload는 파일을 서버로 전송하기 위한 솔루션으로 다음과 같이 구성되어 있습니다.


 - Client Module : 화면 구성 및 파일을 전송하는 클라이언트쪽 모듈 [ Javascript, CSS, Images, XML, Agent ]
 - Server Module : 클라이언트로 부터 전송된 데이터를 서버쪽에서 처리해 주는 모듈 [ .NET(ashx, dll), JAVA(jsp, jar) ]



* 설치규격


 - 지원 운영체제 : Microsoft Windows 2000 Server 이상, Linux, Unix 등
 - 지원 웹 언어 : JSP JDK 1.7 이상 (JDK 1.4,JDK 1.5,JDK 1.6 별도문의), ASP, ASP.NET 2.0 이상
 - 지원 웹 서버 : JDK 1.7 이상 (JDK 1.4,JDK 1.5,JDK 1.6 별도문의)을 사용하는 WAS, Microsoft .NET Framework 2.0 이상을 사용하는 IIS



* K Upload 폴더 설명


 - agent
   K Upload 설치파일을 포함하고 있습니다.
 - config
   K Upload의 환경설정을 담당하는 raonkupload.config.xml 을 포함하고 있습니다.
 - css
   K Upload에 필요한 스타일시트 파일을 포함하고 있습니다.
 - raonkuploaddata
   저장경로에 대한 별도 설정이 없다면, 기본적으로 파일이 저장되는 Root 경로입니다.
 - handler
   파일을 서버에 저장하는 서버 모듈을 포함하고 있습니다. (.NET, JAVA 모듈)
 - images
   K Upload에 필요한 이미지 파일을 포함하고 있습니다.
 - js
   K Upload에 필요한 자바스크립트 파일을 포함하고 있습니다.
 - sdk
   K Upload의 개발자 매뉴얼과 기본 예제들을 포함하고 있습니다.
    (개발 및 테스트에만 사용하시고, 운영 반영시 반드시 제외 후 반영하시기 바랍니다.)



* 설치방법


 1. config\raonkupload.config.xml 설정
   RaonkUpload > license > product_key, license_key 에 발급받은 키를 설정합니다.

 2. K Upload Core 전체 폴더 업로드(하위폴더 및 파일포함)
   WEB서버와 WAS가 분리되어 있는 경우 handler, handler\JAVA, handler\.NET 폴더는 WAS서버에 업로드 합니다.
   나머지 폴더는 WEB서버에 설치합니다.(WEB서버와 경로를 맞춰 WAS에 설치합니다.)

 3. 웹 언어별 설정
  1) ASP, ASP.NET :
    config\raonkupload.config.xml 설정 : RaonkUpload > uploader_setting > develop_langage 에 NET 으로 설정합니다.
    (필요에 따라 handler_url을 설정합니다. ex: /handler/raonkhandler.ashx)
    handler\.NET 폴더의 dll 파일들을 해당 사이트 bin 폴더에 복사한 후,
    첨부된 web.config의 내용을 사이트 web.config 에 적용합니다.

  2) JSP(JAVA) :
    config\raonkupload.config.xml 설정 : RaonkUpload > uploader_setting > develop_langage 에 JAVA 로 설정합니다.
    (필요에 따라 handler_url을 설정합니다. ex: /handler/raonkhandler.jsp)
    handler\JAVA 폴더의 jar 파일들을 해당 사이트 WEB-INF\lib 폴더에 복사합니다.
    jar 파일 변경시에는 서버를 재기동합니다.

 4. 권한설정
  아래의 경로에 쓰기 권한을 추가합니다.
  1) 환경 설정 정보가 저장되는 파일
     ex) config\raonkupload.config.xml
  2) 파일이 업로드 되는 임시 폴더
     ex) handler\temp (만일 SetTempPath로 다른경로로 설정했다면, 해당 폴더에 권한 설정)
  3) 파일이 업로드 되는 기본 폴더
     ex) /raonkuploaddata

 5. Sample Page 확인
  Web Server에 맞게 /kupload/sample/index.html 연결
     ex) http://localhost/kupload/sample/index.html



* K Upload 서버 모듈 구성


 기본적으로 파일을 업로드하면 기본 설치폴더/raonkuploaddata 하위에 파일이 업로드가 되며,
 WEB 서버와 WAS가 분리된 경우 WAS쪽 /raonkuploaddata 하위에 파일이 업로드 됩니다.
 SetPhysicalPath 또는 SetVirtualPath 를 통하여 기본 저장 경로의 Root 폴더를 설정해야 합니다.

 (※ 설정한 Root 경로는 실제 물리적경로로 설정합니다.)



* K Upload를 생성하는 기본 방법


 1) Javascript file include
    <head>
        ...
    </head> 태그 사이에 아래의 코드를 추가합니다.
    <script type="text/javascript" src="RAONKUpload설치폴더URL/js/raonkupload.js">

 2) 업로드 객체 생성
    <body>...</body> 태그 사이에 업로드가 들어갈 위치에 업로드 생성 코드를 삽입합니다.
    <script type="text/javascript">
        var raonkParam = {
            Id: '생성할 업로드 이름'
        };
        var upload = new RAONKUpload(raonkParam);
    </script>



* K Upload 환경 설정 방법


 환경설정 방법은 Config xml 방식과 Javascript Property 방식을 지원합니다.

 1) 클라이언트 가이드의 환경설정 파일 부분을 참고하여,
    /kupload/config/raonkupload.config.xml 파일에 설정 (기본 환경설정 파일이며, 다른 파일로 변경 가능합니다.)

 2) 클라이언트 가이드의 Properties 부분을 참고하여, 아래와 같이 설정 (이렇게 설정된 값이 Xml 설정방식보다 우선 적용됩니다.)
    ex) 
    var raonkParam = {
        Id: 'upload1',
        Width: '800px'
    };
    var upload = new RAONKUpload(raonkParam);