 |
차세대 ColdFusion 서버인 Macromedia ColdFusion MX에 오신 것을 환영합니다!
다음 릴리즈 노트는 ColdFusion MX의 설치 노트, 알려진 이슈, 최신 뉴스를 기술합니다. 아이디어 및
기법을 공유하려면 http://www.macromedia.com/go/prod_forums_ko의
온라인 포럼을 사용하십시오.
신속한 시작을 도와드리기 위해, ColdFusion의 새로운 사용자 또는 경험있는 웹 개발자의 필요에 맞게 시작하기
정보를 정리해 놓았습니다. ColdFusion Administrator의 시작하기 링크를 사용하십시오. (Windows에서
ColdFusion Administrator에 액세스하려면, 시작 > 프로그램 > Macromedia
ColdFusion MX > Administrator를 선택합니다.)
ColdFusion MX에 관한 자세한 정보를 위해, 제품 정보와 http://www/macromedia.com/kr/software/coldfusion의
자주 묻는 질문을 참조하고, 디자이너/개발자
센터의 MX 응용프로그램 개발 센터를 방문하십시오.
Flash Remoting의 릴리즈 노트 (ColdFusion 페이지, 컴포넌트, Flash 무비로부터의
서버측 ActionScript와 상호작용할 수 있게 해 줌)는 http://www.macromedia.com/go/flashremoting_releasenotes_ko에서
찾아 볼 수 있습니다.
ColdFusion MX 설치 및 구성
이 절은 모든 플랫폼, Windows,
UNIX의 주요한 설치 정보를 기술합니다. 이 절은 시스템 요구사항이나
설치 설명서를 제공하지 않습니다. 이 정보를 위해, ColdFusion MX 설치를 참조하십시오.
주의: 이 절에서,cf_root는 ColdFusion MX를 설치한
디렉토리를 나타냅니다. 기본 값으로 이는 Windows의 C:\CFusionMX와 UNIX의 /opt/coldfusionmx입니다.
다음 테이블은 설치 관련 작업 목록을 나열하고 작업 완료에 필요한 정보를 찾을 수 있는 곳을 기술합니다.
| 작업 |
정보 리소스 |
| ColdFusion 응용프로그램의 ColdFusion MX로의 마이그레이션 |
이 문서의 ColdFusion으로부터의 마이그레이션절 및 ClodFusion
5 응용프로그램 마이그레이션 |
| ColdFusion MX의 Flash Remoting 서비스를 사용한 ColdFusion 페이지, 컴포넌트,
Flash 무비의 서버측 ActionScript와의 상호작용 |
Flash Remoting 사용 설명서 및 ColdFusion MX에서 서버측 AutoScript 사용
설명서
주의: Flash Remoting
컴포넌트를 Flash MX 작성 환경에 설치해야 합니다. Flash MX 작성 환경은 ColdFusion의
Flash Remoting 서비스에 연결하고 상호작용하는 응용프로그램 구축에 필요합니다. |
| ClusterCATS 설치 |
플랫폼에 적합한 셋업 파일을 다운로드하려면, http://www.macromedia.com/go/cfmx_clustercats_ko를
참조하십시오.
설치 설명을 위해,ClusterCATS 사용 설명서를 참조하십시오. |
모든 플랫폼용 설치 노트
다음 테이블은 모든 플랫폼에 적용되는 ColdFusion MX 설치 및 구성에 관한 중요한 정보를 기술합니다.
| 작업 |
이슈 |
| 설치 준비 |
ColdFusion MX 프리 릴리즈 버전을 설치한 경우, 이를 제거한 후 플랫폼에 따라 다음 중 하나를
실행해야 합니다.
- Windows에서 cf_root 디렉토리 (Neo 또는 CFusionMX)를
제거한 후 컴퓨터를 다시 시작합니다.
- UNIX에서, cf_root 디렉토리 (neo 또는 coldfusionmx)를
제거한 후 활성화된 ColdFusion MX 프로세스를 중단합니다.
이를 위해, 활성화된 프로세스 IDs (PIDS)가 있는 지를 확인하기 위해 ps -eaf
| grep cfusion 또는 ps -eaf | grep neo를
입력한 후, 활성화된 각 ColdFusion MX 프로세스에 대해 kill -9 <PID>를
실행합니다.
프리-릴리즈 버전을 제거하지 않고 ColdFusion MX 설치를 시도하는 경우, 설치기가 이의 제거를
프롬프트합니다. |
ColdFusion MX는 실행을 위해 Java Runtime Environment
(JRE)를 사용하고, 기본 값으로 자체 Sun JRE 1.3.1_03 사본을 Windows의 ..\runtime\jre
디렉토리와 Solaris 와 Linux의 ../jre 디렉토리에 설치합니다. (HP-UX에서, ColdFusion
MX는 HP JRE 릴리즈 1.3.1_01을 사용합니다.)
컴퓨터가 JRE 최소 시스템 요구사항을 충족시키는지 확인하십시오. SUN JRE 1.3.1_03 릴리즈
노트는 http://java.sun.com/j2se/1.3/에
위치해 있습니다. |
| 동일 컴퓨터에 ColdFusion MX와 JRun 설치 |
JRun 3.x 또는 4.0이 설치된 컴퓨터에 ColdFusion MX를 설치하고 JRun이 외부 웹
서버에 연결되도록 구성하는 경우, ColdFusion MX에 동일 외부 웹 서버를 구성하는 것은 JSP
페이지와 서블렛이 JRun이 아닌 ColdFusion MX를 통해 프로세스되게 합니다.
|
| ColdFusion MX를 IIS, Apache, 또는 Netscape/iPlanet
웹 서버에 설치한 후 JRun 3.x 또는 JRun 4를 설치하는 경우, ColdFusion MX 구성이
없어지기에 ColdFusion MX용 웹 서버를 다시 구성해야 합니다. |
| 웹 서버 구성 |
ColdFusion MX가 지원하는 웹 서버는 다음과 같습니다. IIS 4.0 및 5.x (Windows
전용), Apache 1.3.2x, 이후 버전, 2.x, Netscape 3.6x, iPlanet 4.x,
6.x, Zeus 4.1 (Linux SuSE 전용), ColdFusion MX 내장 웹 서버 |
| ColdFusion MX를 사용하기 위해 Apache 또는 Netscape/iPlanet
웹 서버를 구성하는 경우, ColdFusion Administrator는 기본적으로 포트 80에서 시작합니다.
웹 서버가 다른 포트에서 구동하는 경우, ColdFusion Administrator가 이를 반영하도록
URL을 변경해야 합니다. |
ColdFusion MX를 위해 EAPI를 지원하는 Apache 웹 서버
인스턴스를 구성하는 경우, Apache 서버의 이 인스턴스를 시작하면, 다음과 같은 에러가 발생합니다.
[경고] DSO c:/cfusionmx/runtime/lib/wsconfig/1/mod_jrun을
로드했습니다. 기본 Apache 1.3 API를 사용하십시오. 이 모듈은 EAPI하에서 충돌할 수 있습니다.
(-DEAPI로 이를 재 컴파일하십시오.)
이 에러를 안전하게 무시할 수 있습니다. ColdFusion Apache 모듈은 어떠한 EAPI 기능도
활용하지 않기에 EAPI로 컴파일되지 않았습니다.
그러나, 문제가 발생하는 경우, Macromedia 기술 지원에 문의해 주십시오. |
ColdFusion MX를 사용하여 문서 루트가 다른 다수의 호스트 이름을
사용하는 웹 서버 ("multihomed" 서버)는 ProxyService의
cacheRealPath 옵션을 반드시 False로 변경해야 합니다. 그렇치 않은
경우, 두 사이트의 웹 루트와 관련된 스크립트 이름이 동일한 경우 (예: /index.cfm), 웹 서버는
스크립트를 부정확하게 제공할 수 있습니다. 이 설정은 성능의 저하를 초래할 수 있습니다. 이로 인해 이
옵션은 기본 값으로 True로 설정합니다.
c:/cfusionmx/runtime/servers/default/SERVER-INF/jrun.xml을
편집하고 다음 옵션 값을 True에서 False로 변경합니다.
<!-- 복수 호스트된 사이트의 경우 이를 False로 설정합니다.
-->
<attribute name="cacheRealPath">true</attribute>
|
| 예를 들어 동일 템플릿을 다른 웹 서버에서 비교하기 위해, ColdFusion
MX를 동일 컴퓨터의 여러 웹 서버에서 실행할 수 있습니다. 이를 위해 ColdFusion MX 설치의
다음 설명에 따라 각 웹 서버를 구성합니다. 그 후 CFIDE 디렉토리를 가리키는 가상 맵핑을 생성합니다. |
| IIS, Apache, Netscape 웹 서버 커넥터에 문제가 발생하는
경우, 이에 관한 정보를 제공하는 로그 파일이 있습니다. 문제 진단을 돕기 위해 이 파일을 기술 지원 엔지니어에게
제공하십시오. 이 로그 파일은 Windows의 cf_root\runtime\lib\wsconfig\wsconfig.log에,
UNIX의 cf_root/runtime/lib/wsconfig/wsconfig.log에 위치해 있습니다. |
| ColdFusion MX로의 업그레이드 후 cfusion 디렉토리 삭제 |
Simple Network Mail Protocol (SNMP)을 실행하는 컴퓨터에서 기존 ColdFusion
설치를 ColdFusion MX로 업그레이드한 후 cfusion 디렉토리를 제거하는 경우, 다음 파일은
제거되지 않습니다.
c:\cfusion\cfam\program\ihmib.dll
c:\cfusion\cfam\program\mibmsg.dll
이 문제를 해결하기 위해, SNMP을 중단하고 cfusion 디렉토리를 삭제합니다. |
Windows 설치 노트
다음 테이블은 ColdFusion MX를 Windows에 설치, 구성하는 중요한 정보를 기술합니다.
| 작업 |
이슈 |
기존 ColdFusion이 설치된 컴퓨터에 설치
(ColdFusion과 ColdFusion MX간의 호환성 이슈에 관해, 이 문서의 ColdFusion으로부터의
마이그레이션절을 참조하십시오.) |
ColdFusion MX 설치기가 컴퓨터에서 ColdFusion 이전 버전을 탐지하는 경우, 다음 옵션을
갖는 업그레이드 대화상자가 나타납니다.
- 공존 - 이 옵션은 기본 값으로 선택됩니다. 이를 선택하는 경우,
동일 컴퓨터에서 양 ColdFusion 버전을 실행할 수 있습니다. 이전 버전을 그대로 남겨두고,
기본 값으로, ColdFusion MX는 포트 8500의 내장 웹 서버에서 실행됩니다. 설치 후
다른 웹 서버에서의 실행을 위해 ColdFusion MX를 구성하려면, ColdFusion
MX 설치의 시스템 구성장을 참조하십시오.
- 업그레이드 - 이 옵션은 ColdFusion 이전 버전을 제거하고
ColdFusion MX를 설치합니다.
두 옵션 모두, 설치 후 ColdFusion Administrator를 시작할때, 설정을 ColdFusion에서
ColdFusion MX로 마이그레이트하도록 프롬프트됩니다. 업그레이드 완료를 위해 이를 실행해야 합니다. |
ColdFusion 설정을 ColdFusion MX (ColdFusion으로부터
업그레이드한 후)로 마이그레이트하는 경우, 레지스트리에 저장된 클라이언트 변수 데이터는 ColdFusion
MX 레지스트리 위치로 이동합니다. ColdFusion 설치로부터 복사하는 레지스트리의 클라이언트 데이터량이
지나치게 큰 경우, 레지스트리는 복사 작업 중 용량 한도에 도달할 수 있습니다. 이 경우, ColdFusion
MX는 복사 작업을 중단하고 다른 ColdFusion 설정의 마이그레이션을 계속 진행합니다. 또한 다음과
같은 에러를 볼 수도 있습니다.
값
hkey_local_machine\software\macromedia\coldfusion\currentversion\을
설정할 수 없습니다.
Clients\141363-76934365\\HITCOUNT: Windows 에러 번호 0이 발생했습니다.
요청한 서비스를 완료하기에 불충분한 시스템 리소스가 존재합니다.
|
| Windows에 ColdFusion MX 설치 |
설치하는 동안, 프로그램 파일 및 ColdFusion MX의 웹 루트 디렉토리 위치를 입력하라고 프롬프트됩니다.
다음 버튼을 클릭한 후 잠시 지연이 있을 수 있습니다. 설치 과정을 취소하지 마십시오. 설치기는 웹 루트
경로에 상충되는 폴더 (예: CFIDE 또는 CFDOCS)가 있는지 확인하고 파일명에 "_0"
(예: CFIDE_0, CFDOCS_0)을 사용하여 이를 백업합니다. |
| 복구 및 수정 옵션은 제거되었으며 최종 릴리즈에서 지원되지 않습니다. ColdFusion
MX의 프리-릴리즈 버전이 설치되어 있는 경우, 최종 버전 설치에 앞서 이를 제거해야 합니다. 기존 버전위에
최종 버전의 설치를 시도하는 경우, 프로그램을 복구, 수정, 또는 제거하도록 프롬프트됩니다. 그러나 오직
제거 옵션만이 지원됩니다. 이것이 바로 Windows Installer의 한계로, 설치기는 설치하고자 하는
버전의 제거 프로그램을 시작하기 보다 설치된 버전의 제거 프로그램을 시작합니다. |
| ColdFusion MX용 IIS 구성 |
ColdFusion MX를 설치하는 동안 IIS를 선택한 경우, 이 작업을 수행하지 않아도 됩니다.
그러나, IIS로 전환하거나 설치 후 IIS를 재구성하려면, 다음 명령어를 단일 (긴) 라인에 입력합니다.
cf_root\runtime\jre\bin\java -cp cf_root\runtime\lib
-jar cf_root\runtime\lib\wsconfig.jar
-ws IIS -site "0" -filter-prefix-only
-map .cfm,.cfc,.cfml,.jsp -v
다음은 단순 명령어입니다.
c:\cfusionmx\runtime\jre\bin\java -cp c:\cfusionmx\runtime\lib
-jar c:\cfusionmx\runtime\lib\wsconfig.jar
-ws IIS -site "0" -filter-prefix-only
-map .cfm,.cfc,.cfml,.jsp -v
이는 ColdFusion MX 설치에 기술된 내용과 상충됩니다. (제 2장: 시스템 구성
> 웹 서버 구성 > Windows에서 Internet Information Server (IIS)
구성 - 이는 -ws 대신 -wd를 갖습니다.
주의: -site "0"을
사용하는 것은 ColdFusion MX의 모든 IIS 웹 사이트를 구성하는 반면 -site "1"을
사용하는 것은 기본 웹 사이트만을 구성합니다. 또한 이름이 명명된 웹 사이트도 입력할 수 있습니다. 예를
들어,
-site "foo"를 입력할 수 있습니다. |
| IIS용 웹 서버 커넥터는 IIS ISAPI 필터 및 IIS 응용프로그램
맵핑을 생성합니다. 이는 둘다 IIS 마스터 특성 레벨에 설정되어, 설치기가 ColdFusion MX용
모든 IIS 웹 사이트를 기본 값으로 구성합니다. 또한 사이트를 IIS에 추가하는 경우, 이는 ColdFusion
MX 설정을 자동으로 상속받습니다. 그렇치 않은 경우, 마스터 레벨로부터 응용프로그램 맵핑을 수동으로 적용해야
합니다.
|
IIS용 웹 서버 커넥터는 최종 릴리즈에서 변경되었습니다. 프리-릴리즈 버전에서,
IIS용 ColdFusion MX 커넥터는 변경사항이 모든 사이트에 적용되도록 IIS 마스터 특성을 구성했습니다.
그러나 이 설정이 사이트 레벨로 전파되지 않는 문제로 인해, 커넥터는 이제 ColdFusion MX의 기본
웹 사이트 만을 구성합니다. 이를 변경하여 ColdFusion MX의 모든 IIS 사이트를 구성하기 원하는
경우, 다음을 실행합니다.
- Run cf_root/bin/Remove_all_connectors.bat
- Run cf_root/bin/IIS_connector.bat
|
UNIX 설치 노트
다음 테이블은 ColdFusion MX를 UNIX에 설치, 구성하는 중요한 정보를 기술합니다.
| 작업 |
이슈 |
| 설치 준비 |
ColdFusion MX 설치 실행에 앞서, 모든 ColdFusion 또는 JRun 관련 서비스를 중단해야
합니다. |
| ColdFusion MX를 Linux에서 설치, 실행하려면, 우선 최신 버전의
glib, glibc, libstdc++, gcc 라이브러리를 설치해야 합니다. 이 패키지에 관한 정보를
위해 Linux 벤더의 웹 사이트를 참조하십시오. 예를 들어, Red Hat 7.1은 glibc-2.2.2-10을
포함하나, ColdFusion MX는 glibc-2.2.4-24를 필요로 합니다. 또한 Red Hat 7
또는 이상의 모든 버전의 경우, compat-libstdc++ rpm을 반드시 설치해야 합니다. Red
Hat의 이 rpm 및 기타 RPMs는 ftp://ftp.redhat.com/pub/redhat에서
확보할 수 있습니다. SuSE 사용자는 RPM 업데이트를 ftp://ftp.suse.com/pub/suse에서
찾을 수 있습니다. |
| UNIX에 설치하려면, 400MB 자유 디스크 공간 (500 MB가 권장됨)이
필요합니다. 이는 제품 패키징 및 ColdFusion MX 설치에 기술된 내용과 상충됩니다. |
기존 ColdFusion이 설치된 컴퓨터에 설치
(ColdFusion과 ColdFusion MX간의 호환성 이슈에 관해, 이 문서의 ColdFusion으로부터의
마이그레이션절을 참조하십시오.) |
ColdFusion MX UNIX 설치기는 컴퓨터에 설치된 ColdFusion 이전 버전을 자동으로
탐지하지 않습니다. 대신 다음과 같은 프롬프트를 디스플레이합니다.
이 컴퓨터에 설치된 ColdFusion 버전이 존재합니까?
대답이 아니오인 경우, ColdFusion 설정을 ColdFusion MX로 업데이트 또는 마이그레이트하라는
프롬프트가 나타나지 않습니다.
예인 경우, ColdFusion Administrator를 시작하면, 설치 후 ColdFusion 설정을
ColdFusion MX로 마이그레이트하는 옵션이 주어집니다. 또한 설치기는 다음과 같은 프롬프트를 디스플레이합니다.
기존 ColdFusion 설치를 업그레이드하시겠습니까?
대답이 아니오인 경우, 기존 ColdFusion 설치는 업그레이드되지 않습니다. 두 버전의 ColdFusion을
컴퓨터에서 실행할 수 있으며, 기본 값으로 ColdFusion MX는 포트 8500의 내장 웹 서버에서
실행될 것입니다. 설치 후 ColdFusion MX를 구성하여 다른 웹 서버에서 실행하려면, ColdFusion
MX 설치의 시스템 구성장을 참조하십시오.
대답이 예인 경우, 설치기는 ColdFusion 이전 버전을 제거하고 ColdFusion MX를 설치합니다. |
| UNIX에 ColdFusion MX 설치 |
ColdFusion MX는 본 릴리즈에서 UNIX용 GUI 설치기를 지원하지 않습니다. |
| Admin 및 RDS 암호는 설치하는 동안 일반 텍스트에 디스플레이됩니다. |
| UNIX 설치기는 잠시동안 중단되는 설치 끝 무렵에 상태 바를 디스플레이합니다.
이는 예상된 비헤비어로, 설치기가 중단된 것이 아닙니다. 설치기가 작업을 완료할 수 있도록 참을성 있게
기다려 주십시오. |
설치 후, cf_root 디렉토리에서 런타임 디렉토리를
볼 수 없는 경우, 설치하는 동안 임시 디스크 공간이 부족했을 수도 있습니다. (설치기는 임시 디렉토리에
설치기가 확장할 만한 충분한 디스크 공간이 있는 지 올바르게 탐지하지 못합니다.) 이 문제를 해결하기 위해,
ColdFusion MX를 제거하고 임시 디렉토리를 분할에서 최소 400 MB, 최대 500 MB의 자유
디스크 공간을 갖는 디렉토리로 변경한 후, 다시 설치합니다.
임시 디렉토리를 변경하려면, 다음 명령어를 나열된 순서대로 실행합니다.
주의:
다음 명령어의 '/home/tmp'는 많은 자유 디스크 공간을 갖는 분할의 디렉토리를 나타냅니다. 예를
들어, 대부분의 Linux 시스템에서 /home을, Solaris에서 /export/home을 사용할 수
있습니다.
mkdir /home/tmp
IATEMPDIR=/home/tmp
export IATEMPDIR
echo $IATEMPDIR
echo 명령어를 실행하면, 환경 변수를 무엇으로 설정했는지 확인할 수 있습니다. |
| ColdFusion 이전 버전이 목표 컴퓨터에 설치된 경우, 설치하는 동안
업그레이드 옵션을 선택하더라도, ColdFusion 이전 버전의 원시 데이터 소스가 UNIX의 ColdFusion
MX에 자동으로 마이그레이트되지 않음에 유의하십시오.
|
| ColdFusion MX 컨넥터 마법사 |
로컬라이즈된 유닉스 기반의 콜드퓨전 MX에서 콜드퓨전 서버가 처음으로 시동할때 만일 컨넥터를 생성하는데
실패하면, 컨넥터 마법사는 컨넥터를 만들기 위해서 재시도를 하지 않습니다. 컨넥터 마법사는 성능이 낮은
컴퓨터에 인스톨 할때만 실패합니다. 만일 컨넥터 마법사가 컨넥터 생성에 실패하고, 콜드퓨전 서버가 시동
되었으면, 유저가 컨넥터를 생성하기 위해서 컨넥터 마법사 셀 스프립트 (cfmx-connectors.sh)를
수동으로 실행 해야 합니다. 이를 위해서 다음을 실행하십시오.
Run cf_root/bin/cfmx-connectors.sh |
| ColdFusion MX 실행 |
Linux에서, 'ps' 명령어를 실행하면 여러 cfusion 프로세스를 출력합니다. 이는 예상된 비헤비어입니다.
이는 Linux가 스레드를 처리하는 방법으로 인해 개별 프로세스가 아닌 스레드입니다. |
| Solaris에서, ColdFusion MX는 세션으로부터 로그 아웃할 때
종료될 수 있습니다. 이는 Java와 Solaris의 nohup이 갖는 이슈입니다. 이 이슈를 피하려면,
Korn 또는 Bash 셀로 드롭하고 (ksh 또는 bash
입력), ColdFusion MX를 시작합니다. |
목차로 돌아가기
ColdFusion으로부터의 마이그레이션
다음 테이블은 ColdFusion MX에서 실행하기 위해 응용프로그램을 변경해야 할 수도 있는 ColdFusion
MX와 ColdFusion간의 차이를 기술합니다.
주의: 이 차이는 ColdFusion 5 응용프로그램 마이그레이션에
기술되지 않은 추가 사항입니다.
| 제품 영역 |
호환 이슈 |
| SQL 서버에 이중 바이트 문자 저장 |
nchar, nvarchar, 또는 ntext 데이터 유형의 유니코드가 아닌 이중 바이트 데이터를 SQL
Server 데이터베이스에 저장하는 경우, 이 데이터를 유니코드 인코딩으로 변환해야 할 수도 있습니다.
|
| 에러 변수 |
cferror 변수 구조는 변경되었습니다. 에러 변수의 cfdump
(<cfdump var=#error#>)는 ColdFusion 5의 단일
레벨 배열을 나타내는 반면 ColdFusion MX에서 이는 복수 레벨 배열입니다. "error."
표기법을 갖는 에러 변수에 액세스하려면, 추가 배열 값을 사용해야 합니다. 예를 들어, ColdFusion
5에서 ErrorCode는 ERROR.ERRORCODE인
반면, ColdFusion MX에서 이는 ERROR.ROOTCAUSE.ERRORCODE입니다.
<cfdump>을 사용하여 모든 값을 볼 수 있습니다.
|
| 이름에 3개 이상의 점이 있는 변수 |
ColdFusion 5와 이전 버전에서, 다음 예에서와 같이 이름에 3개 이상의 점이 있는 변수를 갖을
수 있었습니다.
<cfset a.b.c.d.e = "foo">
<cfoutput>
"#a.b.c.d.e#"
</cfoutput>
이러한 변수는 ColdFusion MX에서 실패하며, 다음과 같은 에러 메시지를 출력합니다.
요소 B.C.D.E는 A에 정의되어 있지 않습니다.
이는 새로운 구조 자동 생성 기능이 3레벨 이상의 구조를 적절히 생성하지 못하기 때문입니다.
이름에 3개 이하 또는 3개의 점을 갖는 변수는 문제없이 기능합니다. |
| 이진 값 |
ColdFusion MX에서, 이진 문자열은 바이트 배열 (참조별 지정)로 표시됩니다. 따라서 표준
CFML 배열 논리를 사용하여 조작할 수 있습니다. ColdFusion 5에서 이진 값은 변경할 수 없습니다.
(복사별 지정) |
| 동일한 이름을 갖는 열 |
모든 ColdFusion 버전에서, 이름이 동일한 두 열이 데이터베이스로부터 반환되는 경우, ColdFusion
결과 세트로 선택할 열은 정의되어 있지 않습니다. (이론적으로 이는 임의입니다.) 그러나 실제로 ColdFusion
이전 버전에서는 열 선택을 예측할 수 있었습니다. 그러나 이는 ColdFusion MX에서 불가능하므로,
어떠한 경우에건, 이름이 동일한 열의 예측할 수 있는 선택에 의존하지 마십시오. 대신 열 별명을 사용하여
모든 불확실성을 제거합니다. |
| 중복되는 URL 매개변수 |
ColdFusion MX는 중복되는 URL 매개변수를 ColdFusion 5와 다르게 처리합니다. ColdFusion
5에서, Test.cfm?a=1&a=2를 호출하면 URL 매개변수로 값 a=2를
반환하나, ColdFusion MX는 값 a=1,2를 반환합니다. |
| ColdFusion MX의 예약된 단어 |
현재 ColdFusion MX에서, 동일한 이름을 갖는 변수를 범위 (응용프로그램, CGI, 클라이언트,
쿠키, 양식, 요청, 서버, 세션, URL, 또는 변수)로 생성할 수 있습니다. 생성한 변수는 변수 범위
접두사를 분명히 사용하는 경우에만 볼 수 있습니다. 그렇치 않는 경우, 에러가 발생합니다. 그러나, 범위
이름은 ColdFusion MX에 예약되어 있으며, 이는 이후 버전에서 시행될 수 있습니다. 따라서 Macromedia는
범위 이름을 변수 이름으로 사용하지 말 것을 강력히 권장합니다.
또한 Query of Queries에서, SQL 예약 단어는 대괄호 []를 사용하여 이스케이프하지 않은
이상 (예: SELECT [count] FROM MYTABLE), 변수 또는 열 이름으로 더 이상 사용할
수 없습니다.
ColdFusion MX의 예약 단어에 관한 자세한 정보를 위해, CFML을 사용한 ColdFusion
응용프로그램 개발의 제 2장: ColdFusion 요소와 제 22장:Ouery
of Queries 사용을 참조하십시오. |
| 스케줄러 데이터 |
ColdFusion 5에서, 모든 스케줄러 정보는 레지스트리에 저장되어 있습니다. 각 레지스트리 키의
이름은 공백없이 붙여 씁니다. (예:StartDate). ColdFusion MX에서, 스케줄러 정보는
XML 파일에 저장되고, 이전 레지스트리 키의 포맷은 변경되어, 모든 복합 변수 이름은 밑줄로 분리됩니다.
(예: Start_Date). 이는 ColdFusion 5 레지스트리의 스케줄러 정보를 사용하는 응용프로그램에만
적용됩니다.
|
ColdFusion Administrator에서 운영체제 기록 기능
옵션 사용 |
(Windows용) ColdFusion MX는 항상 Windows 기록 기능을 사용하기에, ColdFusion
Administrator의 디버깅 & 기록 > 기록 설정 페이지에 운영체제 기록 기능 사용
옵션은 더 이상 존재하지 않습니다.
|
| Verity 검색 |
(Windows 용) ColdFusion 5를 위해 cfusion\bin 또는 cfusion\verity\_nti40\bin을
시스템 경로에 추가한 경우, ColdFusion MX가 정확한 Verity DLL 파일을 찾을 수 있도록
ColdFusion MX로의 업그레이드에 앞서 이를 제거해야 합니다. |
| COM 메소드의 리터럴 값 |
ColdFusion에서, 참조가 전달하는 단순 값을 사용하는 Component Object Model
(COM) 메소드를 호출할 때 리터럴 값을 사용할 수 있습니다. ColdFusion MX는 COM 객체에
변수를 전달할 수 있는 방법에 보다 엄격한 규칙을 적용하며 이를 지원하지 않습니다. 대신, 참조가 메소드
인수를 전달하는 경우, 변수를 CFML 코드의 인수로 사용해야 합니다.
예를 들어, 다음과 같이 COM 메소드를 비쥬얼 베이직에 선언할 수 있습니다.
Public Sub SetString(sName As String)
_sName = sName
End Sub
ColdFusion에서 다음과 같은 코드를 사용하여 "로보트"라는 이름을 SetString
COM 메소드에 전달할 수 있습니다.
<cfobject action="create" type="com" class="comtest.clstest"
name="otest" context="inproc">
<cfscript>
otest.SetString("Robert");
</cfscript>
ColdFusion MX에서, 문자열 값을 변수에 입력한 후 다음과 같이 COM 메소드를 호출할 때 변수
이름을 사용해야 합니다.
<cfobject action="create" type="com" class="IEcomtest.clstest"
name="otest" context="inproc">
<cfscript>
stringVar = "Robert";
otest.SetString("stringVar");
</cfscript>
주의: 변수 이름을 메소드 호출의 "인용 부호"내에 입력해야
합니다. 이는 ColdFusion MX가 변수를 평가하고 그 값을 문자열로 메소드에 전달하는 것을 막아줍니다.
|
일본어 버전,
정렬 기능 |
ColdFusion MX에서 ListSort()와 ArraySort()와
같은 정렬 함수는 일본어 버전의 ColdFusion 5와 약간 다른 순서로 항목을 반환합니다. 이는 ColdFusion
MX는 유니코드 문자 수별로 문자를 정렬하는 반면, 일본어 버전의 ColdFusion 5는 shift_jis
문자 수별로 문자를 정렬하기 때문입니다.
|
| LSIsDate() |
ColdFusion MX에서, LsIsDate("3-1-2002")은
No를 반환하는 반면, ColdFusion 5는 Yes를 반환합니다. 이 함수는 하이폰 문자 (-)만을
네델란드어 (표준어) 및 포르투칼어 (표준어) 로케일의 날짜 구분자로 사용합니다.
|
DateFormat(), TimeFormat()
LSDateFormat(), LSTimeFormat() |
부적절한 마스크를 이 함수에 전달하는 경우 (예: "dd-mm-yymm"), 함수는
ColdFusion 5와 ColdFusion MX에서 부적절한 문자를 출력합니다. 그러나 ColdFusion
5는 출력된 각 문자를 아포스트로피 (') 문자로 구분합니다.
|
| ParameterExists() |
ParameterExists()는 ColdFusion MX에서 디프리케이트됩니다.
대신 IsDefined()를 사용합니다. |
| cfdirectory |
action=list인 경우, cfdirectory는
Windows와 UNIX에서 읽기 전용 및 숨기기 속성만을 보고합니다. UNIX에서, 이는 모드 및 속성을
빈 값으로 반환합니다. Windows 로컬 머신 디렉토리에 관한 추가 정보가 필요한 경우, cfexecute을
사용합니다. UNIX에서 cfexecute와 ls -l을 사용합니다.
|
| cfheader |
cfheader statusCode 속성으로 설정한 페이지의
상태 코드 헤더에 액세스하려면,
<cfdump var="#cfhttp#">
또는 <cfdump var="#cfhttp.statuscode#">를
사용합니다.
<cfdump var="#cfhttp.responseheader#">를
사용하지 마십시오.
.
주의: statusCode 속성으로 설정한
statuscode 값은 name 속성으로 설정한 status_code
값과 동일하지 않습니다. |
| cfloop |
이 태그는 ColdFusion 5에서 처럼 구조 키를 알파벳 순으로 더 이상 반환하지 않습니다. 이는
ColdFusion 5 응용프로그램 마이그레이션 내용과는 반대로, 특정 순서없이 구조 키를 반환합니다. |
목차로 돌아가기
최신 뉴스
다음 테이블은 ColdFusion MX와 함께 설치된 버전으로부터 본 릴리즈 노트에 변경된 사항을 기술합니다.
| 제품 영역 |
변경사항 |
| 문서 |
ColdFusion MX 문서에 대한 최신 변경사항은 Macromedia 웹 사이트의 문서 업데이트 페이지 (TechNote 22811) 및 문서 추가 페이지 (TechNote 22993)에 기술되어 있습니다. |
| 설치 |
ColdFusion MX의 설치 및 구성 > 모든 플랫폼용 설치 노트 > ColdFusion
MX로 업그레이드 후 cfusion 디렉토리 삭제를 추가했습니다. |
| ColdFusion MX의 설치 및 구성 > 모든 플랫폼용 설치 노트
> 웹 서버 구성에서 multihomed 서버에 관한 노트를 업데이트했습니다. |
| ColdFusion MX 설치 및 구성 > UNIX 설치기 노트 >
UNIX에 ColdFusion MX 설치에 UNIX용 GUI 설치기에 관한 노트를 추가했습니다. |
| ColdFusion MX 설치 및 구성 > Windows 설치 노트
> ColdFusion MX용 IIS 구성에서 ColdFusion MX용 IIS 구성법에 관한 노트를
업데이트했습니다. (이제 이 노트는 설치하는 동안 IIS를 선택하지 않은 경우에만 이 작업을 실행해야 함을
명확히 설명합니다.) |
| Verity 콜렉션 마이그레이션 |
Verity 검색 > ID 46057를 추가했습니다. |
| ParameterExists() |
ColdFusion으로부터의 마이그레이션 > ParameterExists()를 추가했습니다. |
| 문자 인코딩 |
현지화 > ID 44878를 추가했습니다. |
| OS/390용 DB2 UDB |
ColdFusion MX > ID 45314에 데이터 소스 구성을 추가했습니다. |
| DB2 및 Informix용 데이터베이스 드라이버 |
ColdFusion MX > ID 45290에 데이터 소스 구성을 추가했습니다. |
| UNIX에서의 일본어 및 한국어 판 Verity |
현지화 > ID 37650를 업데이트했습니다. |
목차로 돌아가기
성능 및 확장성
다음 테이블은 ColdFusion MX로 성능을 극대화하는 정보를 기술합니다.
| 제품 영역 |
노트 |
| 설치된 JRE |
기본 값으로, ColdFusion MX는 HP-UX를 제외한 모든 플랫폼에서 SUN 1.3.1_03
Java Runtime Environment (JRE)와 함께 설치합니다. (HP-UX에서 ColdFusion
MX는 HP JRE 릴리즈 1.3.1_01을 사용합니다.) Macromedia 테스트에 따르면, ColdFusion
MX가 이 JRE를 사용하는 경우, 거의 모든 CFML 연산이 성능과 확장성면에서 ColdFusion 5를
능가합니다. 그러나, 고급 ColdFusion MX 사용자는 보다 신속한 런타임 성능을 위해 기타 JREs
(예: Windows 또는 Linux에서 IBM 1.3.x JRE)의 실험을 원할 수도 있습니다. Java
및 JVM 페이지에서 ColdFusion Administrator의 JREs (또한 가상 머신 또는 VMs로
알려짐)를 전환할 수 있습니다. Java Virtual Machine 경로 옵션을 ColdFusion MX가
사용하기 원하는 JRE의 \JRE 디렉토리로 설정한 후 서버를 다시 시작합니다.
주의: 부적절한 경로를 설정하면, ColdFusion MX를 시작할
수 없습니다. 이 문제를 해결하기 위해, Windows의 cf_root\runtime\bin\jvm.config
파일, 또는 UNIX의 cf_root/runtime/bin/jvm.config 파일에서
경로를 수정합니다. |
| 동시 요청 옵션 |
기본 값으로, ColdFusion MX는 ColdFusion Administrator의 동시 요청 옵션을
10으로 설정하여 설치합니다. 이 설정은 1 - 또는 2-CPU 머신에서 대부분의 응용프로그램에 합리적
성능을 제공합니다. 그러나 대형 SMP (Symmetric Multiprocessing) 머신, 입력/출력
(I/O) 이상 또는 CPU-바운드 특성을 갖는 응용프로그램의 경우, 이 설정을 조정하여 성능을 크게 향상시킬
수 있습니다. 이 설정 조정에 관한 일반 가이드라인으로, 각 CUP당 3-5 값으로 시작하여 필요에 따라
값을 조정합니다. |
| 신뢰할 수 있는 캐시 옵션 |
제작 환경에서의 최대 성능을 위해, ColdFusion Administrator에서 신뢰할 수 있는
캐시 옵션을 활성화시켜야 합니다. |
| 격리 레벨
|
Macromedia 테스트에 따르면, 일부 데이터베이스-집중 응용프로그램은 데이터 소스의 기본 격리
레벨을 간접적 기본 설정인 READ_COMMITTED로부터 READ_UNCOMMITTED로 변경함으로써
성능을 항상시킬 수 있습니다.
이 설정을 변경하려면, Windows에서 cf_root\runtime\servers\default\SERVER-INF\jrun-resources.xml
파일을, UNIX에서 cf_root/runtime/servers/default/SERVER-INF/jrun-resources.xml
파일을 편집합니다. 다음 라인을 (자체 라인으로) 데이터 소스 정의에 추가합니다.
<isolation-level>READ_UNCOMMITTED</isolation-level>
주의: ColdFusion Administrator를 사용하여 데이터 소스
정의를 차후에 편집하는 경우, 그 정의는 격리 레벨 설정 없이 저장됩니다. 이 값을 다시
jrun-resources.xml 파일에 추가해야 합니다. |
전체 데이터 소스의 격리 레벨을 변경하기 원치 않는 경우, cftransaction
태그로 isolation 속성을 지정하여 트랜잭션의 격리 레벨을 명확히 설정할 수
있습니다.
ColdFusion MX에서 JDBC 데이터베이스 드라이버의 기본 격리 레벨은 ColdFusion 5에서
데이터베이스로의 커넥션에 사용했던 ODBC 및 원시 드라이버와 다를 수 있습니다. 높은 격리 레벨은 보다
강력한 데이터 일관성을 보장하나 병행성이 부족하므로 성능에 영향을 미칠 수 있습니다. 트랜잭션의 격리 레벨을
낮은 레벨로 설정하는 것은 성능을 향상시킬 수 있습니다. |
| Component Object Model (COM) 객체에 대한 액세스 |
새로운 COM 객체 인스턴스를 생성하는 Java 호출에는 상당한 시간이 걸릴 수 있습니다. 따라서,
ColdFusion MX에서의 COM 객체 생성에 ColdFusion 5에서 보다 오랜 시간이 걸립니다.
특정 조건하에서 ColdFusion 5 속도에 근접하도록 COM 성능을 향상시킬 수 있습니다. COM 객체를
응용프로그램에서 공유할 수 있는 경우, 즉 각 요청 또는 세션에 대해 COM을 생성할 필요가 없는 경우,
응용프로그램 범위에서 객체를 생성하여 동일 객체를 응용프로그램에 사용합니다. 이 기법은 공유하도록 설계된
COM 객체에서만 사용할 수 있습니다.
여러 세션으로부터 객체에 동시에 액세스하는 것이 가능하므로, 다음과 같은 스레드 및 잠금 이슈도 고려해야
합니다.
- 최고 성능을 위해, 객체는 복수 스레드되어야 합니다. 그렇치 않은 경우, 한번에 오직 한 요청만
객체에 액세스할 수 있습니다.
- 코드가 공통 데이터에 액세스하는 경우 (예: 모든 응용프로그램 세션이 동일 액셀 스프레드시트에
액세스하는 경우), 데이터에 액세스하는 코드를 잠거야 합니다. 일반적으로, 복수 요청이 데이터를
공유하지 않는 경우, 공유 객체를 사용하는 코드를 잠글 필요가 없습니다.
이 기법은 Technical Brief 22921에 상세히 기술되어 있습니다.
Technical Brief 22922에 기술된 바와 같이, Java 스텁을 생성하여 모든 COM 객체의 성능을 향상시킬
수 있습니다. Java 스텁은 COM 객체를 공유하는 것 만큼 프로세스 시간을 향상시킬 수 없으나, 모든
COM 객체와 함께 사용할 수 있습니다. 또한 COM IDispatcher 인터페이스를 통해 모든 피쳐를
적절히 사용할 수 없는 복잡한 COM 객체에 올바르게 액세스하려면 Java 스텁을 생성해야 합니다. 따라서,
성능을 최대한 향상시키고 가능한 문제를 예방하려면, 두 기법을 결합하여 사용하십시오. |
목차로 돌아가기
현지화
다음 테이블은 ColdFusion MX의 알려진 현지화 이슈를 기술합니다.
노트:
- 이 절에서, "이중 바이트"는 아시아 언어에 사용되는 특정 이중-바이트 인코딩 (예:
hift_jis 및 euc_kr)을 가리킵니다.
- 이 절에서,cf_root는 ColdFusion MX를 설치한 디렉토리를 나타냅니다. 기본
값으로 이는 Windows의 C:\CFusionMX와 UNIX의 /opt/coldfusionmx입니다.
| 이슈 |
ID |
게시 메소드를 사용하는 양식을 통해 데이터를 제출하고 enctype="multipart/form-data"인
경우, 문자 인코딩은 올바르게 처리되지 않습니다. 이 문제를 해결하기 위해, SetEncoding을
사용하는 대신 다음 예와 같은 코드를 사용합니다.
<cfscript>
function getMultipartFormParameter(key, encoding)
{
param = key.getBytes(encoding);
value = evaluate(toString(param, "ISO-8859-1"));
param = value.getBytes("ISO-8859-1");
return toString(param, encoding);
}
</cfscript>
|
44878 |
| SUN JRE 1.3.1을 영어(UK) 로케일에서 사용하는 경우, LSIsDate
함수는 한자리 달 또는 일자 (예:1/1/01)로 표기된 날짜에 대해 False를 반환합니다. 이 문제를
해결하기 위해, 한 자리 달 또는 일자에 0을 삽입합니다. (예: 01/01/01) |
38440 |
| ParseDateTime 함수는 일본 포맷 날짜를 ColdFusion MX에서
처리하지 않습니다. 일본 날짜를 사용하는 경우, LSParseDateTime 함수를
사용해야 합니다. |
34000 |
| ColdFusion MX는 링크에 이중 바이트 문자를 사용하는 것을 지원하지 않습니다. |
36913 |
| 이중 바이트 파일 이름을 갖는 파일을 포함하기 위해 cfinclude를 사용할
수 없습니다. |
36910 |
| 부적절한 마스크를 LSTimeFormat() 또는 LSDateFormat에
전달하는 경우 (예: "dd-mm-yymm"), 함수는 ColdFusion 5와 ColdFusion
MX에서 부적절한 문자를 출력합니다. 그러나 ColdFusion 5는 출력된 각 문자를 아포스트로피 (')
문자로 구분합니다. |
36388 |
| Encrypt와 Decrypt 함수는 이중 바이트 문자
세트와 함께 기능하지 않습니다. 이중 바이트 문자를 포함하는 문자열을 Encrypt
함수로 전달하고 차후 암호화된 값을 Decrypt 함수로 전달하는 경우, 문자열은
올바르게 해독되지 않습니다. |
38614 |
이진 파일을 읽어들이고 쓰는 경우, 다음 예에서와 같이 cffile의 action
속성에 ReadBinary를 지정한 후 새로운 파일을 생성해야 합니다.
<cffile action="ReadBinary" variable="x"
file="c:\input-binaryfile">
<cffile action="write" output="#x#"
file="c:\output-binaryfile">
Cp1252 파일 인코딩을 기본 값으로 사용하지 않는 컴퓨터에서 (예: 일본어와 기능하도록 설정된 컴퓨터),
이진 파일의 cffile 태그에 action="read"를
지정하는 것은 파일을 손상시킬 것입니다. |
39473 |
(Windows) 복수 바이트 문자 세트 운영 체제에서 Microsoft Access 드라이버 또는
ODBC Socket 드라이버를 사용하고 있는 경우, 다음을 실행해야 합니다.
- ColdFusion MX ODBC 서버와 ColdFusion MX ODBC Agent 서비스가
실행되고 있지 않은 경우, 이를 시작합니다.
- 명령어 프롬프트에 다음 명령어를 입력합니다.
cf_root\db\slserver52\admin\setcp.bat OS
- ColdFusion MX ODBC 서버와 ColdFusion MX ODBC Agent 서비스를
중단합니다.
- ColdFusion MX ODBC 서버와 ColdFusion MX ODBC Agent 서비스를
시작합니다.
다음은 setcp.bat 파일이 실행하는 작업입니다. 이 파일은 ColdFusion MX와 함께 라이센스된
ODBC 서버의 서비스 코드 페이지를 설정합니다. 이에는 하나의 매개변수가 필요합니다. 이 매개변수의 유효한
값은 OS와 Default입니다. 어떠한 매개변수 또는 유효한
값이 전달되지 않은 경우, 서비스 코드 페이지는 기본 상태로 되돌아 갑니다. 다시 말해, 한국어 또는 일본어와
같은 복수 바이트 문자 세트 운영체제에 어떠한 설정 ServiceCodePage OS도 사용되지 않습니다.
ServiceCodePage Default는 ASCII/EBCIDIC 자역만을 지원합니다. |
39730
39735 |
(Windows) 복수 바이트 운영체제에서, ColdFusion MX ODBC 서비스 (SequeLink)를
복수 바이트 코드 페이지 지원 모드로 변경할 수 있습니다. 이를 위해, 다음 명령어를 명령어 프롬프트로부터
실행합니다.
cf_root/db/slserver32/admin/setcp.bat
OS
다음의 샘플 명령어에서 처럼, setcp.bat을 매개변수 없이 또는 Default를 매개변수로 실행하여
기본 값으로 되돌아 갈 수 있습니다.
c:/cfusionmx/db/slserver32/admin/setcp.bat
Default
명령어를 실행할 때, ColdFusion MX ODBC Agent와 ColdFusion MX ODBC 서버
서비스를 반드시 실행하고 있어야 합니다. 명령어를 실행한 후, 변경사항을 적용하기 위해 두 서비스를 다시
시작해야 합니다. |
38855 |
| Verity는 UNIX (Solaris 또는 Linux)의 일본어 및 한국어판에서 지원되지 않습니다. |
37650 |
ColdFusion 5에서 ColdFusion MX로의 현지화 변경사항에 관한 정보를 위해, ColdFusion
5 응용프로그램 마이그레이션의 로케일절을 참조하십시오.
목차로 돌아가기
ColdFusion MX에서의 데이터 소스 구성
다음 테이블은 ColdFusion MX에서의 데이터 소스 구성에 관한 알려진 이슈를 기술합니다.
| 이슈 |
ID |
| ColdFusion MX의 이전 베타 릴리즈로 생성한 데이터 소스는 너무나 짧은 커넥션 시간 초과 값을
가지고 있기에 클라이언트 변수 저장으로 기능하지 못할 수 있습니다. 이를 클라이언트 변수 저장으로 지정하기에
앞서 이전 베타 버전으로 생성한 데이터 소스를 삭제하고 재 생성합니다. |
36167 |
| Microsoft Access를 클라이언트 저장으로 사용하는 경우, 클라이언트 변수의 누적 크기가 255
문자를 초과하면 에러가 발생합니다. |
45548 |
ColdFusion MX의 (OEM) JDBC Microsoft SQL Server 드라이버는 SQL
Server 6.5를 지원하지 않습니다. 이 드라이버를 사용하여 질의를 실행하면, 다음 에러가 반환됩니다.
SQL문 [ select 1 ]이 데이터베이스 질의 예외를 야기했습니다.
java.sql.SQLException: [Microsoft SQL Server] 로그인에 실패했습니다.
RAW_TRACE at coldfusion.tagext.lang.IncludeTag.doStartTag(Unknown
Source)
PROBLEM java.lang.NumberFormatException: at coldfusion.tagext.lang.IncludeTag.doStartTag(Unknown
Source) |
28436 |
| ColdFusion MX는 OS/390용 DB2 UDB를 지원하지 않습니다. |
45314 |
다음 라인을 (ColdFusion Administrator의 고급 설정에 있는) DB2 데이터 소스
이름 (DSN)용 connectstring에 추가해야 합니다.
CollectionID=default;packageName=<pkgname>;CreateDefaultPackage=false
여기서 pkname은 드라이버가 SQL문 프로세스에 사용하는 (최대 7문자 길이의) 패키지
이름입니다.
CollectionID 또는 packageName이 이미 존재하지 않는 경우, 첫번째 커넥션에 CreateDefaultPackage=true를
설정한 후, 데이터 소스를 수정하고 CreateDefaultPackage=false를
설정합니다. |
36798 |
DB2 및 Informix용 DataDirect JDBC 드라이버의 경우, ColdFusionMX가
커넥션이 시간 초과하기 전에 데이터베이스 커넥션을 분실하는 것을 막아주는 SetTransactionIsolation
메소드에 문제가 있습니다.
템플릿이 데이터베이스에 연결되어 있을 때 다음과 같은 에러 메시지가 반복적으로 디스플레이되는 경우, 데이터
소스용 커넥션 관리 옵션을 선택 해제합니다. 성능 저하의 이유로 이를 원치않는 경우, 데이터 소스의 시간
초과 설정을 기본 값인 20분에서 1-2분으로 낮출 수 있습니다. 이를 통해, 데이터베이스 서버 이벤트로
인해 데이터베이스 커넥션이 중단된 경우, ColdFusion MX 서버가 20분이 아닌 1-2분 내에 커넥션을
회복할 수 있습니다.
[Macromedia][Oracle JDBC Driver]피어로 커넥션 재 설정:
소켓 쓰기 에러
주의: 데이터베이스 서버로의 통신이 중단된 풀에서 모든 커넥션에 대해 이
메시지가 디스플레이될 것입니다. 그러나, DB2 및 Informix의 경우, 모든 커넥션이 시간 초과할
때까지 이 메시지가 계속하여 디스플레이됩니다. |
45290 |
| Sybase JDBC 커넥션은 Sybase 11.9 또는 이상에 기본 값으로 설치되지 않은 저장된 프로시저를
Sybase 서버에 필요로 합니다. ColdFusion MX는 디렉토리 <install dir>/db/sybase에
이 저장된 프로시저를 포함합니다. 데이터 소스를 생성할 때, "프로시저 'sp_default_charset'를
찾을 수 없습니다"라는 에러 메시지가 발생하면, 이 저장된 프로시저를 Sybase에 설치합니다. |
32230 |
CP437 문자 세트를 사용하도록 구성된 Sybase 서버는 연결에 실패할 수 있습니다. Sybase
서버에 연결을 시도하던 중 다음 에러 메시지가 발생하는 경우, \lib\macromedia_drivers.jar
파일을 업데이트해야 합니다.
[Macromedia][Sybase JDBC Driver]문자 세트 CP437을
macromedia.util.transliteration.properties에서 찾을 수 없습니다.
이 이슈에 관한 Technical Brief가 준비 중이며, 필수 변경사항을 설명할 것입니다. |
35691 |
(Windows NT 4.0, Windows 2000) ODBC 데이터 소스로 작업하려면, 최신 버전의
Microsoft Data Access Components (MDAC) 및 Jet를 실행합니다. 그렇치
않은 경우, 다음과 같은 에러가 발생할 수 있습니다.
데이터 소스 커넥션 확인에 실패: exampleapps [MERANT][SequeLink
JDBC 드라이버] [ODBC Socket][Microsoft][ODBC Microsoft Access
97 드라이버] 데이터베이스 '(알 수 없음)'을(를) 열 수 없습니다. 이는 응용프로그램이 인식하는
데이터베이스가 아니거나 파일이 손상되었을 수 있습니다. 근본 원인: 널
이를 다음으로부터 다운로드 받을 수 있습니다.
|
|
| Windows 98/ME에는 SequeLink 드라이버가 존재하지 않습니다. ODBC Socket 대신
JDBC-ODBC 브리지를 선택합니다. |
|
Windows 98과 Windows ME에서, Microsoft Access 데이터베이스에 cfinsert와
cfupdate를 사용할 수 없습니다. 대신 cfquery를
사용해야 합니다. 이 플랫폼에서 Access 데이터베이스에 사용되는 JDBC-ODBC 브리지 데이터베이스
드라이버는 최신 MDAC 2.7과 JetEngine 4.0 SP 3을 갖는 cfinsert
및cfupdate와 함께 기능하지 않습니다.
다음은 데이터 삽입 및 업데이트를 위해 cfquery를 사용하는 예제입니다.
<cfquery>
insert into tblEmp (employee_id, firstname, lastname,
department) values (#empid#,'#fname#','#lname#','#dept#')
</cfquery>
<cfquery>
update tblEmp
set firstname = '#fname#',
lastname = '#lname#'
where employee_id = #empid#
</cfquery>
|
45486 |
목차로 돌아가기
웹 서비스
다음 테이블은 ColdFusion MX에서의 웹 서비스 사용에 관한 알려진 이슈를 기술합니다.
| 이슈 |
ID |
| ColdFusion MX는 .NET 데이터세트 데이터 유형을 지원하지 않습니다. 데이터세트 인수를 기대하는
.NET 웹 서비스를 사용하는 CFML 템플릿을 가지고 있지 않은지 확인합니다. |
39621 |
| ColdFusion 컴포넌트 (CFC)가 가상 경로에 있을 때, CFC 인스턴스를 반환하는 CFC 웹
서비스를 사용하면, "클래스를 찾을 수 없습니다."라는 에러가 반환됩니다. 이 문제를
피하기 위해, 상대 경로가 아닌 절대 경로를 갖는 CFC를 참조합니다. |
45505 |
ColdFusion MX이외의 기술에서 구현된 웹 서비스를 사용하려면, 다음 웹 서비스 옵션을 설정해야
합니다.
- RPC를 SOAP 바인딩 유형으로, 인코딩을 encodingStyle로 사용합니다.
- 문서를 SOAP 바인딩 유형으로, 리터럴을 encodingStyle로 사용합니다.
다음의 예는 BabelFish 웹 서비스의 WSDL 파일 일부를 보여줍니다.
<binding name="BabelFishBinding" type="tns:BabelFishPortType">
<soap:binding style="rpc"
transport="http://schemas.xmlsoap.org/soap/http"/>
<operation name="BabelFish">
<soap:operation soapAction="urn:xmethodsBabelFish#BabelFish" />
<input>
<soap:body use="encoded" namespace="urn:xmethodsBabelFish"
encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" />
</input>
<output>
<soap:body use="encoded" namespace="urn:xmethodsBabelFish"
encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" />
</output>
</operation>
</binding>
BabelFish 웹 서비스의 WSDL 파일은 RPC를 바인딩 유형으로, 인코딩을 encodingStyle로
사용하기에 ColdFusion MX와 호환됩니다. |
|
| username과 password에 cfinvoke
태그 속성을 사용하여 보완된 웹 서비스를 호출할 수 없습니다. |
37005 |
| 밑줄 (_)과 같은 비 문자 숫자식 문자를 ColdFusion 컴포넌트 이름, 메소드 이름, 인수 이름에
사용하는 것을 삼가합니다. |
44924 |
ColdFusion MX는 웹 서버 가상 디렉토리의 파일에 액세스할 수 없습니다. 예를 들어, 웹 서버가
c:/myvirtual을 가리키는 가상 맵핑 /myvirtual을 갖는 경우, ColdFusion MX는
다음의 호출을 사용하여 c:/myvirtual/index.cfm을 포함할 수 없습니다.
<cfinclude template="/myvirtual/index.cfm">
컴포넌트 파일 c:/myvirtual/bank/account.cfc가 존재하는 경우, 파일에 웹 서비스
(http://myserver/myvirtual/bank/account.cfc?wsdl)로 직접 액세스하거나,
URL 컴포넌트 호출 (http://myserver/myvirtual/bank/account.cfc?method=deposit&amount=300)을
사용하여 액세스할 수 있습니다. 그러나, 다른 컴포넌트 또는 cfml 페이지가 이 컴포넌트 파일을 myvirtual.bank.account로
언급할 수 없습니다. 이는 또한 해당 컴포넌트가 웹 서비스로 호출되는 경우에도 적용됩니다.
기타 ColdFusion MX 리소스가 서버 가상 디렉토리 리소스에 내부적으로 액세스해야 하는 경우 이
디렉토리를 피하거나, 동일 이름 및 장소를 갖는 ColdFusion 맵핑을 웹 서버 맵핑으로 생성합니다. |
44546 |
목차로 돌아가기
ColdFusion Administrator
다음 테이블은 ColdFusion Administrator의 알려진 이슈를 기술합니다.
| 이슈 |
ID |
| Administrator는 올바른 기능을 위해 기본 설치 경로 (.../CFIDE/administrator/)에
상주해야 합니다. |
|
| 기본 웹 브라우저가 팝업 창을 비활성화한 경우, ColdFusion Administrator는 설치
후 첫번째 시도시 실행되지 않을 수 있습니다. 이 문제를 해결하기 위해, 브라우저에서 팝업 창을 활성화하고
ColdFusion Administrator를 실행합니다. ColdFusion Administrator를
처음 실행한 후, 브라우저에서 팝업 창을 다시 비활성화할 수 있습니다. |
45481 |
(Windows 용) 데이터 소스가 사용자 인증을 요구하지 않더라도, Microsoft Access
및 ODBC Socket 데이터 소스 이름 (DSNs)을 위해 사용자 이름을 제공해야 합니다. 다음과 같이
사용자 이름을 제공합니다.
- DSN 액세스 기본 사용자 이름 사용 옵션을 선택하거나, 고급
설정을 열어 ColdFusion 사용자 이름 필드에 사용자 이름을 입력합니다.
- ODBC Socket DSN 신뢰할 수 있는 커넥션 사용 옵션을
선택하거나, 고급 설정을 열어 사용자 이름 필드에 기본 사용자 이름 (시스템)을 사용하거나 사용자
이름을 입력합니다.
|
45484 |
| 시스템 검사 페이지에서 URL, 사용자 이름, 또는 probe.cfm의 암호를 변경하는 경우, 검사를
편집하고 제출을 클릭하여 각 기존 검사에 대한 업데이트를 실행해야 합니다. |
39738 |
아카이브 또는 배포가 불가능한 것은 다음과 같습니다. 시스템 검사, CORBA 커넥터, 웹 서비스,
다음 설정: 서버 설정 >설정> 동시 요청; 서버 설정 > 기본 보안 > 보안 샌드박스
- ColdFusion 보안 확인란 활성화; 서버 설정 > 디버깅> 강력한 예외 정보 활성화,
성능 모니터링 활성화, CFSTAT 활성화 이는 향후 버전에서 수정될 것입니다.
서버 설정 > 기본 보안 > CF Admin 암호 및 RDS 암호를 배포할 수 없습니다. 이는 의도한
비헤비어입니다. |
|
명명된 리소스 (예: 데이터 소스, 검사, Verity 콜렉션 등)에 작은 따옴표 (')를 사용할 수
없습니다. 작은 따옴표를 사용하면 --예를 들어, name="Let's Rock"으로
예약된 작업을 생성하는 경우-- 서버가 다시 시작할 때 WDDX 파싱 에러가 발생하고, 데이터에 작은 따옴표가
포함된 서비스는 실패합니다.
이를 해결하기 위해, 실패한 서비스의 XML 백업 파일을 만들고 편집합니다. 예를 들어, Cron 서비스가
예약된 작업을 "Let's Rock"으로 명명한 후 실패하는 경우, cf_root\lib\neo-cron.xml의
백업 파일을 만들고 파일의 원본 버전을 편집하여 "Let's Rock"의 모든 인스턴스를
"Lets Rock"으로 변경합니다. |
45409 |
| 현재, CORBA 커넥터를 등록하거나 편집하는 경우, 클래스 경로 필드는 사용되지 않습니다. 대신 Java
및 JVM 페이지에 CORBA (및 기타) 클래스 경로를 지정합니다. |
|
Verity 콜렉션 페이지에서 등록하지 않은 콜렉션을 맵핑하는 경우, 콜렉션 생성에 사용한 동일 언어를
선택합니다. 현재, 콜렉션으로 맵핑할 다른 언어를 선택하는 경우, 에러가 나타나지 않습니다. 그러나, 생성한
언어가 아닌 다른 언어로 콜렉션을 맵핑하거나 색인하는 경우, 콜렉션 색인 및 검색 역량을 저해할 수 있습니다.
등록하지 않은 콜렉션 예는 다음과 같습니다.
- 다른 서버의 콜렉션
- mkvdk로 생성한 콜렉션
주의: ColdFusion 5.0으로부터 마이그레이트한 콜렉션은 이 문제를
가지고 있지 않습니다. |
|
목차로 돌아가기
ColdFusion MX에서의 그래프 생성
다음 테이블은 ColdFusion MX에서의 그래프 생성에 관한 알려진 이슈를 기술합니다.
| 이슈 |
ID |
| cfgraph와 cfchart 태그에서, ColdFusion
MX는 scaleFrom과 scaleTo 속성의 값만을 시작
점으로 사용합니다. ColdFusion MX는 실제 데이터 값과 디스플레이해야할 라벨 수를 고려한 후,
실제 scaleFrom과 scaleTo 값을 결정합니다.
예를 들어, ColdFusion MX는 사용자 지정 scaleFrom과 scaleTo 값을 조정하여 십진
라벨과 데이터를 배제하는 것을 피합니다. |
32837 |
| 파이 도표의 범례가 긴 라벨을 포함하는 경우, 파이 도표는 일그러진 모양으로 나타날 수도 있습니다.
이 문제를 해결하기 위해, graphwidth 또는 chartwidth
속성 값을 설정 또는 증가하여 폭을 늘립니다. |
32835 |
| cffile 태그는 파일에 쓸때 다른 기본 인코딩을 사용하도록 변경되었습니다.
따라서, cfchart의 name 속성을 사용하여 생성된
그래프를 파일에 쓰려면, 다음 속성을 cffile 태그에 추가해야 합니다. charset="ISO-8859-1". |
38867 |
목차로 돌아가기
Verity 검색
다음 테이블은 ColdFusion MX에서의 Verity 검색에 관한 알려진 이슈를 기술합니다.
영어 이외의 언어로된 Verity 콜렉션을 가지고 있으며 이를 ColdFusion MX로 마이그레이트해야
하는 경우, 다음을 실행합니다.
- ColdFusion MX 설치.
설치 종료 무렵에 마이그레이션 "스킵" 옵션을 선택합니다.
- Verity 언어 로케일 파일을 www.macromedia.com/go/verity_ko로부터
다운로드한 후 Verity 언어 로케일 파일을 설치합니다.
자세한 설명은 "Macromedia ColdFusion MX 설치"를 참조하십시오.
- Macromedia ColdFusion MX 설치에 기술된 것 처럼 마이그레이션
옵션을 다시 활성화한 후, 설정을 ColdFusion 이전 설정으로부터 마이그레이트합니다.
|
46057 |
HP-UX에서, 속성이 type="custom"인 cfindex
태그를 사용할 수 없습니다. (이 속성은 데이터베이스 질의 결과, QueryNew 객체 질의 결과, CFLDAP
질의 결과, CFPOP 질의 결과의 콜렉션을 색인하는데 사용됩니다.)
cfindex
태그의 다음 속성은 사용할 수 있습니다.
- 파일 이름을 갖는 완벽히 한정된 경로 콜렉션을 색인하기 위한 type="file"
- 완벽히 한정된 경로 콜렉션을 색인하기 위한 type="path"
|
45663 |
| (Windows) 콜렉션의 결합된 경로 및 콜렉션 이름이 91자를 초과하는 경우 콜렉션을 색인할 수
없습니다. |
45654 |
| 한글 Windows XP에서는 한글을 포함한 모든 더블 바이트 언어를 지원하는 Verity ICU 언어
팩을 이용하여 생성된 컬렉션을 인덱스 할 수 없습니다. |
46432 |
| Verity는 Linux에서 VSpider를 지원하지 않습니다. 또한 Linux는 PDF 파일을 지원하지
않음에 유의하십시오. |
|
Verity 콜렉션을 생성하거나 Verity 콜렉션을 마이그레이트하는 경우, 다음 에러 메시지를 받을
수 있습니다.
에러: 검색 엔진 원시 라이브러리에서 연산을 실행하는 중 에러가 발생했습니다. coldfusion.tagext.lang.CFCollectionTagException:
에러 # -10.
이 문제를 해결하기 위해, 파일 [installdrive]:/winnt/system32/VDK200.DLL을
찾아 이름을 VDK200.dll_old로 변경합니다. ColdFusion 서버를 다시 시작합니다. 이는
이전 버전의 ColdFusion과 충돌하는 파일입니다. |
38917 |
목차로 돌아가기
기타 알려진 이슈
다음 테이블은 이번 ColdFusion MX 릴리즈의 일반적으로 알려진 이슈를 기술합니다.
| 제품 영역 |
이슈 |
ID |
| 메모리 사용 |
ColdFusion MX 실행에는 ColdFusion 5보다 더 많은 메모리가 필요합니다.
보다 자세한 정보를 위해 ColdFusion MX 설치에 기술된 시스템 요구사항을 참조하십시오. |
35820 |
| ColdFusion 컴포넌트 (CFCs) |
이번 릴리즈의 경우, 한 컴포넌트 내에서 <cfset x = 1>은
컴포넌트에 로컬인 변수 범위에 x를 포함하고, <cfset variables.x = 1>은
호출하는 페이지의 변수 범위에 x를 포함합니다.
일단 이 버그를 수정하면, <cfset x = 1>과 <cfset
variables.x = 1>은 정확히 동일한 역할을 수행하고, 컴포넌트에 로컬인 변수
범위에 x를 포함합니다.
이 버그를 수정할 때까지, <cfset variables.x = 1>은
호출하는 페이지에서 <cfset x = n>과 충돌할 것이기에, 이의
사용을 피합니다. |
45387 |
컴포넌트를 사용하는 경우, 또는 Java 대-소문자 구별 컨테이너 (예:
Hashtable)와 상호호환하는 경우, 점 표기법은 키를 참조하는데 실패합니다. 예를 들어, 다음 코드
샘플에서 처럼 (newTC.foo.moo)가 존재하더라고 이를 찾을 수 없을 수
있습니다.
<cfset newTC = createObject( "component", testComponent ) />
<cfset foo = newTC.foo.moo />
이 문제를 해결하기 위해, 대괄호 표기법 (예: (newTC["foo"]["moo"]))을
사용합니다. |
45461 |
| 배열 초기화 |
a[1]["moo"][1]과 같은 (여기서 a는
정의되지 않았음) 이질 배열 initializer는 예외를 반환합니다. 이 문제를 해결하기 위해, 다음
예에서와 같이 이질 파트를 개별 지정문에 지정합니다.
<cfset a1[1] = structNew()>
<cfset a1[1]["moo"][1] = 12>
|
31535 |
| 게시 양식에 관한 서버측 확인 |
게시 양식 (예: input type="hidden" name="myInput_require")을
검증하기 위해 ColdFusion 서버측 확인을 사용하는 경우, ColdFusion MX는 값 필드에 입력한
사용자 정의 메시지를 무시하고 대신 필수 필드임을 나타내는 메시지를 디스플레이합니다. |
45443 |
| 서버측 방향 지정 |
서버측 방향 지정을 위해 getpageContext().forward('<your page
name>.cfm')을 사용하고 양식 범위에 데이터가 존재하는 경우, "err.io.short_read"
에러가 반환됩니다. |
45337 |
| 파일 서버 브라우저 애플릿 |
파일 서버 브라우저 애플릿 (allaire.cfide.CFNavigationApplet)은 Netscape
4.x에서 아이콘을 적절히 표시하지 않습니다. |
31958 |
| 사용자 정의 함수 (UDFs) |
UDF의 정의된 인수가 N개이나, N+1을 전달하고 그 인수를 갖는 structKeyList를
호출하는 경우, 에러가 발생합니다. 선언되지 않은 인수를 갖는 함수내에 cfdump가
존재하는 경우, 동일 에러가 발생합니다. |
44635 |
| cfhttp |
cfhttp는 기본 Java Runtime Environment (JRE) 성능의
영향을 받는 일부 비헤비어를 가지고 있습니다. 예를 들어, IBM JRE를 사용하는 경우, cfhttp는
"https" URL에 올바르게 연결되지 않지만, SUN JRE를 사용하는 경우, 올바르게
연결됩니다. 그러나 SUN JRE를 사용하는 경우, cfhttp는 URL에 대한
http 요청이 존재하지 않는 페이지를 포함하는 경우, 404 상태 코드 페이지를 항상 반환하지 않는 반면,
IBM JRE를 사용하는 경우, 반환합니다.
마지막으로, timeout 속성은 SUN JDK 버전 1.3 및 1.3.1_03과
함께 기능하지 않습니다. 시간 초과 속성 기능을 사용하려면, JDK 1.4.0을 사용해야 합니다. |
37683
37684
30267 |
| cfimport |
cfimport를 사용하여 사용자 정의 태그를 가져오는 경우, 네임 스페이스
CF를 사용할 수 없습니다. 이는 CF가 ColdFusion 사용자 정의 태그로 예약되어 있기 때문입니다. |
45544 |
| cfldap |
ColdFusion MX에서, cfldap는 ColdFusion 5에서 처럼
SSL v3 클라이언트 인증 (증명서 인증)을 지원하지 않습니다. ColdFusion MX에서, cfldap는
SSL v2만을 지원합니다. (SSL상에서의 기본 사용자 이름/암호 인증) |
38693 |
| cfldap를 사용하여 LDAP 서버를 업데이트 또는
수정하는 것은 서버가 HP-UX 11을 기다리게할 수 있습니다. 이는 알려진 JNDI 이슈입니다. 이 문제를
해결하기 위해, ColdFusion Administrator의 Java & JVM 페이지에 -XdoCloseWithReadPending
JVM 인수를 추가합니다. |
45384 |
ExpandPath()
GetRealPath() |
ExpandPath() 또는 GetRealPath()를
ColdFusion MX 웹 루트와 외부 웹 서버 웹 루트에 모두 존재하는 디렉토리에 사용하고 외부 웹
서버를 사용하는 경우, 함수는 ColdFusion MX 웹 루트의 디렉토리를 반환합니다. 예를 들어, C:\CFusionMX\wwwroot\foo
및 C:\inetpub\wwwroot\foo가 존재하고 ColdFusion MX용 IIS를 구성한 경우,
ExpandPath("foo")는 C:\CFusionMX\wwwroot\foo를
반환합니다. |
|
| CORBA 호출 |
CORBA (Visibroker 4.5)를 사용하는 경우, 구조 배열 또는 다중 차원 배열을 위한 "out"
호출은 CORBA_UNKNOWN 예외를 반환합니다. 대신 "inout"을 사용합니다.
이는 Visibroker 버그입니다. |
|
| CORBA IOR 메소드를 CreateObject/cfobject에서
사용하는 경우, 배포 환경과 동일한 환경에서 얻은 IOR를 사용해야 합니다. Visibroker IOR의
상호 교체 사용은 불가능합니다. 즉, CORBA 서버를 다른 컴퓨터에서 배포하는 경우, 새로운 IORs을
확보해야 합니다. Visibroker IORs는 IP 주소 정보를 포함합니다. |
36866 |
| ColdFusion Administrator 보안 설정 |
샌드박스 보안용 서버 IP주소 (서버/포트 아래)를 입력한 후 포트 번호를 기억하지 못하는 경우, 이
엔트리의 편집을 시도하면 에러 메시지를 받게됩니다. 이 문제를 해결하기 위해, 해당 서버 IP 주소를 삭제하고
포트 번호와 함께 주소를 다시 입력합니다. |
39860 |
| UNIX에서의 샘플 응용프로그램 |
Unix에서, 보안이 활성화된 경우 (Enterprise판의 샌드박스 보안, Professinal판의
리소스 보안), Pointbase 데이터베이스를 사용하는 샘플 응용프로그램을 사용할 수 없습니다. Pointbase
샘플 데이터 소스를 사용하려면, Unix에서 보안을 비활성화해야 합니다. |
45527 |
목차로 돌아가기
|
