PowerBuilder 2017 설치 가이드

2

목차

1. 설치 가이드 ......................................................................................................................................................................................................... 4

2. 설치 순서 .............................................................................................................................................................................................................. 4

3. 설치 계획 .............................................................................................................................................................................................................. 4

3.1 설치 패키지 내용 .................................................................................................................................................................................. 4

3.2 시스템 요구사항 .................................................................................................................................................................................... 4

3.3 소프트웨어 요구사항 ........................................................................................................................................................................... 5

4. 사전 설치 작업 .................................................................................................................................................................................................. 6

5. Common Setup Program 설치 ................................................................................................................................................................. 7

6. 기본 정보 제공 .................................................................................................................................................................................................. 7

7. PowerBuilder 설치 ....................................................................................................................................................................................... 10

7.1 PowerBuilder 구성요소 .................................................................................................................................................................. 11

8. 설치 프로그램 완료 ...................................................................................................................................................................................... 12

8.1 설치 프로그램의 기능 ..................................................................................................................................................................... 12

8.1.1 모든 사용자에게 공유 가능한 Write 권한이 있는 파일 .................................................................................. 13

8.1.2 각각의 사용자를 위한 파일 ............................................................................................................................................. 13

8.1.3 Registry 변경 .......................................................................................................................................................................... 13

9. Silent(Unattended) Mode 설치 ............................................................................................................................................................. 14

10. 설치 이후 작업............................................................................................................................................................................................. 16

10.1 JDBC를 위한 jConnect용 데이터베이스 업그레이드 .................................................................................................... 16

10.2 Ghostscript 설치 ............................................................................................................................................................................. 16

10.3 PostScript 드라이버 설치 ........................................................................................................................................................... 16

11. PowerBuilder 활성화 ................................................................................................................................................................................ 18

11.1 온라인 활성화 ................................................................................................................................................................................... 18

11.1.1 온라인 라이선스 활성화 ................................................................................................................................................. 19

11.1.2 온라인 라이선스 새롭게 반영 ..................................................................................................................................... 19

11.1.3 로그 아웃 하여 비활성화 ............................................................................................................................................... 19

3

11.2 오프라인 라이선스 활성화 ......................................................................................................................................................... 20

11.2.1 오프라인 라이선스 활성화 ............................................................................................................................................ 21

11.2.2 오프라인 라이선스 갱신 ................................................................................................................................................. 23

11.2.3 오프라인 라이선스 업그레이드 ................................................................................................................................... 24

11.2.4 오프라인 라이선스 비활성화 ........................................................................................................................................ 25

12. PowerBuilder Uninstall ........................................................................................................................................................................... 26

4

1. 설치 가이드

이 문서는 Appeon PowerBuilder 설치 가이드 입니다. PowerBuilder를 설치하기 전에 이

가이드 문서를 먼저 확인 하십시오.

2. 설치 순서

이 목차는 PowerBuilder® 설치 순서입니다.

제품 설치

1) Chapter 3, 설치 계획

2) Chapter 4, 사전 설치 작업

3) 다음 설치 방법 중 하나 선택

Chapter 5, Common Setup Program 설치

Chapter 9, Silent(Unattended) Mode 설치

4) Chapter 10, 설치 이후 작업

설치 제거

Chapter 12, PowerBuilder Uninstall

3. 설치 계획

설치 또는 업그레이드 하기 전에 설치 환경을 준비합니다.

설치 또는 업그레이드 할 구성 요소와 옵션 확인

시스템이 설치 요구 사항을 충족하는지 확인

라이선스 확보

필요한 소프트웨어 확인

3.1 설치 패키지 내용

PowerBuilder x86 32-bit 설치 패키지에는 PowerBuilder 2017 Common Setup Program 외에도 Web

Services 클라이언트 및 기타 지원을 위한 추가적인 폴더가 포함되어 있습니다.

3.2 시스템 요구사항

PowerBuilder를 설치하기 전에 시스템이 모든 요구 사항을 충족하는지 확인합니다. 필요한 서비스 팩에

대한 최신 정보는 릴리즈 게시판을 참고하십시오.

5

표 3.1: PowerBuilder 시스템 요구사항

제품 컴퓨터 최소 메모리 HDD 용량 OS

PowerBuilder의 시스템 요구사항은 다음과 같습니다. 제공된 디스크 공간 요구사항은 대략적인

것으로, 각 제품에 필요한 실제 디스크 공간은 하드디스크 크기, 파티션 및 선택한 설치 항목에 따라

다를 수 있습니다. 설치 파일의 압축을 풀기 위해 설치하는 동안 추가적인 공간을 필요로 합니다.

PowerBuilder Intel Core i3

or higher

1GB 2GB Windows 7 32 or 64 bit with SP1

Windows 8.1

Windows 10 32 or 64 bit

Windows Server 2008 32 or 64 bit with

SP2 Windows Server 2012 R2,

Windows Server 2016

Product

3.3 소프트웨어 요구사항

PowerBuilder 소프트웨어 요구사항을 확인합니다.

표 3.2: PowerBuilder 기능에 필요한 소프트웨어

기능 필요한 소프트웨어

다음은 PowerBuilder 기능에 필요한 소프트웨어 목록 입니다. PowerBuilder를 설치하기 전에 필요한

모든 프레임워크 패키지와 SDK를 설치 하십시오. Microsoft 개발자 소프트웨어는 Microsoft 다운로드

센터에서 다운로드 할 수 있습니다. 아래의 표를 참고하여 필요한 소프트웨어 설치 여부를 확인

하십시오. 만일 필요한 소프트웨어가 설치 되어 있지 않은 경우에는 설치 프로그램에서 경고

메시지를 띄웁니다.

.NET Web services

local host deployment

Microsoft Internet Information Services (IIS) 5.0 또는 그 이상 버전

Note

PowerBuilder 어플리케이션이나 컴포넌트가 스마트 클라이언트

