[명령어|OS공통] DsExcel Java 오프라인 활성화/비활성 방법

배포 및 라이선싱 [명령어|OS공통] DsExcel Java 오프라인 활성화/비활성 방법

추천0

페이지 정보

작성자 MESCIUS

작성일 2022-01-14 13:36 조회 599회 댓글 0건

본문

관련링크

* GcExcel Java가 2023년 11월 1일부터 DsExcel Java 로 변경되었습니다. DsExcel Java와 GcExcel Java는 동일한 제품임을 안내 드립니다.

오프라인 인증은 권장하지 않습니다. 오프라인 모드(인터넷 없음)에서 활성화된 라이선스는 비활성화가 어려우며, 이로 인해 라이선스 인증 횟수가 소실될 수 있습니다. 이로 인한 라이선스 인증 횟수 소실은 메시어스에서는 책임지지 않으며, 라이선스 활성화와 비활성화는 반드시 온라인 환경(인터넷 있음)에서 진행해주시기를 권장드립니다.

해당 포스팅에서는 인터넷이 연결이 없는 Windows(윈도우)/Linux(리눅스) / Mac OS(맥 OS) 기반의 개발 및 배포 환경에서, 명령어를 통해서 DsExcel Java API를 활성화하고 비활성화하는 방법에 대해서 설명합니다.

불가피한 경우가 아니라면, 오프라인 인증 방법은 권장되지 않으며,

아래와 같이 온라인 환경에서 라이선스 활성화/비활성화를 진행해주시기를 적극 권장드립니다.

[윈도우 UI툴] DsExcel Java 활성화/비활성화 방법
[명령어] DsExcel Java 활성화/비활성화 방법(윈도우/리눅스/맥OS 공통)

이 포스팅에서는 아래와 같은 내용을 다룹니다.

개발자&배포 키 획득 방법
오프라인 라이선스 활성화 안내
- 개발자 라이선스 활성화
- 배포 라이선스 활성화 (주의: 오프라인 상에서 활성화된 라이선스는 비활성이 불가능합니다.)
오프라인 라이선스 비활성화 안내
- 개발자 라이선스 비활성화
- 배포 라이선스 비활성화 (주의: 오프라인 상에서 활성화된 라이선스는 비활성이 불가능합니다.)

*컴퓨터(또는 서버)를 포맷하시거나, 다른 컴퓨터(또는 서버)로 개발(또는 배포)하고자 하실 경우, 반드시 기존에 활성화 했던 라이선스를 비활성화 하여, 활성화 횟수를 관리해주셔야 합니다.

* 개인의 부주의로 인한 라이선스 인증 횟수 유실은 도움을 드리기 어려우니 이점 유의해주세요.

개발자&배포 라이선스 키 획득 방법

아래와 같은 방법으로, 개발자 모드를 활성화 하기 위한 라이선스 키를 획득할 수 있습니다.

메시어스 코리아로부터, "프로젝트 라이선스"를 구매 해주세요.
MESCIUS 개발/배포 키 발급 신청 포탈을 통해 개발 및 배포 라이선스 키를 신청해 주세요. 신청 시, 아래의 정보들이 필요합니다.
- 주문번호
- 구매 증서에 있는 프로젝트 라이선스 키
- 프로젝트명
- 개발자 수 (개발자 PC 수)
- 배포할 서버 수 (배포할 머신 수)
메시어스 코리아로부터 전달 받은 개발자 및 배포 키를 개발자 컴퓨터 또는 서버 컴퓨터(기기)에 설정해주세요.

위의 과정을 통해 발급 받은 개발자 및 배포 라이선스를 활성화/비활성화하는 방법은 아래에서 상세하게 설명하겠습니다.

명령어를 이용한 오프라인 라이선스 활성화 방법 - 개발자 & 배포

오프라인 라이선스 활성화/비활성화를 위해서는 인터넷에 접속할 수 있는 다른 PC 혹은 모바일 기기가 반드시 필요합니다.

다운 받으신 라이브러리 폴더 내의,

"GcExcel Java License Manager > (OS) License Manager 폴더" 에 있는 "gc-excel-lic5" 파일을 사용하여 Windows, Linux, Mac에서 쉽고 빠르게 명령어를 통해 개발자/배포 라이선스를 활성화 하거나 또는 비활성화 할 수 있습니다.

* 참고 gc-excel-lic5에서 사용되는 매개 변수는 Windows, Linux, MacOS 모두에서 동일합니다.

명령어 창을 실행합니다.
"GcExcel Java License Manager > (OS) License Manager 폴더"의 "gc-excel-lic5" 파일이 있는 위치로 이동합니다.
```
cd 폴더 경로
```
명령어 창에서 gc-excel-lic5 라고 입력하면, 아래와 같이 사용 가능한 명령어의 목록을 볼 수 있습니다.

오프라인 개발자 라이선스 활성화

오프라인 환경에서 개발자 라이선스의 활성화/비활성화를 위해서는 https://sa2.grapecity.com/ 에 접속할 수 있는 다른 PC 혹은 모바일 기기가 반드시 필요합니다.

개발자 PC에서 개발자가 정식 API 사용을 위한 권한을 얻기 위해서는 아래와 같은 과정을 통해 개발자 라이선스를 PC에 인증해야 합니다.

인터넷 연결이 없는 개발자 컴퓨터의 명령어 창에서, "GcExcel Java License Manager > (OS) License Manager 폴더"의 "gc-excel-lic5" 파일이 있는 위치로 이동합니다.
```
cd 폴더 경로
```
아래와 같이 명령어를 입력하여, 해당 컴퓨터에 대한 암호화된 인증 코드 파일을 생성합니다. (인증 파일의 확장자는 *.lic 입니다.)
```
gc-excel-lic5 dev -g [개발자 라이선스 키] [인증 코드 파일을 생성할 경로/파일명.lic]
```
아래 예시에서 파일명은 test-other.lic로 하였습니다.

