'사용자지정필수구성요소'에 해당되는 글 1건

  1. 2008/04/04 글뻥 VS2008에서 오라클 클라이언트를 필수 구성요소로 추가해 Clickonce로 배포해보자 (3)

Visual Studio를 사용하면서 Clickonce 배포를 한번이라도 해본 프로그래머라면 이런 화면 기억할 것이다.

사용자 삽입 이미지

Clickonce로 배포하기전에 사용자 클라이언트에 대한 설정을 해두면 다음과 같이 설치화면에서 자동으로 감지하여 추가 설치프로그램을 다운로드하여 설치한다.
사용자 삽입 이미지
* 게시자와 프로젝트는 임의로 제거하였으니 양해바랍니다.

아무튼 뭔가 좀 있어보인다.
특히 오라클과의 연동을 위해서는 필수적으로 Oracle Client가 깔려야 하고 그위에 나머지 DB Connection이나 기타 등등의 모듈이 올라가야 정상적으로 작동되는데 웹으로 배포하면서 Oracle Client는 CD로 들고 다니거나 사용자에게 어디어디서 받으라고 시키는 것은 웃기는 방법 아닐까?

* 주의! : 본 프로그램은 인트라넷에서 사용을 목적으로 철저히 통제된 환경이므로 가능하나 인터넷 서비스하는데 오라클 설치 시키는 바보는 없겠지? 인터넷에서는 SOAP 프로토콜을 활용하자.

아무튼 Clickonce 배포방식을 선택했다면 그에 맞도록 개발하려는 노력도 필요할것이고 그보다 우선하여 이와 같은 방식을 Framework에서 지원하여야 하는 것이다. 다행히 DotNetFramwork는 지원하고 있으므로 문제될 것이 없다. 이제 남은 것은 방법을 알고 실행에 옮기는 것 뿐이니 말이다.

1. 먼저 Oracle Client를 설치 파일로 만들자.
예전에 포스팅한 http://www.wolfpack.pe.kr/210를 참고하여 오라클 클라이언트 라이트 버전의 설치와 사용법을 먼저 숙지하자. (꼭 먼저 읽어 보아야 다음 설치파일 만들기가 이해될 것이다.)
다했다면 다음과 같이 설치 프로젝트로 Visual Sudio를 열자.
사용자 삽입 이미지

이름을 아무거나 주면 된다.
프로젝트가 생성되고나면 Oracle Lite Client 가 설정 되어 있는 경로의 파일들을 몽땅 추가해놓자.
사용자 삽입 이미지
다음은 추가해 놓은 모습으로 오라클 명령을 수행하는데 전혀 지장없는 것들은 남겨 놓고 불필요한것들은 삭제한후에 정리해서 넣어놓은 것이다.
사용자 삽입 이미지
추가가 되었다면 프로젝트 속성창에서 설치될 경로를 지정하자. 속성은 다음과 같이 프로젝트명을 우클릭한후 "보기", "파일시스템"을 클릭하고 파일시스템의 속성을 수정하면 된다.
사용자 삽입 이미지
사용자 삽입 이미지
* 기본 DefaultLocation을 "c:\program files\OCI"로 설정하였다.

설치될 Oracle Client의 레지스트리 파일을 수정할 차례이다.
위와 같은 방법으로 프로젝트명을 클릭한후 우클릭하여 "보기", "레지스트리"를 클릭하자.
사용자 삽입 이미지
다음과 같이 HKEY_CURRENT_USER에 "Environment"라는 키를 만들고 다음과 같이 "LD_LIBRARY_PATH", "Path", "TNS_ADMIN"을 설정한다.
사용자 삽입 이미지
위의 최종 화면을 보면서 다음과 같이 하면 간단히 해결된다.
먼저 Path를 설정해보자. 빈 화면에서 우클릭하여 "새로 만들기", "확장 가능한 문자열 값"을 선택한후에 이름을 "Path"라고 하고 속성창에서 Value부분을 추가한다.
사용자 삽입 이미지
사용자 삽입 이미지
사용자 삽입 이미지
나머지 2개 "LD_LIBRARY_PATH", "TNS_ADMIN"도 추가하되 "Path"와는 다르게 "문자열 값"으로 설정하자.
사용자 삽입 이미지
속성과 키값은 "Path"설정과 동일하다. 단지 속성은 "c:\program files\oci"로 설치경로와 동일하게 진행하면 된다.

"F6"를 눌러서 솔루션을 빌드하자.
빌드한후 "탐색기"나 "내컴퓨터"로 보면 다음과 같이 얌전히 msi파일이 만들어져 있다.
사용자 삽입 이미지

2. 만들어진 파일을 필수구성요소 중 하나로 설정하자.
만들어진 msi파일을 clickonce의 필수 구성요소로 지정하려면 이녀석이 필수 구소요소에 해당하는 것이지 알아야 Visual Studio에서 이러한 것들이 있어요~ 라고 나열해 줄수 있을 것이다.
다시말해 어떤 저장소가 있고 그 저장소에 있는 파일들을 나열해주지 않았을까?
함 찾아 보자.
Visual Studio 2008을 설치했다면 "C:\Program Files\Microsoft SDKs\Windows\v6.0A\Bootstrapper\Packages"로 이동해보자.
(그 이전버전의 경우는 "C:\Program Files\Microsoft Visual Studio 8\SDK\v2.0" 밑에 Bootstrapper에 Packages에 있었나?? 암튼 그랬으니 찾아보자.)