어플리케이션 서버로 사용 되는 컴퓨터가 아니라면 개발자 컴퓨터에는

IIS가 필요하지 않습니다. 또한 사용자 컴퓨터에도 필요하지 않습니다.

IIS 설정에 대한 더 자세한 내용은 도움말 Deploying Components as .NET

Assemblies or Web Services를 참고하십시오.

PowerBuilder tutorial,

demo database,

sample applications

SQL Anywhere 12 부터 17

SQL Anywhere는 SAP 웹 사이트에서 다운로드 할 수 있습니다. 만일 SQL

Anywhere 12, 16 또는 17이 컴퓨터에 설치되어 있지 않다면 경고 메시지를

띄웁니다.

‘Continue’를 선택하면, Tutorial이나 Demo DB는 설치되지 않습니다. 이

기능을 추후에 다시 사용하기 위해서는 SQL Anywhere를 먼저 설치한 후

PowerBuilder를 재설치 하십시오.

MobiLink™

synchronization

Adaptive Server® Anywhere 9.0.2 부터 SQL Anywhere 16

Mobile Link는 Adaptive Server Anywhere 및 SQL Anywhere의 구성요소입니다.

6

SQL Anywhere 설치 시 Synchronization 또는 Messaging을 선택한 후

MobiLink를 선택합니다.

EJB client

development

IBM WebSphere 6.x. 또는 BEA WebLogic 8.1과 그 이상 버전의 J2EE

어플리케이션 서버

오라클 JDK는 PowerBuilder 설치 시 아래의 경로에 설치 됩니다.

Appeon\Shared\PowerBuilder\Jdk1.6.0_24

Web service clients

and Web Service

DataWindow in

PowerBuilder

Microsoft .NET Framework 4.0 또는 상위 버전

Saving DataWindows

as PDF using the

Ghostscript distiller

and PostScript

printing

Ghostscript and PostScript printer driver

10.2 “Ghostscript 설치” 와 10.3 “PostScript 드라이버 설치”를

참고하십시오.

Saving DataWindows

as PDF using XSL

Formatting Objects

(FO) and Java printing

Oracle JDK와 Apache FO processor

오라클 JDK는 PowerBuilder 설치 시 아래의 경로에 설치됩니다.

Appeon\Shared\PowerBuilder\Jdk1.6.0_24

Apache FO processor는 PowerBuilder 설치 시 아래의 경로에 설치됩니다.

Appeon\Shared\PowerBuilder\fop-0.20.5

Data access using the

ADO.NET interface

Microsoft .NET Framework Version 4.0 Redistributable Package

JDBC connectivity Oracle JDK

오라클 JDK는 PowerBuilder 설치 시 아래의 경로에 설치됩니다.

Appeon\Shared\PowerBuilder\Jdk1.6.0_24

Runtime Packager Microsoft Windows Installer

Microsoft Windows Installer는 모든 Windows 플랫폼에 기본으로 설치됩니다.

4. 사전 설치 작업

설치 전에 아래의 항목들을 확인 합니다.

설치하려는 제품에 대한 최신 정보는 릴리즈 게시판을 참고합니다. 특히 Special Installation

Instructions 섹션을 주의 깊게 보십시오. Appeon 웹 사이트의 릴리즈 게시판은 다음과 같습니다.

https://www.appeon.com/support/documents/appeon_online_help/pb2017/release_bulletin_for_pb

(PowerBuilder 관련)

https://www.appeon.com/support/documents/appeon_online_help/pb2017/release_bulletin_for_im/

(InfoMaker 관련)

PowerBuilder를 설치 한 드라이브가 압축되어 있지 않은지 확인합니다. 설치하려는 드라이브가

압축된 경우 설치 오류가 납니다.

최소 300MB 이상의 여유 공간이 있는지 확인합니다. 설치프로그램은 그 여유공간에 파일을 쓰고

7

설치 후 삭제합니다.

실행중인 어플리케이션은 모두 종료합니다.

이전 버전의 파일들은 모두 백업합니다. 모든 PBL은 현재 버전에서 오류가 없도록 Regenerate를

수행합니다. PBL 뿐만 아니라 Database 파일, INI 파일 등 필요한 정보들은 모두 백업합니다. 기존

어플리케이션의 백업과 마이그레이션에 관한 더 많은 정보는 10. “설치 이후 작업”을 참고하십시오.

PowerBuilder 2017 설치 전에 어떤 소프트웨어 설치가 필요한지는 3.3 “소프트웨어 요구사항”을

참고하십시오.

5. Common Setup Program 설치

이 과정은 다운로드 된 설치 파일로 로컬에 설치하는 내용입니다. 만일 여러 사용자가

PowerBuilder를 설치하기 원한다면 시스템 관리자는 네트워크 드라이브에 설치 파일을

복사하여 네트워크를 통해 설치 가능하도록 합니다.

다음 단계에 따라 PowerBuilder 설치를 진행합니다.

1) 실행 중인 프로그램들 종료

2) PowerBuilder 설치 프로그램 실행.

Appeon 웹 사이트에서 다운로드 한 설치 파일로 설치하는 경우 Autorun.exe 실행

네트워크 드라이브를 이용한 설치는 회사 시스템 관리자 지시에 따라 접근 및 설치

3) 설치 프로그램을 실행하여 Install 버튼 클릭

6. 기본 정보 제공

PowerBuilder 설치 전에 Common Setup Wizard는 기본 정보를 수집합니다.

Note

다음 진행 절차 중 어느 시점에서든 Cancel 버튼을 클릭하여 설치를 중단을 할 수 있습니다. Exit 버튼을

클릭하면 현재 설치중인 작업만 중단하고 다음 선택 사항을 계속해서 진행 하거나 설치 프로그램을 완전히

종료할 수 있습니다.

PowerBuilder를 설치하게 전에 다음과 같은 기본 정보를 제공합니다.

