# 서버 구성하기(버전 2.0 이상)

> Run the setup to configure version 2.0 or later of the Unity Licensing Server.

서버 구성은 [Unity Licensing Server 설정](/licensing-server/server-setup.md.md)을 위한 전체 프로세스의 일부입니다.

> **Important:**
>
> 이 페이지는 라이선스 서버 버전 2.x 이상에 해당될 경우 적용됩니다. 버전 1.x 이하를 구성하는 경우 [서버 구성하기(버전 1.x 이하)](./server-setup-cfg-v1.md)를 참고하십시오.

## 구성 개요##overview

라이선스 서버를 구성하려면 두 가지 단계를 따라야 합니다.

* 첫 번째 단계에서는 라이선스 서버에서 `setup` 명령어를 실행합니다. `setup` 명령어는 다음 세 개의 파일을 생성합니다.
  * 지정한 라이선스 서버 구성 파라미터를 저장하는 **라이선스 서버 구성** 파일(`licensing-server-config.json`). 서버를 재구성하는 경우 `setup` 명렁어는 이 파일을 읽고 저장된 구성 파라미터를 기본값으로 저장합니다.
  * 서버를 구성하거나 재구성한 후 모든 클라이언트 컴퓨터에 배포할 **서비스 구성** 파일(`services-config.json`).
  * 서버의 머신 바인딩 정보가 포함된 **서버 등록 요청** 파일(`server-registration-request.xml`). 두 번째 단계에서 이 파일을 업로드하여 서버를 등록합니다.
