Config.xml 참조(Windows SharePoint Services)

  • 아티클

업데이트: 2008-09-18

Windows SharePoint Services 3.0 설치 방법을 제어하려면 Setup.exe와 함께 Config.xml 파일을 사용합니다. 예를 들어 config.xml 파일을 사용하면 다음을 수행할 수 있습니다.

  • Windows SharePoint Services 3.0 자동 설치

  • 여러 서버에서 같은 구성을 사용하여 Windows SharePoint Services 3.0 설치

  • Windows SharePoint Services 3.0의 자동 설치 또는 스트립트를 사용한 설치

이 문서의 내용

  • Config.xml 사용자 지정

  • Config.xml 요소 빠른 참조

  • 작동 방식

  • Config.xml 파일 형식

  • Config.xml 요소 참조

Config.xml 사용자 지정

설치를 제어하려면 우선 텍스트 편집기에서 Config.xml 파일을 편집하여 필요한 요소를 적절한 설정과 함께 포함합니다. 그런 다음 setup.exe /config [path and file name]을 실행하면 Config.xml 파일에 설정된 옵션을 사용하여 Setup.exe가 실행됩니다.

중요

메모장과 같은 텍스트 편집기를 사용하여 Config.xml을 편집합니다. Microsoft Office Word 2007과 같은 범용 XML 편집기는 사용하지 마십시오.

제품 DVD에는 Config.xml 파일의 예제가 들어 있습니다. 이러한 예제 파일은 DVD 루트의 \Files 폴더 아래에서 서로 다른 시나리오에 해당하는 폴더에 저장되어 있습니다. 각 폴더는 다음과 같습니다.

  • Setup   새로 설치를 설정할 때 사용할 config.xml 파일이 들어 있습니다. 서버 또는 서버 팜 구성을 완료하려면 설치 프로그램을 실행한 후 psconfig.exe를 실행해야 합니다.

  • SetupFarmSilent   자동 모드로 서버 팜을 설정할 때 사용할 config.xml 파일이 들어 있습니다.

  • SetupGradualUpgradeSilent   기존 서버 팜을 점진적으로 업그레이드할 때 사용할 config.xml 파일이 들어 있습니다.

  • SetupSilent   Windows 내부 데이터베이스가 설치된 독립 실행형 단일 서버에서 자동 모드로 새로 설치를 설정할 때 사용할 config.xml 파일이 들어 있습니다.

  • SetupUpgradeSilent   기존 서버 팜을 점진적으로 업그레이드할 때 사용할 config.xml 파일이 들어 있습니다.

중요

Windows SharePoint Services 3.0에 포함된 기본 구성 파일에는 SETUP_REBOOT 설정이 생략되어 있습니다. 명령줄 설치의 한 과정으로 다시 시작되지 않도록 하려면 이 설정을 포함해야 합니다.

다양한 업그레이드 시나리오 간의 차이점에 대한 자세한 내용은 업그레이드 방법 결정[Windows SharePoint Services]을 참조하십시오.

Config.xml 요소 빠른 참조

다음 표에는 Config.xml의 요소 목록이 나와 있습니다. 이러한 요소가 나타나는 순서는 중요하지 않지만 예외적으로 Configuration 요소는 가장 먼저 나와야 하며, Command와 같은 요소가 Config.xml에서 나타나는 순서는 설치 도중 요소가 처리되는 방식에 영향을 줍니다.

요소

설명

Configuration

최상위 요소입니다.

ARP

제어판의 프로그램 추가/제거에서 해당 제품에 대한 텍스트와 동작을 제어하는 값입니다.

Command

설치 도중 명령을 실행합니다.

Display

사용자에게 표시되는 UI의 수준입니다.

Logging

설치 도중 수행되는 로깅의 유형에 대한 옵션입니다.

DATADIR

데이터 파일을 저장하는 데 사용할 위치입니다.

Package

설치할 패키지 또는 제품입니다.

Setting

Windows Installer 속성 값입니다.

작동 방식

설치 프로그램은 Setup.exe와 동일한 폴더에서 Config.xml의 복사본을 찾습니다. 해당 위치에 복사본이 없으면 설치하는 제품의 핵심 \Files 폴더에 있는 Config.xml 파일이 사용됩니다.

다음과 같이 /config 설치 프로그램 명령줄 옵션을 사용하여 Config.xml 파일의 위치를 지정할 수도 있습니다.