1) 설치 프로그램의 시작 페이지에서 Install 버튼을 클릭합니다.

8

2) Welcome 페이지에서 Next 버튼을 클릭합니다.

PowerBuilder 2017 설치에 필요한 프로그램들이 설치되어 있지 않은 경우 다음 페이지에서 설치를

요하는 프로그램 항목을 알려줍니다. Cancel 버튼을 클릭하면 마법사가 종료되고, Next 버튼을

클릭하면 필요한 프로그램을 제외하고 설치를 계속 진행할 수 있습니다.

3) License Agreement 페이지에서 동의서 내용을 확인하고 I accept the terms of the license agreement

항목을 선택 한 뒤 Next 버튼을 클릭합니다.

9

4) Customer Information 페이지에서 사용자 이름과 회사명을 입력합니다.

5) Choose Destination Location 페이지에서 Next 버튼을 클릭하면 표시된 경로에 설치 되며, 만일 설치

경로를 변경하고 싶다면 Browse 버튼을 클릭하여 경로 수정 후 Next 버튼을 클릭합니다.

6) Choose Destination Location For Shared Files 페이지에서 Next 버튼을 클릭하면 표시된 경로에 설치

되며, 만일 설치 경로를 변경하고 싶다면 Browse 버튼을 클릭하여 경로 수정 후 Next 버튼을

클릭합니다.

10

7) Specify the SQL Anywhere Engine 페이지에서 PowerBuilder Demo DB를 실행할 SQL Anywhere 엔진을

선택하고 Next 버튼을 클릭합니다.

8) Select Products 페이지에서 PowerBuilder를 선택하고 Next 버튼을 클릭합니다.

만일 PowerBuilder Universal Edition을 설치할 경우, PowerServer 제품도 선택할 수 있습니다.

PowerServer 설치에 관한 자세한 사항은 PowerServer 도움말을 참고하십시오.

7. PowerBuilder 설치

필수 조건

설치를 위해서는 반드시 관리자 권한이 필요합니다. 마우스 오른쪽 버튼을 클릭하여 관리자권한으로

실행합니다.

순서

1) Select Products 페이지에서 PowerBuilder를 선택한 후 Next 버튼을 클릭합니다.

2) Select Components 페이지에서 불필요한 구성요소는 선택 해제하고 Next 버튼을 클릭합니다.

PowerBuilder Base Components 항목은 선택 해제 할 수 없습니다.

PowerBuilder Tutorial 선택 시 Demo Database는 기본적으로 선택 됩니다.

11

3) Select Program Folder 페이지에서 시작 프로그램에 표시될 폴더를 선택합니다. 기존에 폴더를

선택하여 추가 하거나 새롭게 폴더를 생성할 수 있습니다. 폴더 설정 후 Next 버튼을

클릭합니다.

4) Start Copying Files 페이지에서 설정 정보 확인 후 Next 버튼을 클릭하여 설치를 진행 하거나

Back 버튼을 클릭하여 선택 사항을 변경합니다.

5) InstallShield Wizard Complete 페이지에서 Finish 버튼을 클릭하면 Common Setup Program으로

돌아갑니다.

설치 후 사용자는 시스템 사용자 폴더 및 Windows Registry의 HKEY_CURRENT_USER에 대한

Write 권한을 가지고 있는지 확인합니다.

7.1 PowerBuilder 구성요소

설치 프로그램에서 PowerBuilder 구성요소를 선택할 수 있습니다.

표 7.1: 구성요소

구성요소 설명

PowerBuilder Base

Components

ODBC driver, ORCA Software Development Kit (SDK), PowerBuilder Document

Object Model extension, DataWindow를 distill 또는 XSL-FO를 이용한 PDF

저장 기능, Rich Text 지원 기능, Oracle JDK 등이 설치 됩니다.

이 항목은 반드시 설치 되어야 하는 기본 구성요소로 옵션 선택 해제가

불가능 합니다.

Native Database

Interfaces

데이터베이스 서버와의 통신을 위한 인터페이스로 Tree View를 확장하여

설치를 위한 인터페이스를 선택합니다.

ADO.NET Driver ADO.NET data provider를 사용하여 데이터베이스를 연결하기 위한

인터페이스 입니다.

OLE DB Driver OLE DB data provider를 사용하여 데이터베이스를 연결하기 위한

인터페이스 입니다.

JDBC Driver JDBC를 사용하여 데이터베이스에 연결하기 위한 인터페이스 입니다.

SCC Interface Microsoft SCC 인터페이스를 지원하는 모든 소스 코드 컨트롤 시스템에

연결하기 위한 인터페이스 입니다.

PB Native Interface C++에서 PowerBuilder 확장 기능을 개발하기 위한 SDK 입니다. SDK

Optional Wizard는 Visual Studio 2005와 Visual Studio .NET 2002, 2003에

설치 됩니다.

EJB Client EJB Client PBNI 확장 기능으로 J2EE 기반 서버에서 실행되는 EJB

클라이언트를 개발할 수 있습니다.

Web Services .NET 또는 EasySoap 웹 서비스 엔진을 사용하여 Web services를 위한

클라이언트를 개발 할 수 있는 확장 기능 입니다.

Tutorial Getting Started 튜토리얼 소스 파일입니다. PowerBuilder 튜토리얼 이나 예제

프로그램을 사용하려면 SQL Anywhere가 설치되어 있어야 합니다.

PowerBuilder 설치 시 Demo Database의 ODBC Data Source가 생성 되며,

12

SQL Anywhere가 설치 되어 있지 않다면 Demo Database, 예제 프로그램,

튜토리얼 파일이 설치되지 않습니다.

Demo Database 튜토리얼, 예제 프로그램, 문서의 샘플들이 사용하는 AQL Anywhere

Database 입니다

Code Examples 많은 코딩 기법을 보여주는 예제 프로그램입니다.