그런데 여기다 놓는 것으로만 끝나는 것이 아니라 이녀석이 설치될 환경을 지정해줘야 할것 아닌가? 여기서 문제가 발생하는데 이 환경설정이라는 것이 매우 아주 짜증나게 복잡하고 어렵다.
Visual Studio에서도 지원하지 않는 기능이다보니 짜증난다. 이럴때는 3rd Part 프로그램을 찾아보는 것이 현명하고 또 마침 좋은 녀석이 있다.
"Bootstrapper Manifest Generator"라는 녀석이고 공식홈에서 쉽게 다운로드 할 수 있으니 본 블로그의 계정용량을 생각하여 첨부는 생략한다. 공식홈은 여기로 : http://www.codeplex.com/bmg

VS2005용 : http://www.codeplex.com/bmg/release/pr ··· d%3D2215
VS2008용 : http://www.codeplex.com/bmg/release/pr ··· %3D10652

다운로드후 설치하고 "C:\Program Files\Microsoft\Bootstrapper Manifest Generator for VS2008"에 "BMG.EXE"라는 놈을 실행하면 된다. (덴장. 바로가기 버튼이라도 만들어 줄것이지..)

실행하면 다음과 같이 열리는데 Project Name과 Product Code만 "OCI"로 입력하였다.
사용자 삽입 이미지
Package를 우클릭한후에 "Add Install File"을 선택하자
사용자 삽입 이미지
파일을 설정한후 다음과 같이 설치파일에 대한 정보를 설정하였다.
- Display Name : Oracle Client
- Language : 한국어
- Properties 에 Reboot을 None으로 설정하였고 Installation Time을 "30"으로 잡아 줬다.
사용자 삽입 이미지
"System Checks"탭으로 이동하여 왼쪽 상단의 File Check를 추가하고 다음과 같이 지정한다.
Property for Result - Installed
File Name to Search - 찾기로 설치 될 파일중 하나를 지정
Start Searche in Special Folder 체크 해제
Path - 설치될 경로
사용자 삽입 이미지
Install Conditions로 이동해서 다음과 같이 ByPassIf로 설치안하고 통과할 조건을 설정하자.
사용자 삽입 이미지
이제 마지막 설정단계이다. Use Default System Exit Codes 부분을 체크해제하자.
사용자 삽입 이미지
모든 설정이 완료 되었으면 Build한다.
사용자 삽입 이미지
빌드 화면인데 Error나 Warning 없이 완료되었다는 메시지가 뜬다.
사용자 삽입 이미지
"C:\Program Files\Microsoft SDKs\Windows\v6.0A\Bootstrapper\Packages"밑에 "OCI"라는 폴더가 만들어져 있고 그 안에 보면 product.xml이라는 이름으로 설치파일에 대한 기본정보가 생성되었다.
- product.xml
<?xml version="1.0" encoding="utf-8"?>
<Product ProductCode="OCI" xmlns="http://schemas.microsoft.com/developer ··· strapper">
  <RelatedProducts>
    <DependsOnProduct Code="Microsoft.Windows.Installer.3.1" />
  </RelatedProducts>
</Product>

그리고 "ko"라는 한국어 설치본이 저장되는 폴더가 생성되어 있고 거기를 또 들어가면 "package.xml"과 "oci.msi"파일이 생성되어 있다.
-package.xml
<?xml version="1.0" encoding="utf-8"?>
<Package Name="DisplayName" Culture="Culture" xmlns="http://schemas.microsoft.com/developer ··· strapper">
  <PackageFiles CopyAllPackageFiles="false">
    <PackageFile Name="oci.msi" Hash="CCA799724D75045AC38679C86C93AE2F890E37A7" />
  </PackageFiles>
  <InstallChecks>
    <FileCheck Property="installed" SearchPath="c:\program files\oci" FileName="oraociei10.dll" />
  </InstallChecks>
  <Commands Reboot="None">
    <Command PackageFile="oci.msi" EstimatedInstallSeconds="30">
      <InstallConditions>
        <BypassIf Property="installed" Compare="ValueGreaterThanOrEqualTo" Value="0" />
      </InstallConditions>
    </Command>
  </Commands>
  <Strings>
    <String Name="Culture">ko</String>
    <String Name="DisplayName">Oracle Client</String>
  </Strings>
</Package>

* 아직 베타판인 VS 2008용 Bootstrapper 생성프로그램의 경우 저장을 해도 제대로 불러 오지 못하는 심각한 버그가 있으나 생성까지는 잘되니 눈감고 써주자.

3. Clickonce에 필수파일로 지정하자.
만드는 것까지 완료했다면 실재 사용해봐야 할것아닌가?
Clickonce로 배포할 프로그램이 있다면 프로젝트 속성창에 게시탭을 클릭하여 "필수구성요소"를 선택하자.
사용자 삽입 이미지
이제 가슴 떨리는 순간 두근거림과 함께 우리가 생성한 Oracle Client가 보이면 되는것이다.
다행히 Oracle Client가 포함되어 있다. 배포할때 응용프로그램과 같이 배포하면 될것이니 "내 응용 프로그램과 동일한 위치 ~ 다운로드"를 선택하고 확인을 누른다.
사용자 삽입 이미지
만약 보이지 않는다면 저장소 정보 갱신이 늦어졌을터이니
뻐그 많은 "Bootstrapper Manifest Generator"를 띄워서 "Generate Package Installer"를 실행하여 업데이트를 해주자.
사용자 삽입 이미지

휴~ 이제 완료 된것 같다. 써놓고 보니 가히 사용자 지정 필수 구성요소 추가하기 집대성인듯 싶다.
국내최초의 Visual Studio 2008 대상의 사용자 정의 필수 구성요소 추가하기에 대한 글을 읽어주신 여러 블로거들에게 감사를 보낸다.
2008/04/04 10:57 2008/04/04 10:57