\\<서버>\<공유>\setup.exe /config \\<서버>\<공유>\<폴더>\config.xml

Config.xml 파일 형식

Config.xml의 XML 요소는 <로 시작되고 />로 끝납니다.

기본 요소 형식은 다음과 같습니다.

<요소_이름 [특성_이름="값"] [특성_이름="값"] … />

예를 들어 다음과 같이 입력합니다.

<Display Level="none" CompletionNotice="no" />

요소 및 특성에서는 대/소문자가 구분됩니다. 특성 값은 따옴표(")로 묶어야 하며 대/소문자가 구분되지 않습니다.

요소 정의는 여러 줄이 될 수 있습니다. 공백, 캐리지 리턴, 줄 바꿈 및 탭 문자는 요소 정의 내에서 무시됩니다.

예를 들어 다음과 같이 입력합니다.

<Display
   Level="none"
   CompletionNotice="no"
/>

팁

요소 정의가 긴 경우 파일을 읽기 쉽도록 특성을 별도의 여러 줄에 배치하고 들여쓰기를 사용하십시오.

Configuration 요소는 특수한 경우이며 필수 항목입니다. 다른 모든 요소는 Configuration 요소 내에 들어 있으며 이 요소는 **</Configuration>**으로 닫힙니다.

다음 예제에서는 Windows SharePoint Services 3.0 패키지를 새로 설치하는 예제 구성 파일을 보여 줍니다.

<Configuration>

   <Package Id="sts">

      <Setting Id="REBOOT" Value="ReallySuppress"/>

      <Setting Id="SETUPTYPE" Value="CLEAN_INSTALL"/>

   </Package>

   <DATADIR Value="%CommonProgramFiles%\Microsoft Shared\Web Server Extensions\12\Data"/>

   <Logging Type="verbose" Path="%temp%" Template="Microsoft Windows SharePoint Services 3.0 Setup(*).log"/>

   <Setting Id="UsingUIInstallMode" Value="1"/>

   <Setting Id="SETUP_REBOOT" Value="Never"/>

</Configuration>

중요   Windows SharePoint Services 3.0에 포함된 기본 구성 파일에는 SETUP_REBOOT 설정이 생략되어 있습니다. 명령줄 설치의 한 과정으로 다시 시작되지 않도록 하려면 이 설정을 포함해야 합니다.

어디에든 주석을 추가할 수 있으며 "<!--", "-->"로 구분합니다.

예를 들어 다음과 같이 입력합니다.

<!-- Install Windows SharePoint Services for clean install, using UI-->

<Configuration>

   <Package Id="sts">

      <Setting Id="REBOOT" Value="ReallySuppress"/>

      <!-- Tells Windows Installer not to reboot -->

      <Setting Id="SETUPTYPE" Value="CLEAN_INSTALL"/>

   </Package>

   <DATADIR Value="%CommonProgramFiles%\Microsoft Shared\Web Server Extensions\12\Data"/>

   <Logging Type="verbose" Path="%temp%" Template="Microsoft Windows SharePoint Services 3.0 Setup(*).log"/>

   <Setting Id="UsingUIInstallMode" Value="1"/>

   <Setting Id="SETUP_REBOOT" Value="Never"/>

   <!-- Tells Setup.exe not to reboot -->

</Configuration>

Config.xml 요소 참조

이 참조의 설명에는 다음과 같은 규칙이 사용됩니다.

굵게

요소 또는 특성 이름

일반 글꼴

표시된 대로 정확하게 입력해야 하는 텍스트

기울임꼴

추가할 값의 자리 표시자

x|y

여러 값 중에서 선택

[x]

선택적 값

Configuration 요소

최상위 요소입니다. 이 요소는 필수이며 다른 모든 요소는 이 요소 안에 나타나야 합니다.

구문

<Configuration>

<Package Id="ID">

...

</Package>

...

</Configuration>

특성

특성

값

설명

Package ID

패키지 ID

설치되는 패키지입니다.

주의

Package Id 특성은 이 Config.xml 파일의 영향을 받는 제품과 기술을 식별합니다.

예제

Windows SharePoint Services 3.0의 패키지 ID는 sts입니다. 다음과 같이 Config.xml에서 sts 패키지 ID를 사용하여 Windows SharePoint Services 3.0을 지정합니다.

<Configuration>
   <Package Id="sts">
   ...
   </Package>
   ...
</Configuration>

ARP 요소

제어판의 프로그램 추가/제거에서 해당 제품에 대한 텍스트와 동작을 제어하는 값을 지정합니다.

구문

<ARP 특성**="값"** [특성**="값"**] ... />

특성

특성

값

설명

ARPCOMMENTS

텍스트

추가 텍스트입니다. 최대 길이는 255자이지만 일부 문자가 표시되지 않을 수도 있습니다.

ARPCONTACT

텍스트

기술 지원 연락처 목록입니다.

ARPNOMODIFY

Yes

사용자가 제품 설치를 수정할 수 없도록 변경 단추를 비활성화합니다.

No(기본값)

사용자가 제품 설치를 수정하도록 허용합니다.

ARPNOREMOVE

Yes

사용자가 제품을 제거할 수 없도록 제거 단추를 비활성화합니다.

No(기본값)

사용자가 제품을 제거하도록 허용합니다.

ARPURLINFOABOUT

URL

제품 홈 페이지의 URL입니다.

ARPURLUPDATEINFO

URL

제품 업데이트 정보가 나와 있는 URL입니다.

ARPHELPLINK

URL

기술 지원을 받을 수 있는 웹 사이트의 URL입니다.

ARPHELPTELEPHONE

텍스트

기술 지원의 전화 번호입니다.

Command 요소

실행할 명령줄을 지정합니다. Command 요소 명령은 초기 설치 및 설치 제거 도중에만 처리됩니다. 초기 설치 후 사용자 지정을 위해 사용된 Command 요소 명령은 무시됩니다.

구문

<Command

Path="경로"

[QuietArg="인수"]

[Args="인수"]

[ChainPosition="Before" | "After"(기본값)]

[Wait="밀리초"]

[QuietWait="밀리초"]

[Execute="Install"(기본값) | "Uninstall"]

[Platform="x86"(기본값) | "x64"]

/>

특성

Path 및 Args 특성에 큰따옴표 두 개("")를 함께 사용하면 큰따옴표(")를 지정할 수 있습니다.

특성

값

설명

Path

경로

MSI(Microsoft® Windows Installer) 패키지 실행 파일에 대한 정규화된 경로입니다.

QuietArg

문자열

Display Level=None인 경우 명령줄에 추가할 인수 문자열입니다.

Args

문자열

실행 파일로 전달될 인수 문자열입니다.

ChainPosition

Before

기본 제품이 설치되기 전에 명령이 실행됩니다.

After(기본값)

기본 제품이 설치된 후 명령이 실행됩니다.

Wait

밀리초

Display Level 특성을 "Full" 또는 "Basic"으로 설정하여 설치하는 경우 프로그램을 실행한 후 설치를 계속하기 전에 이 밀리초 수만큼 대기합니다. 기본값은 대기하지 않음을 나타내는 0입니다.

QuietWait

밀리초

Display Level 특성을 "None"으로 설정하여 설치하는 경우 프로그램을 실행한 후 설치를 계속하기 전에 이 밀리초 수만큼 대기합니다. 기본값은 대기하지 않음을 나타내는 0입니다.

Execute

Install(기본값)

기본 제품을 설치할 때 이 명령을 실행합니다.

Uninstall

기본 제품을 제거할 때 이 명령을 실행합니다.

Platform

x86(기본값)

이 프로그램에 Intel x86 플랫폼이 필요함을 지정합니다. 이 명령은 설치가 실행될 컴퓨터가 이 플랫폼 요구 사항과 일치하는 경우에만 실행됩니다.

x64

이 프로그램에 x86 아키텍처에 대한 x64 확장을 지원하는 64비트 프로세서가 필요함을 나타냅니다. 이 명령은 설치가 실행될 컴퓨터가 이 플랫폼 요구 사항과 일치하는 경우에만 실행됩니다.

주의

이 제품이 설치될 때 연속 설치나 특정 실행 파일이 실행되도록 명령줄을 지정할 수 있습니다. 이러한 경우 단일 MSI 파일이 아닌 Setup.exe에 대한 명령줄을 지정해야 합니다.

Config.xml 파일에 Command 요소가 둘 이상 있으면 Config.xml에 지정된 순서대로 요소가 실행됩니다.

예제

<Command Path=”myscript.exe” Args=”/id ""123 abc"" /q”/>

<Command Path="\\<server>\<share>\setup.exe /config \\<server>\<share>\<folder>\config.xml"

DATADIR 요소

검색 인덱스 파일을 비롯한 데이터 파일을 저장하는 데 사용할 위치입니다.

구문

<DATADIR Value="경로"/>

특성

특성

값

설명

Value

경로

지정된 위치에 데이터 파일이 저장됩니다.

주의

경로에 시스템 환경 변수를 사용할 수 있습니다. 이 요소를 지정하지 않으면 데이터가 다음 경로에 저장됩니다.

%ProgramFiles%\Microsoft SQL Server\MSSQL$SHAREPOINT\Data

예제

<DATADIR Value=”d:\data”/>

Display 요소

사용자에게 표시되는 UI의 수준입니다.

구문

<Display

Level="None" | "Basic" | "Full"(기본값)

CompletionNotice="Yes"(기본값) | "No"

SuppressModal="Yes" | "No"(기본값)

NoCancel="Yes" | "No"(기본값)

AcceptEula="Yes" | "No"(기본값)

/>

특성

특성

값

설명

Level

None

설치 UI가 표시되지 않습니다.

Basic

시작 화면, Microsoft 소프트웨어 사용권 조항(필요한 경우), 진행률 표시줄 및 완료 알림(가능한 경우)이 표시됩니다.

Full(기본값)

사용자에게 모든 UI가 표시됩니다.

CompletionNotice

Yes

Level이 "Basic" 또는 "None"으로 설정된 경우에만 적용되며, 완료 알림을 표시합니다.

No(기본값)

Level이 "Basic"으로 설정된 경우에만 적용되며, 완료 알림을 표시하지 않습니다.

SuppressModal

Yes

Level이 "Basic"으로 설정된 경우에만 적용되며, 설치에 방해가 될 수 있는 오류 메시지 및 기타 대화 상자를 표시하지 않습니다.

No(기본값)

Level이 "Basic"으로 설정된 경우에만 적용되며, 필요에 따라 오류 및 기타 대화 상자를 표시합니다.

NoCancel

Yes

Level이 "Full" 또는 "Basic"으로 설정된 경우 취소 단추(작업 진행 대화 상자의 오른쪽 위 모퉁이에 있는 X)를 비활성화합니다.

No(기본값)

Level이 "Full" 또는 "Basic"으로 설정된 경우 사용자가 진행률 표시줄에서 설치를 취소하도록 허용합니다.

AcceptEULA

Yes

사용자 대신 Microsoft 소프트웨어 사용 조건에 동의합니다. Microsoft 소프트웨어 사용 조건 페이지를 표시하지 않습니다.

No(기본값)

Level이 "None"으로 설정되지 않은 경우 Microsoft 소프트웨어 사용 조건 페이지를 표시합니다.

주의

이 요소를 정의하지 않으면 기본 설정이 사용됩니다. 잘못된 값이 지정된 경우에는 설치가 종료됩니다.

참고

Display 요소는 setup.exe와 동일한 폴더에 Config.xml 파일이 있거나 Setup /config 명령줄 옵션을 사용하여 Config.xml 파일을 지정한 경우에만 사용됩니다.

예제

<Display Level=”basic”
   CompletionNotice=”yes”
   SupressModal=”no”
   AcceptEula=”yes”
/>

Logging 요소

설치 도중 수행되는 로깅의 유형을 지정합니다.

구문

<Logging

Type="Off" | "Standard"(기본값) | "Verbose"

Path="경로"

Template="파일 이름.txt"

/>

특성

특성

값

설명

Type

Off

설치 프로그램에서 로깅을 수행하지 않습니다.

Standard(기본값)

설치 프로그램에서 로그 파일에 설치 정보를 기록합니다.

Verbose

설치 프로그램에서 로그 파일에 모든 설치 정보를 기록합니다.

Path

경로

로그 파일에 사용할 폴더에 대한 정규화된 경로입니다. 환경 변수를 사용할 수 있으며 기본값은 %temp%입니다.

Template

파일 이름.txt

로그 파일의 이름입니다. 파일 이름에 * 문자열을 삽입하면 Setup.exe에서 수행하는 각 설치에 대해 고유한 로그 파일이 만들어집니다(아래 설명 참조). *가 포함되지 않았고 지정된 이름의 파일이 이미 있는 경우 기존 파일에 로그 정보가 추가됩니다. .txt 파일 확장명을 반드시 포함해야 하며 기본 서식 파일은 SetupExe(*).log입니다.

주의

Template 값의 모든 위치에 *****를 지정할 수 있습니다. 해당 위치에 다음과 같은 형식으로 문자열이 삽입됩니다.

YYYYMMDDHHMMSSxxx

여기에서 각 부분이 나타내는 의미는 다음과 같습니다.

  1. YYYY = 년

  2. MM = 월

  3. DD = 일

  4. HH = 시간

  5. MM = 분

  6. SS = 초

  7. xxx = 설치 프로그램에서 생성된 고유 문자열

참고

Logging 요소는 Setup /config 명령줄 옵션을 사용하여 Config.xml 파일을 지정한 경우에만 사용됩니다. 사용할 Config.xml 파일을 지정하지 않으면 기본 로깅 옵션이 사용됩니다.

예제

<Logging Type=”standard” Path=”%temp%”
   Template=”MyLog(*).txt”
/>

이 예제를 사용하면 제품을 설치할 때마다 로그 파일이 만들어지며 다음과 같은 고유 파일 이름이 사용됩니다.

%temp%\MyLog(20060428110717CFC).txt
%temp%\MyLog(20060429113143C70).txt

Package 요소

설치할 패키지 또는 제품입니다.

Windows SharePoint Services 3.0의 패키지 ID는 sts입니다.

Setting 요소

Windows Installer 속성 값을 지정할 수 있습니다.

구문

<Setting Id="이름" Value="값" />

특성

특성

값

설명

Id

이름

Windows Installer 속성의 이름입니다.

Value

값

속성에 할당할 값입니다.

값

다음과 같은 Setting ID가 서버 설치에 사용됩니다.

ID

사용 가능한 값

설명

REBOOT

ReallySuppress

Windows Installer에서 설치가 완료된 후 다시 부팅하도록 허용할지 여부를 지정합니다. ReallySuppress를 사용하면 다시 부팅하지 않도록 지정됩니다. 패키지별 수준이 아닌 전역 수준에서 지정해야 합니다.

SETUP_REBOOT

Never, AutoAlways, Always, AutoIfNeeded, IfNeeded

Setup.exe에서 설치가 완료된 후 다시 부팅하도록 허용할지 여부를 지정합니다. Never를 사용하면 다시 부팅하지 않도록 지정됩니다. 패키지별 수준이 아닌 전역 수준에서 지정해야 합니다.

SETUPTYPE

CLEAN_INSTALL, V2V_GRADUAL_UPGRADE, V2V_INPLACE_UPGRADE

제품 또는 기술의 새 복사본을 설치할 것인지(CLEAN_INSTALL), 이전 버전에서 점진적 업그레이드를 통해 단계적으로 새 버전을 설치할 것인지(V2V_GRADUAL_UPGRADE) 또는 새 버전을 설치하고 이전 버전을 전체 업그레이드할 것인지(V2V_INPLACE_UPGRADE) 지정합니다. 패키지별 수준이 아닌 전역 수준에서 지정해야 합니다.

SETUPCALLED

0 | 1

Package Id 특성의 일부로 사용합니다.

SERVERROLE

SINGLESERVER, WFE

독립 실행형(SINGLESERVER) 또는 프런트 엔드 웹 서버(WFE) 중에서 설치할 서버 유형을 지정합니다.

USINGUIINSTALLMODE

0 | 1

자동 설치를 수행하는지(0) 아니면 설치 프로그램의 사용자 인터페이스를 사용하는지(1)를 지정합니다.

주의

Windows Installer 속성 중 일부는 Setting 요소에서 지정할 수 없습니다. 차단된 속성이 지정된 경우 설치가 종료됩니다. 지원되는 속성이 지정된 경우 설치 프로그램은 해당 속성을 Windows Installer에 직접 전달합니다.

예제

<Setting Id="REBOOT" Value="ReallySuppress" />

이 문서의 다운로드

이 항목은 다운로드 가능한 다음 문서에도 포함되어 있어 더 쉽게 읽고 인쇄할 수 있습니다.

사용 가능한 문서의 전체 목록은 다운로드 가능한 Windows SharePoint Services 관련 문서 (영문)를 참조하십시오.