Translation Toolkit 어플리케이션을 다른 언어로 변환할 수 있도록 도와주는 툴입니다.

PowerBuilder

Resource Monitor

OS에서 USER/GDI 등 충분한 리소스가 있는지 결정을 돕기 위한 유틸리티

입니다.

PowerBuilder

Runtime Packager

소스 배포 시 필요한 파일들을 MSI 파일로 패키지 해주는 툴입니다.

Help Files PowerBuilder 도움말 입니다.

8. 설치 프로그램 완료

설치 시 선택된 모든 제품을 설치하면 Common Setup Program으로 돌아갑니다.

Common Setup Program을 완료 하려면 다음과 같이 합니다.

1) InstallShield Wizard Complete 페이지에서 Finish 버튼을 클릭하여 설치를 완료합니다.

만일 이 페이지에서 체크박스 선택을 해제 하지 않는다면 Readme 파일을 보여줍니다.

2) System Reboot Required 페이지에서 컴퓨터 재부팅 여부를 선택 한 후 Finish 버튼을 클릭합니다.

PowerBuilder 설치 후 사용하기 위해서는 반드시 컴퓨터를 재부팅 해야 합니다.

PowerBuilder 로그 파일은 %Windows% \System32\AppeonInstallLog 폴더에 PBLog_2017.txt

라는 이름으로 생성 됩니다.

8.1 설치 프로그램의 기능

설치 프로그램은 파일을 설치하고 Windows Registry를 업데이트 합니다.

설치 프로그램 기능

Appeon 폴더에 Appeon 파일을 설치합니다.

모든 사용자가 공유 가능한 폴더에 Write 권한이 있는 Appeon 파일을 설치합니다.

Windows System 폴더에 시스템 파일을 설치합니다.

설치된 각 제품에 대한 시작 프로그램 그룹 및 아이콘을 생성합니다.

제품 삭제를 위한 Uninstall 파일을 생성합니다.

Windows Registry를 변경합니다.

PowerBuilder를 위한 PB.INI 파일을 생성하고 업데이트 합니다.

13

8.1.1 모든 사용자에게 공유 가능한 Write 권한이 있는 파일

Federal Desktop Core Configuration (FDCC) Compliance Configuration의 일부분으로

PowerBuilder는 모든 사용자에게 공유 가능한 Write 권한의 파일을 아래의 경로에 설치합니다.

C:\Users\Public\Documents\Appeon\PowerBuilder 17.0.

공유되는 파일은 다음을 포함합니다.

PowerBuilder Demo Database (pbdemo2017.db 와 pbdemo2017u.db)

모든 예제 프로그램의 폴더 및 파일

HTML로 만들어진 PowerBuilder 도움말 파일

Translation Toolkit 폴더 및 파일

8.1.2 각각의 사용자를 위한 파일

Write 권한을 갖는 다른 파일들은 Program Files\Appeon 하위 폴더에 설치 되지만 사용자들이

PowerBuilder를 처음 실행할 때마다 다른 위치로 복사됩니다. 이러한 방법으로 각각의

사용자들은 이 파일들에 대한 개인적인 복사본을 갖게 됩니다.

다음 표에서는 사용자 폴더에 복사되고 업데이트 되는 파일들의 목록을 설명해 줍니다. 표의

타이틀 중 UserName은 PowerBuilder 사용자 이름에 따라 달라집니다. Windows 7 의 경우

UserName 폴더는 C:\Users 폴더 안에 있습니다.

표 8.1:

C:\...\UserName\하위 폴더 복사 또는 업데이트 되는 파일

On Windows 2008, Windows 7/8.1/10 :

• AppData\Local\Appeon\PowerBuilder 17.0

• 초기화 파일

( PB.INI, PBLAB170.INI, PBODB170.INI )

On Windows 2008, Windows 7/8.1/10:

• Documents\Appeon\PowerBuilder

17.0\Tutorial

• PowerBuilder Getting Started

tutorial 관련 파일

각각의 사용자들을 위한 Write 권한을 가진 PowerBuilder 파일들의 위치는 Windows Registry의

HKEY_CURRENT_USER 항목에 설정됩니다.

예) 사용자 별 로컬 어플리케이션 데이터 폴더로 복사되는 PB.INI의 위치는

HKEY_CURRENT_USER\Software\Sybase\PowerBuilder\17.0\InitPath의 Registry Key로

등록 됩니다.

8.1.3 Registry 변경

설치 프로그램은 Windows Registry를 다음과 같이 변경합니다.

HKEY_CURRENT_USER\Software 와 HKEY_LOCAL_MACHINE\Software의 Key를 만들거나

업데이트 합니다.

14

HKEY_CURRENT_USER\Environment의 시스템과 User Path를 업데이트합니다.

HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\App Paths에

경로를 추가합니다.

다음의 적절한 경로를 Registry 경로에 추가합니다.

HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\App Paths

HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\HTMLHelp에 HTMLHelp

파일의 경로를 추가합니다.

9. Silent(Unattended) Mode 설치

설치 과정 중 메시지나 화면 표시 없이 명령 프롬프트 또는 스크립트로 PowerBuilder를

설치합니다.

필수 조건

다음과 같이 설치 계획을 완료합니다.

라이선스 계약을 동의합니다.

SQL Anywhere 엔진을 설정합니다.

silentinstall.bat 파일을 구성합니다.

silentinstall.bat 파일을 실행합니다.

9.1 라이선스 계약 동의

Silent 설치를 실행하기 전에 Appeon 라이선스 계약을 동의 합니다. 설치 패키지에 있는

silentinstall.bat(Universal Edition) 또는 silentinstall_st.bat(Standalone Edition) 파일의 set

AgreeToAppeonLicense=false 항목을 true로 변경합니다. 변경 되었으면 명령 프롬프트 창에서 실행하는

대신에 silentinstall.bat 또는 silentinstall_st.bat 파일을 더블 클릭하여 실행할 수 있습니다.