* 두 번째 단계에서는 [Unity ID 포털](https://id.unity.com)에서 서버를 등록하고 시트를 관리합니다. `setup` 명령어로 생성된 XML 파일을 업로드하여 서버를 등록합니다. 이 파일은 다음 정보를 제공합니다.
  | **머신 바인딩 정보**            | **설명**        |
  | ------------------------ | ------------- |
  | `"FirstPhysicalAddress"` | 서버의 MAC 주소    |
  | `"Platform"`             | 서버의 운영체제      |
  | `"ProcessorCount"`       | 서버의 프로세서 코어 수 |
  | `"MachineName"`          | 서버의 이름        |

## 시작하기 전에##prereqs

다음 사항을 준비하십시오.

* [서버 설정 파일을 다운로드합니다](/licensing-server/server-setup-dl.md.md).
* 라이선스 서버가 사용할 프로토콜(HTTP 또는 HTTPS)을 결정합니다.
* HTTPS 프로토콜을 사용하는 경우 개인 정보 교환 형식(`.pfx`)의 서버 인증서가 있어야 합니다.
  > **Important:**
  >
  > Unity는 이 인증서를 제공하지 않습니다. 이 인증서를 관리하고 사용자 컴퓨터에서 승인되었는지 확인하는 것은 IT 팀의 책임입니다.
* `Unity.Licensing.Client`가 라이선스를 얻을 수 있도록 네트워크 인터페이스에 대한 방화벽을 구성합니다.
* 클라이언트 연결을 허용하는 데 사용할 포트를 결정합니다. 이미 다른 애플리케이션에서 사용되고 있지 않은 포트를 선택해야 합니다. `setup` 커맨드를 실행하고 비어 있지 않은 포트를 선택한 경우, 설정을 처음부터 다시 시작하고 다른 포트를 선택해야 합니다.

## 설정 커맨드 실행##running-the-setup-command

커맨드 라인에서 인터랙티브 설정을 시작하려면 다음 단계를 따릅니다.

1. Linux 터미널 또는 Windows PowerShell에서 운영체제와 일치하는 커맨드를 실행합니다.

   * **Linux**: `./Unity.Licensing.Server setup`
   * **Windows:** `.\Unity.Licensing.Server.exe setup`

   터미널 또는 PowerShell 창에 환영 메시지가 나타납니다.

   ```bash
   Welcome to Unity Licensing Server setup command line interface.
   This setup will help you configure your license server 
   and generate server registration request file.

   Enter the server name (e.g. LicenseServer):  [DESKTOP] TestServer
   ```

2. 서버 이름을 입력합니다.

3. 라이선스 서버가 사용할 프로토콜(HTTP 또는 HTTPS)을 설정합니다.

   ```bash
   Do you want the licensing server to use HTTPS? [Y/n]
   Enter path to the certificate PFX file (Press Enter to skip):
   Enter the PFX password for "httpscertificate.pfx":
   ```

   * 서버 인증서가 없고 이 단계를 건너뛰려면 `n`을 입력합니다.
   * 서버 인증서가 있는 경우 `y`를 입력한 다음 표시된 곳에 `.pfx` 파일의 경로와 비밀번호를 설정합니다.

4. 라이선스 서버가 서비스를 제공할 네트워크 인터페이스의 인덱스 번호를 입력합니다.

   ```bash
   List of available network interfaces on this host
   - [1] en0 (8C:85:90:CA:72:DC) 192.168.0.51
   - [2] gpd0 (02:50:41:00:01:01) 10.1.4   2228
   Enter the index number of the network interface which server will operate on:
   ```

   > **Note:**
   >
   > 이 인터페이스는 Unity Licensing Client가 라이선스를 얻기 위해 라이선스 서버와 통신할 수 있도록 방화벽에서 오픈이 되어 있어야 합니다.

5. 클라이언트가 연결할 포트 번호를 입력합니다. 포트 충돌을 방지하려면 알려진 범위 밖의 포트를 사용하고 4자리 또는 5자리 번호를 지정합니다.

   ```bash
   Enter server's listening port number (between 0 and 65535):  [80]
   ```

   > **Note:**
   >
   > 선택한 포트가 이미 다른 애플리케이션에서 사용 중이고 이로 인해 정상적으로 서버가 실행되지 않는 경우 처음부터 `setup` 커맨드를 재실행 후 다른 포트를 선택하십시오.

6. 관리자 액세스를 구성합니다.

* 라이선스 서버는 Licensing Server Dashboard 및 `admin` API 엔드포인트에 대한 관리자 액세스를 제한할 수 있습니다. 이러한 툴은 자세한 서버 정보를 포함하며, 일반적인 구성 문제를 진단하고 해결하는 데 유용합니다.
* `admin` 사용자 이름에 비밀번호를 설정하여 관리자 액세스를 구성합니다. 이 비밀번호를 기억하십시오. 관리자 툴에 액세스하려는 모든 사용자는 이 자격 증명을 사용하게 됩니다.

```bash
Credentials are required to access the administration dashboard and API.
The administrator username is "admin".
Create a password for "admin" (8-12 characters):  ********
Confirm the password for "admin":  ********
```

{/* I can fake a "Step 7" with HTML entity (&#55;) but it does NOT wrap properly */}

{/* Trying to force step 7 with this following syntax did NOT work: <ol start="7" />etc */}

콘솔 출력을 검토하고 `server-registration-request.xml`의 위치를 기억해 두십시오. 이 페이지 뒷부분에서 설명하는 다음 작업인 [서버 등록 및 시트 관리](#register-server)를 수행하려면 이 파일이 필요합니다.

### 샘플 출력##sample-output

설정이 성공적으로 완료되면 터미널 또는 PowerShell 창에 다음과 같은 출력이 표시됩니다.

```bash
Generating signing key... Done

Generating server configuration ...Done
Generating services configuration ...Done
Reloading configuration... Done
Generating server registration request file... Done
Setting up file permissions... Done

- - - -
Setup Completed!
- - - -

<Note>
 Server Registration Request
</Note>
Please go to Unity ID portal -> Organizations -> [Organization Name] -> 
Subscriptions & Services -> [Floating Subscription] -> Configure License 
Server, upload server-registration-request.xml, and follow the 
instructions to receive a compressed license archive file.

File to upload:
/home/adminuser/server-registration-request.xml

<Note>
 Services Configuration File
</Note>
Generated services-config.json file must be copied to the following location
on all end user computer in order to enable floating licensing:
 - Windows: %PROGRAMDATA%\Unity\config\
 - MacOS:  /Library/Application Support/Unity/config/
 - Linux:  /usr/share/unity3d/config/

File to copy:
/home/adminuser/services-config.json

WARNING: Please make sure to backup the following directory as it contains
essential data for operating the licensing server:
 ... [Path varies by server version and operating system]
```

## 서버 등록 및 시트 관리##register-server

Unity ID 포털에 라이선스 서버를 등록하는 작업은 한 번만 수행하면 됩니다.

서버를 등록하고 시트를 관리하려면 다음 단계를 수행 하십시오.

1. Unity ID 포털([id.unity.com](https://id.unity.com/))로 이동합니다.
2. **조직**을 선택한 다음 현재 조직을 선택합니다.
3. **구독 및 서비스**를 선택한 다음 플로팅 라이선스(floating license) 구독을 선택합니다.
4. **라이선스 서버 구성**을 선택합니다.
5. **서버 등록 업로드**를 선택하고 설정에서 생성된 `server-registration-request.xml` 파일을 업로드합니다.
6. 왼쪽 패널에서 **라이선스**를 선택하고 방금 등록한 서버의 세부사항을 확장하여 할당된 시트 수(있는 경우)를 확인합니다.
7. 아직 이 라이선스에 시트를 할당하지 않았거나 시트를 더 추가하려면 **시트 관리**를 선택합니다. 값을 입력하고 **저장**을 선택합니다.

이제 서버의 초기 구성이 완료되었습니다.

## 다음 단계##next-steps

라이선스 서버 설정을 계속하려면 [라이선스 아카이브 파일 다운로드 및 임포트](/licensing-server/server-setup-lic.md.md)를 진행합니다.
