# Unity Licensing Server 설정(빠른 시작)

> Follow this quick start guide for simple setups that require minimal configuration.

이 빠른 시작 가이드는 최소한의 구성이 필요한 간단한 설정에 사용할 수 있습니다. 개요라고 보면 됩니다. 설정이 복잡하거나 포괄적인 지침이 필요한 경우 [서버 설정(고급)](./server-setup.md)을 참조하십시오.

## 시작하기 전에

> **Important:**
>
> 구성 파일이 손상된 경우 모든 구성 파일을 복원하지 못할 수도 있습니다.  서버가 올바르게 실행되면 서버를 사용할 수 없게 된 경우 서버를 복원할 수 있도록 모든 구성 파일을 백업하는 것이 중요합니다. 구성 파일을 백업하는 방법은 [백업 및 복원](/licensing-server/server-setup-bkup.md)을 참조하십시오.

## 1: 서버 설정 다운로드

조직 소유자가 환영 이메일을 받고 라이선스를 할당한 후 [id.unity.com](https://id.unity.com/)으로 이동합니다.

기존 계정에 로그인하거나 Unity ID를 생성한 후 왼쪽 패널에서 **조직**을 선택합니다. 현재 조직을 선택하거나 새 조직을 생성합니다.

왼쪽 패널에서 **구독 및 서비스**를 선택하고 플로팅 라이선스(floating license)를 사용하는 새 구독을 선택합니다.

구독에 시트를 추가하려면 **라이선스 서버 구성** > **시트 관리**를 선택합니다.

**라이선스 서버** 페이지로 돌아가 **새 서버 다운로드**를 선택하고 전용 서버의 운영체제를 선택한 다음 `Unity.Licensing.Server.*.zip` 파일을 다운로드합니다.

## 2: 서버 파일 추출

`Unity.Licensing.Server.*.zip` 아카이브의 콘텐츠를 전용 서버의 디렉토리로 추출합니다. 이 디렉토리는 라이선스 서버의 실행 디렉토리가 됩니다.

| 플랫폼     | 제안된 서버 경로                   |
| ------- | --------------------------- |
| Windows | `C:\\UnityLicensingServer`  |
| Linux   | `/opt/UnityLicensingServer` |

## 3: 서버 구성

라이선스 서버를 구성하려면 서버 파일이 포함되어 있는 디렉토리로 이동합니다. 콘솔 또는 터미널에서 다음 커맨드를 실행하고 프롬프트에 따라 구성을 완료합니다.

| 플랫폼     | 설정 커맨드                                |
| ------- | ------------------------------------- |
| Windows | `.\\Unity.Licensing.Server.exe setup` |
| Linux   | `./Unity.Licensing.Server setup`      |

설정 프로세스에는 다음을 구성하는 단계가 포함됩니다.

* 서버 이름
* HTTPS/SSL(선택 사항)
* 네트워크 인터페이스 및 포트
* 관리자 액세스

서버 구성은 현재 작업 디렉토리에 두 개의 파일(`services-config.json` 및 `server-registration-request.xml`)을 생성합니다.

## 4: 서버 등록

`server-registration-request.xml` 파일에는 머신 바인딩 정보가 포함되어 있습니다. [Unity ID 포털](https://id.unity.com)에서 **조직** > **\[조직 이름]** > **구독 및 서비스** > **\[플로팅 구독]** > **라이선스 서버 구성** 아래에 이 서버를 등록합니다. 포털의 지침에 따라 시트를 할당하고 라이선스 아카이브를 다운로드합니다.

## 5: 라이선스 아카이브 임포트

Unity ID 포털 페이지에서 라이선스 아카이브를 `.zip` 파일로 다운로드합니다.

아카이브의 압축을 풀지 않고 콘솔이나 터미널에서 다음 커맨드를 실행하여 파일을 임포트합니다.

| 플랫폼     | 임포트 커맨드                                                       |
| ------- | ------------------------------------------------------------- |
| Windows | `.\\Unity.Licensing.Server.exe import [license archive path]` |
| Linux   | `./Unity.Licensing.Server import [license archive path]`      |

이 단계에서 라이선스 서버 구성이 완료됩니다. 서버를 실행하고 테스트하려면 다음 단계를 계속 진행합니다.

## 6: 라이선스 서버 테스트

서버를 시작하려면 서버 파일을 추출한 디렉토리로 이동하여 다음 커맨드를 실행합니다:

| 플랫폼     | 서버 실행 커맨드                       |
| ------- | ------------------------------- |
| Windows | `.\\Unity.Licensing.Server.exe` |
| Linux   | `./Unity.Licensing.Server`      |

출력 예제:

```bash
Server Version: 1.6.0.19b28b6
Successfully started the licensing server: http://10.211.55.4:8080/v1/admin/status
Press Ctrl+C to shut down...
```

서버가 작동 중인지 테스트하려면 이전 출력의 URL(ex: `http://10.211.55.4:8080/v1/admin/status`을) 웹 브라우저의 주소 표시줄에 복사하여 관리자 API를 사용해 액세스를 시도합니다.

엔드포인트에 액세스한 후 `"serverStatus": "Healthy"`가 표시되면 구성이 완료된 것입니다. 라이선스 서버를 사용할 준비가 되었습니다.

## 7: 서비스를 생성하여 라이선스 서버 실행

라이선스 서버를 서비스로 실행하고 부팅 시 자동으로 시작하려면 관리자 권한으로 다음 커맨드를 실행하고 지침을 따릅니다.

> **Note:**
>
> Windows에서는 서비스를 실행하는 사용자에게 ‘서비스로 로그온' 권한이 할당되어 있어야 합니다. 자세한 내용은 [라이선스 서버에 대한 서비스 설정](/licensing-server/server-setup-svc.md)을 참고하십시오.

| 플랫폼     | 서비스 생성 커맨드                                     |
| ------- | ---------------------------------------------- |
| Windows | `.\\Unity.Licensing.Server.exe create-service` |
| Linux   | `sudo ./Unity.Licensing.Server create-service` |

이 커맨드는 서비스를 생성하고 시작합니다.

## 8: 클라이언트 컴퓨터 구성

`services-config.json` 파일은 플로팅 라이선스(floating license) 서버와 통신하도록 Unity 에디터를 구성합니다. (이 파일은 3단계에서 자동으로 생성되었습니다.)

모든 클라이언트 컴퓨터에서 다음 경로에 `services-config.json`을 복사합니다.

| 플랫폼     | 서비스 구성 경로                                    |
| ------- | -------------------------------------------- |
| Windows | `%PROGRAMDATA%\\Unity\\config\\`             |
| macOS   | `/Library/Application Support/Unity/config/` |
| Linux   | `/usr/share/unity3d/config/`                 |

`services-config.json` 샘플 파일을 보려면 [구성 파일 복사](/licensing-server/client-config.md#copying-the-configuration-file)를 참조하십시오.

이 파일을 사용하면 Unity 에디터를 실행할 때 새 라이선스를 획득하고 닫을 때 라이선스를 반환합니다.