-------------------------------------------------------------------------------------

set AgreeToAppeonLicense=false => set AgreeToAppeonLicense=true

-------------------------------------------------------------------------------------

9.2 SQL Anywhere 엔진 설정

Silent 설치를 실행하기 전에 SQL Anywhere 엔진의 위치를 지정합니다.

Universal Edition의 경우, 설치 패키지에 있는 setup.iss 파일의 szSqlAnywhereDir 값을 설정합니다.

Standalone Edition의 경우 pbsetup.iss 파일의 szSqlAnywhereDir 값을 설정합니다.

-----------------------------------------------------------------------

szSqlAnywhereDir=C:\Program Files\SQL Anywhere 16\Bin64

-----------------------------------------------------------------------

9.3 Silent 설치 명령어

이 항목은 PowerBuilder의 Silent 설치 명령어에 대한 설명입니다.

15

윈도우 명령 프롬프트에서 Silent 설치를 실행하려면 설치 패키지(silentinstall.bat(Universal Edition)

또는 silentinstall_st.bat(Standalone Edition))에서 명령을 실행합니다.

---------------------------------------------------------------------------------------------------------------------

silentinstall.bat [ "opt=product" "dir=directoryName" "shr=sharedDirectoryName" "log=logFileName" ]

[ { help | /? } ]

---------------------------------------------------------------------------------------------------------------------

파라미터 나열 순서는 상관 없으며, 대소문자를 구분하지 않습니다. 또한 파라미터 값도 대소문자를

구분하지 않습니다.

표 9.1:

Silent 설치 파라미터 설명

opt 설치할 제품 또는 제품 이름을 지정합니다.

Standalone Edition에서는 선택사항이며 Universal Edition의 값은 다음과

같습니다.

All : Installs PowerBuilder, PowerServer Mobile, PowerServer Toolkit,

PowerServer Help

PB : Installs only PowerBuilder

PSM : Installs only PowerServer Mobile

PST : Installs only PowerServer Toolkit

PSH : Installs only PowerServer Help

dir 기본 설치 경로를 지정합니다. 이 파라미터를 생략하면

sysDriver\Program Files\Appeon\productName 폴더에 설치되며,

sysDriver는 컴퓨터 메인 드라이브이며, productName은

PowerBuilder 2017 입니다.

shr PowerBuilder의 shared 폴더를 지정합니다. 이 파라미터를 생략하면

디폴트로 sysDriver\Program Files\Appeon \Shared 폴더에 설치됩니다.

log 설치에 대한 로그 파일 이름을 지정합니다. 이 파라미터를 생략하면 디폴트로

시스템 임시 폴더에 silentinstall.log라는 이름으로 로그 파일이 생깁니다.

help or /? 명령을 실행하는 대신 명령어와 파라미터를 표시해줍니다. Silent 설치의 Help

입니다.

다음 예제에서는 Silent 설치 명령의 모든 파라미터를 사용합니다.

---------------------------------------------------------------------------------------------------------------------

silentinstall.bat "opt=pb" "dir=D:\appeon\pb170" "shr=D:\appeon\shared"

"log=D:\appeon\install.log"

---------------------------------------------------------------------------------------------------------------------

Silent 설치 시 다음 항목의 정확한 버전이 설치되어 있지 않으면 경고문이 로그파일에 기록됩니다.

SQL Anywhere

Microsoft .NET Framework

Microsoft .NET Framework SDK

Microsoft IIS

16

10. 설치 이후 작업

설치 후 PowerBuilder를 사용하기 전에 마이그레이션 또는 구성요소 설정 작업을 수행해야 할 수도

있습니다.

PowerBuilder 2017로 어플리케이션 마이그레이션

이전 버전의 PowerBuilder에서 만든 어플리케이션과 PowerBuilder library files(PBLs)들이 있는 경우

PowerBuilder 2017로 마이그레이션 할 수 있습니다. 마이그레이션 하기 전에 그 이전 버전에서 오류

없이 성공적인 Regenerate가 되어야 하며, 반드시 소소를 백업해 둡니다.

PowerBuilder 2017은 유니코드 기반이므로, PowerBuilder 9.x 이하 버전에서 만들어진 어플리케이션인

경우 일부 코드가 변경 됩니다. 자세한 내용은 PowerBuilder Users Guide의 migrating targets

섹션을 참고하십시오. 또한 PowerBuilder 릴리즈 게시판의 Migration Issues 섹션과 Migrating

PowerBuilder Applications 기술문서를 참고하십시오.

DBMS 설정

PowerBuilder에서 DBMS를 사용하기 위해 추가적인 설정 작업이 필요할 수 있습니다. 자세한 내용은

도움말의 Connecting to Your Database를 참고하십시오.

JDBC를 위한 jConnect용 데이터베이스 업그레이드

jConnect 5.5용 SQL Anywhere 또는 Adaptive Server® Enterprise 데이터베이스가 필요합니다.

Ghostscript 설치

DataWindow를 distill 방식 PDF로 저장하려면 필요합니다.

PostScript 드라이버 설치

DataWindow를 distill 방식 PDF로 저장하려면 필요합니다.

10.1 JDBC를 위한 jConnect용 데이터베이스 업그레이드

추가적인 Table과 Stored Procedure 설치를 위한 jConnect용 SQL Anywhere 또는 Adaptive

Server Enterprise 데이터베이스를 준비합니다.

jConnect는 필요한 Stored Procedure와 Table 생성을 위한 스크립트를 제공합니다. 자세한 내용은

installation guide의 jConnect를 참고하십시오.

10.2 Ghostscript 설치

DataWindow를 distill 방식 PDF로 저장하려면 Ghostscript가 설치되어야 합니다.

Ghostscript 설치는 다음과 같이 합니다.

1) Ghostscript 웹 사이트 http://ghostscript.com/에 접속하여 원하는 버전의 자동 설치 파일을