인터넷이 연결된 다른 컴퓨터에 위에서 생성한 test-other.lic 파일을 이동합니다. https://sa2.grapecity.com/Activate 접속 후에, test-other.lic 파일 안에 있는 인증 코드를 복사하여 붙여넣고, 활성화 버튼을 클릭합니다.
다음 화면에서 나타는 새로운 개발자 라이선스 인증 코드를 복사하여, 메모장이나 다른 IDE 툴에서 붙여넣어 파일명을 " license.lic"로 저장합니다.
위에서 생성한 license.lic 파일을 기존에 인터넷 연결이 없는 PC에 복사하고, 해당 위치에서 다음 명령을 실행합니다.
```
gc-excel-lic5 dev -i [license.lic 파일 경로]
```
위의 과정을 거치면 아래와 같이 정상적으로 제품이 활성화되어, 개발을 위한 개발자 모드를 활성화 할 수 있습니다.

오프라인 배포 라이선스 활성화

오프라인 환경에서 활성화한 배포 라이선스는 비활성화가 불가능합니다. 불가피한 경우가 아니라면 권장하지 않습니다.
배포 라이선스 활성화 및 비활성화는 아래와 같이 온라인 환경에서는 진행해주시기를 권장드립니다. - [윈도우 UI툴] DsExcel Java 활성화/비활성화 방법 - [명령어] DsExcel Java 활성화/비활성화 방법(윈도우/리눅스/맥OS 공통)

Windows/Linux/Mac OS가 설치된 서버에서 DsExcel Java API 사용하여 개발한 프로젝트를 배포하기 전에 반드시 아래와 같이 윈도우 서버에 배포 라이선스를 인증해야 배포 이후에 라이선스 에러 없이 정상적으로 작동합니다.

오프라인 환경에서 인터넷이 연결된 다른 PC를 통해 배포 라이선스 인증을 진행합니다.

쉬운 이해를 위해, 아래와 같이 PC 명을 지정하겠습니다.

인터넷이 연결된 PC를 A PC
인증하려는 오프라인 PC를 B PC

먼저, 인터넷이 연결된 A PC에서, "GcExcel Java License Manager > (OS) License Manager 폴더"의 "gc-excel-lic5" 파일이 있는 위치로 이동합니다. 아래 명령어를 실행하여 원하는 위치에 라이선스 파일을 생성합니다.
```
gc-excel-lic5 deploy -ao [개발자 라이선스 키] [호스트네임(PC명)] [라이선스 파일 생성 경로/파일명]
```
위에서 생성한 라이선스 파일을 B PC로 이동합니다.

B PC로 배포하기 전에 소스 코드 상에 아래와 같이 권한을 부여하는 코드를 추가합니다.

workbook.SetLicenseFile("라이선스 파일");

예시는 아래와 같습니다.

public static void main(String[] args){
   System.out.println("Hello GcExcel 5.0 License Demo!");
   
   //새로운 워크북 생성
   Workbook workbook = new Workbook();
   
   //라이선스 인증 코드 파일 불러오기
   workbook.SetLicenseFile("C://GcExcel5JavaLicense");
}

이제 배포 라이선스가 활성화되었으며, 어떠한 제약과 워터마크 없이 최종 사용자에게 DsExcel Java가 제공하는 기능을 온전히 Windows/Linux/Mac OS 서버에 배포하여 제공할 수 있습니다.

명령어를 이용한 오프라인 라이선스 비활성화 방법

- 개발자 Only, 배포 X

오프라인 환경에서 활성화한 배포 라이선스는 비활성화가 불가능합니다. 불가피한 경우가 아니라면 권장하지 않습니다.
배포 라이선스 활성화 및 비활성화는 아래와 같이 온라인 환경에서는 진행해주시기를 권장드립니다. - [윈도우 UI툴] DsExcel Java 활성화/비활성화 방법 - [명령어] DsExcel Java 활성화/비활성화 방법(윈도우/리눅스/맥OS 공통)

오프라인 환경에서는 개발자 라이선스만 비활설화가 가능합니다. 오프라인 환경에서 활성화한 배포 라이선스는 비활성화가 불가능합니다.

그렇기 때문에 배포 라이선스는 반드시 온라인(인터넷 있음) 환경에서 활성화/비활성화를 진행해주시기를 권장드립니다.

오프라인 개발자 라이선스 비활성화

만약에 현재 개발자 라이선스를 더 이상 사용하지 않거나, 개발자 라이선스를 다른 기기로 옮기고자 하는 경우,

아래와 같이 반드시 개발자 라이선스를 비활성화 하여, 다른 기기에서 재활성화 할 수 있도록 인증 횟수를 관리해야 합니다.

개발자 컴퓨터의 명령어 창에서 "GcExcel Java License Manager > (OS) License Manager 폴더"의 "gc-excel-lic5" 파일이 있는 위치로 이동한 후, 아래와 같이 명령어를 입력하여, 라이선스 비활성화를 위한 암호화된 인증 코드가 들어 있는 텍스트 파일을 생성합니다.
```
gc-excel-lic5 dev -dx revoke-license.txt
```
인터넷이 되는 기기로 1번에서 생성한 라이선스 파일을 옮기고, 아래 링크에 접속하여 revoke-license.txt 안에 있는 인증 코드 텍스트를 붙여넣고 비활성화 버튼을 클릭합니다. https://sa2.grapecity.com/Deactivate