다운로드 받습니다.

2) Ghostscript 자동설치 파일을 실행하여 설치 합니다.

10.3 PostScript 드라이버 설치

이 항목은 DataWindow를 PDF로 저장하기 위해 PostScript 드라이버를 어떻게 설치하고 사용하는지

설명합니다.

17

데이터윈도우를 PDF로 저장하기 위해 distill method를 사용하려면 시스템에 PostScript 프린터 또는

프린터 드라이버가 설치되어 있어야 합니다. Windows Add Printer 마법사를 사용하여 PostScript

Printer를 설치합니다.

컴퓨터에 PostScript Printer가 설치되지 않았거나 필요한 Microsoft pscript5.dll 파일을 사용할 수

없는 경우 마법사에서 Windows 설치 CD를 넣으라는 메시지를 띄웁니다.

시스템에 PostScript printer를 다음과 같이 추가합니다.

1) 윈도우 “시작” 메뉴에서 “장치 및 프린터” 선택

2) “프린터 추가” 선택

3) “로컬 프린터 추가” 선택

4) 기존 포트 사용 항목에서 FILE: (파일로 인쇄) 선택

5) 제조 업체 (ex. HP)와 PS(ex. HP LaserJet Series 4050 PS) 프린터 선택

Note

몇몇 프린터들은 이미지를 올바르게 처리하지 못합니다. 예를 들어 HP Color LaserJet

PS는 이미지를 PDF로 출력하지 못하며, HP LaserJet 4 / 4M Plus PS 600은 greyscale을

이용하여 컬러 이미지를 표시합니다.

6) 프린터 이름 입력

7) 마법사 완료

DataWindow 페인터에서 프린트 드라이버를 사용하려면 다음과 같이 설정합니다.

1) 프로퍼티 중 Data Export 탭에서 Format to configure를 PDF로 선택하고 Method로 Distill!

선택 후 Distill Custom PostScript 항목을 체크합니다.

2) 프로퍼티 중 Print Specifications 탭에서 Printer Name으로 앞서 추가한 프린터 명을

입력합니다.

18

스크립트에서 프린터 드라이버를 사용하기 위해서는 Distill.CustomPostScript 와 Printer

속성을 설정합니다.

예제)

dw_1.Object.DataWindow.Export.PDF.Distill.CustomPostScript=1

dw_1.Object.DataWindow.Printer="HP LaserJet Series 4050 PS"

11. PowerBuilder 활성화

PowerBuilder 2017을 처음 실행할 때 로그인을 통해 PowerBuilder를 활성화 해야 합니다.

로그인 계정이 없는 경우 라이선스 관리자에게 문의하여 계정을 생성합니다. 라이선스

관리자는 PowerBuilder를 사용하는 머신의 인터넷 연결 여부에 따라 온라인 라이선스

또는 오프라인 라이선스 계정을 부여합니다.

이 항목은 PowerBuilder만을 위한 활성화 방법입니다. 만일 PowerServer (PB Universal

Edition) 활성화를 원한다면 PowerServer 도움말 PowerServer Configuration Guide for .NET

PowerServer 섹션의 License Management 섹션을 참고하십시오.

PowerBuilder, InfoMaker, PowerServer 라이선스 활성화에 대한 더 정확한 설명을 위해

https://www.appeon.com/sites/default/files/pictures/Downloads/Appeon_License_User_Gu

ide.pdf 문서를 참고하십시오.

11.1 온라인 활성화

온라인 활성화를 위해서는 라이선스 관리자로부터 승인된 유효한 온라인 라이선스 계정을 입력해야

합니다. 또한 온라인 라이선스는 Appeon 라이선스 서버에 의해 활성화 되기 때문에 활성화

19

과정에서는 반드시 인터넷이 연결되어 있어야 합니다.

11.1.1 온라인 라이선스 활성화

온라인 라이선스 계정으로 PowerBuider를 활성화 하려면 다음 단계를 따릅니다.

Step 1

PowerBuilder 실행합니다. 설치 후 처음 PowerBuilder를 실행하면 Log in to PowerBuilder

화면이 자동으로 뜹니다.

Step 2

Log in to PowerBuilder 화면에서 Log in 버튼을 클릭합니다.

Step 3

User Name과 Password 입력 후 Log In 버튼을 클릭합니다.

Appeon 라이선스 서버로부터 바로 라이선스를 검증하고 활성화 하기 위해 인터넷이

반드시 연결되어 있어야 하며, 한번만 성공적으로 라이선스 검증과 활성화 과정을 거치면

다음 접속부터는 자동 로그인 됩니다.

계정과 라이선스 정보를 확인하려면 PowerBuilder IDE 최 상단 오른쪽에 보이는 로그인 된

계정 이름을 클릭하여 팝업 메뉴 중 Account Management 항목을 선택합니다.

11.1.2 온라인 라이선스 새롭게 반영

라이선스 관리자로부터 온라인 라이선스가 갱신 또는 업그레이드 되는 경우 PowerBuilder

IDE에서 온라인 라이선스 정보를 새롭게 반영해야 합니다.

계정 정보 화면(Account Management)에 링크된 Refresh license를 클릭하여 온라인

라이선스를 새롭게 반영합니다. 이 때 인터넷은 연결되어 있어야 합니다.

11.1.3 로그 아웃 하여 비활성화

한번 PowerBuilder에 로그인 되면 온라인 라이선스는 성공적으로 활성화 됩니다.

PowerBuilder를 다른 머신으로 옮기는 등 로그 아웃 하여 라이선스를 비활성화 시켜야 할 상

황이 아니라면 로그인은 계속 유지되어야 합니다.

온라인 라이선스를 비활성화 하려면 계정 정보 화면(Account Management)에 링크된

Sign out을 클릭합니다. 이 때 인터넷은 연결되어 있어야 합니다.

PowerBuilder IDE 최 상단 오른쪽에 표시된 계정 이름을 클릭하고 Account Manage

항목 선택

20

Sign out 클릭

로그아웃이 이뤄지면 Log in to PowerBuilder 화면이 계속 뜹니다.

인터넷이 연결된 상태에서 PowerBuilder를 Uninstall 하면 Uninstall이 시작될 때 자동으로

PowerBuilder를 로그 아웃 시킵니다. 인터넷이 연결되지 않은 상태에서 PowerBuilder를

Uninstall 하려면 라이선스 관리자에게 문의하여 웹 사이트에서 라이선스를 비활성화 한 후

Uninstall을 진행합니다.

11.2 오프라인 라이선스 활성화

오프라인 라이선스는 인터넷에 연결되지 않은 상태에서 PowerBuilder가 설치된 경우 필요한 라이선스

입니다.

오프라인 라이선스 계정은 인터넷 연결에 상관없이 PowerBuilder에 로그인 할 수 있습니다. 인터넷이

연결된 상태에서 오프라인 라이선스 계정으로 로그인하면 온라인 라이선스 계정처럼 간단하게

처리됩니다.

Note: 클라우드 또는 가상화 시스템에 PowerBuilder가 설치된 경우엔 오프라인 라이선스로 활성화

21

할 수 없습니다. 온라인 라이선스 계정으로만 가능합니다.

11.2.1 오프라인 라이선스 활성화

오프라인 라이선스를 활성화 하기 위해 다음 단계를 따릅니다.

Step 1 : Log in to PowerBuilder 화면에서 Activate offline license manually 클릭

Step 2 : 계정 User Name과 Password를 입력하고 인터넷 연결 유무 선택

Activation with Internet connection 선택

인터넷이 연결된 상태에서 Activate 버튼을 클릭하면 오프라인 라이선스는 Appeon

라이선스 서버를 통해 바로 활성화 됩니다.

Activation without Internet connection 선택

인터넷이 연결되어 있지 않은 상태에서 오프라인 라이선스를 활성화 하기 위해서는

다음 과정을 거쳐야 합니다.

1) Generate Client Request 버튼을 클릭하여 Client Request(Text string)를 생성한

22

후 Copy Client Request 버튼을 클릭하여 클립보드에 복사합니다.

2) 인터넷이 연결된 머신에서 아래의 URL에 접속하면 License Activation 페이지가

뜹니다. 페이지 입력 항목에 복사한 Client Request(Text string)를 붙여 넣기 한 후

Submit 버튼을 클릭하면 서버의 결과값(another text string)이 새롭게 생성

됩니다.

URL: https://www.appeon.com/license/get/activation-code?type=activation

3) PowerBuilder 화면으로 돌아와서 Server Response로 받은 String을 결과 입력

항목에 붙여 넣기 한 후 Activate 버튼을 클릭합니다.

23

4) OK 버튼을 클릭하면 활성화가 완료 됩니다.

오프라인 라이선스가 성공적으로 활성화되면 PowerBuilder IDE에 로그인 됩니다.

더 정확한 라이선스 정보를 보려면 PowerBuilder IDE 메뉴 중 Help > Offline License

Management > License Info를 클릭합니다.

11.2.2 오프라인 라이선스 갱신

라이선스 관리자에 의해 오프라인 라이선스가 갱신된 경우 PowerBuilder IDE에서 오프라인

라이선스를 갱신해야 합니다.

PowerBuilder IDE에서 오프라인 라이선스를 갱신하려면 다음 단계를 따릅니다.

Step 1

PowerBuilder IDE 메뉴 중 Help > Offline License Management > Renew 선택

Step 2

인터넷 연결 유무에 따른 오프라인 라이선스 갱신을 선택합니다.

Renew with Internet connection 선택

인터넷이 연결된 상태에서 Renew 버튼을 클릭하면 오프라인 라이선스는 Appeon

라이선스 서버를 통해 바로 갱신 됩니다.

Renew without Internet connection 선택

24

인터넷이 연결되어 있지 않은 상태에서 오프라인 라이선스를 갱신하기 위해서는 다음

과정을 거쳐야 합니다.

1) Generate Client Request 버튼을 클릭하여 Request String을 생성합니다.

2) Copy Client Request 버튼을 클릭하여 Request String을 복사 한 뒤 인터넷이

연결된 머신으로 Request String을 옮깁니다.

3) 인터넷이 연결된 머신에서 아래의 URL에 접속하면 License Renewal 페이지가

뜹니다. 페이지 입력 항목에 복사한 Request String를 붙여 넣기 한 후 Submit

버튼을 클릭하면 Appeon 라이선스 서버를 통해 성공적으로 갱신된 경우

결과값(another text string)이 새롭게 생성 됩니다.

URL: https://www.appeon.com/license/get/activation-code?type=renewal

4) PowerBuilder 화면으로 돌아와서 Server Response로 받은 String을 결과 입력

항목에 붙여 넣기 한 후 Renew 버튼을 클릭합니다.

5) OK 버튼을 클릭하면 갱신이 완료 됩니다.

11.2.3 오프라인 라이선스 업그레이드

라이선스 관리자에 의해 오프라인 라이선스가 업그레이드(ex) Standard Edition -> Universal

Edition)된 경우 PowerBuilder IDE에서 오프라인 라이선스를 업그레이드 해야 합니다.

PowerBuilder IDE에서 오프라인 라이선스를 업그레이드 하려면 다음 단계를 따릅니다.

Step 1

PowerBuilder IDE 메뉴 중 Help > Offline License Management > Upgrade 선택

Step 2

인터넷 연결 유무에 따른 오프라인 라이선스 업그레이드를 선택합니다.

Upgrade with Internet connection 선택

인터넷이 연결된 상태에서 Upgrade 버튼을 클릭하면 오프라인 라이선스는 Appeon

라이선스 서버를 통해 바로 업그레이드 됩니다.

Upgrade without Internet connection 선택

인터넷이 연결되어 있지 않은 상태에서 오프라인 라이선스를 업그레이드 하기 위해서는

다음 과정을 거쳐야 합니다.

1) Generate Client Request 버튼을 클릭하여 Request String을 생성합니다.

2) Copy Client Request 버튼을 클릭하여 Request String을 복사 한 뒤 인터넷이

연결된 머신으로 Request String을 옮깁니다.

25

3) 인터넷이 연결된 머신에서 아래의 URL에 접속하면 License Upgrade 페이지가

뜹니다. 페이지 입력 항목에 복사한 Request String를 붙여 넣은 후 Submit 버튼을

클릭하면 Appeon 라이선스 서버를 통해 성공적으로 업그레이드 된 경우 결과값이

새롭게 생성 됩니다.

URL: https://www.appeon.com/license/get/activation-code?type=upgrade

4) PowerBuilder 화면으로 돌아와서 Server Response로 받은 String을 결과 입력

항목에 붙여 넣기 한 후 Upgrade 버튼을 클릭합니다.

5) OK 버튼을 클릭하면 업그레이드가 완료 됩니다

11.2.4 오프라인 라이선스 비활성화

한번 PowerBuilder에 로그인 되면 오프라인 라이선스는 성공적으로 활성화 됩니다.

PowerBuilder를 다른 머신으로 옮기는 등 로그 아웃 하여 라이선스를 비활성화 시켜야 할 상황이

아니라면 로그인은 계속 유지되어야 합니다.

오프라인 라이선스를 비활성화 하려면 다음 단계를 따릅니다.

Step 1

PowerBuilder IDE 메뉴 중 Help > Offline License Management > Deactivate 선택

Step 2

인터넷 연결 유무에 따른 오프라인 라이선스 비활성화를 선택합니다.

Deactivation with Internet connection 선택

인터넷이 연결된 상태에서 Deactivate 버튼을 클릭하면 오프라인 라이선스는 Appeon

라이선스 서버를 통해 바로 비활성화 됩니다.

Deactivation without Internet connection 선택

인터넷이 연결되어 있지 않은 상태에서 오프라인 라이선스를 비활성화 하기 위해서는

다음 과정을 거쳐야 합니다.

1) Deactivate 와 Copy Deactivation Request 버튼을 클릭하여 Request String을

생성하고 복사합니다.

Deactivate 버튼을 클릭하면 바로 PowerBuilder가 비활성화 되지만, 이후 해당

라이선스를 다시 사용할 수 있는 상태로 만들기 위해 Appeon 라이선스 서버에서도

비활성화 해주어야 합니다. 비활성화 관련 정보는 아래의 파일로 저장 됩니다.

Users\<username>\AppData\Local\Temp\PBLicenseDeactivate\DeactivateCode.txt

2) 인터넷이 연결된 머신으로 Request String을 옮깁니다.

3) 인터넷이 연결된 머신에서 아래의 URL에 접속하면 License Deactivation

페이지가 뜹니다. 페이지 입력 항목에 복사한 Request String를 붙여 넣은 후

Submit 버튼을 클릭하면 Appeon 라이선스 서버를 통해 성공적으로 비활성화

26

되었다고 메시지를 뿌려줍니다.

URL: https://www.appeon.com/license/get/activation-code?type=deactivation

12. PowerBuilder Uninstall

이 항목은 PowerBuilder를 Uninstall에 대한 설명입니다.

PowerBuilder를 Uninstall 하기 전 먼저 라이선스를 처리해야 합니다.

온라인 라이선스를 사용하는 경우, 인터넷이 연결된 상태에서 PowerBuilder를 Uninstall하면

PowerBuilder는 자동으로 로그 아웃 됩니다. 인터넷이 연결되어 있지 않은 상태에서 PowerBuilder를

Uninstall 할 경우엔 라이선스 관리자에 문의하여 웹 사이트에서 라이선스를 비활성화 한 후에

진행합니다.

오프라인 라이선스를 사용하는 경우, 같은 컴퓨터에서 해당 라이선스를 계속 사용하려면 비활성화를

하지 않고 PowerBuilder를 Uninstall하고, 다른 컴퓨터로 해당 라이선스를 옮기려면 라이선스를

비활성화 한 후 PowerBuilder를 Uninstall 합니다.

PowerBuilder를 로그 아웃 하거나 오프라인 라이선스를 비활성화 하기 위해서는 11.1.3 “로그 아웃 하여

비활성화”와 11.2.4 “오프라인 라이선스 비활성화”를 참고하십시오.

아래의 방법 중 하나를 선택하여 Uninstall을 위한 제품 설치 관리 프로그램을 실행한다.

제어판을 통한 프로그램 추가 / 삭제

재설치 계획이 있다면 재활용을 위한 파일(DB, INI, PBL)들을 백업

시작 > 제어판 > 프로그램 및 기능 선택

프로그램 항목을 선택 한 후 오른쪽 마우스 버튼을 클릭하여 팝업 메뉴 중 제거(U) 항목 선택

만일 공유 파일 삭제에 대한 메시지가 뜨면 적절한 항목 클릭

Silent Uninstall

9.3 “Silent 설치 명령어”를 참고하십시오.

설치 관리 프로그램이 삭제하는 항목은 다음과 같습니다.

Shared and standard program files

Folder items

Program folders

Program directories

Program registry entries

설치 관리 프로그램은 파일 및 시작 프로그램 그룹을 삭제할 뿐만 아니라 시스템 및 Registry에 설정된

User Path, INI 파일을 삭제합니다. 단순히 폴더 삭제만으로는 프로그램이 완전히 삭제되지 않습니다.

Note

설치 프로그램과는 달리 설치 관리 프로그램은 Back 또는 Cancel 버튼이 없으며 Yes 버튼을

클릭하면 프로그램을 중단할 수 없습니다.