기술 자료

지원

서버 구성하기(버전 1.x 이하)

Run the setup to configure version 1.x of the Unity Licensing Server.
읽는 시간 1분최근 업데이트: 2일 전

서버 구성은 Unity Licensing Server 설정을 위한 전체 프로세스의 일부입니다.
중요
이 페이지는 라이선스 서버 버전 1.x 이하에 해당될 경우 적용됩니다. 버전 2.0 이상을 구성하는 경우 서버 구성하기(버전 2.0 이상)를 참고하십시오.

구성 개요

라이선스 서버를 구성하려면 두 가지 단계를 따라야 합니다.
  • 첫 번째 단계에서는 라이선스 서버에서
    setup
    명령어를 실행합니다.
    setup
    명령어는 다음 세 개의 파일을 생성합니다.
    • 지정한 라이선스 서버 구성 파라미터를 저장하는 라이선스 서버 구성 파일(
      licensing-server-config.json
      ). 서버를 재구성하는 경우
      setup
      명렁어는 이 파일을 읽고 저장된 구성 파라미터를 기본값으로 저장합니다.
    • 서버를 구성하거나 재구성한 후 모든 클라이언트 컴퓨터에 배포할 서비스 구성 파일(
      services-config.json
      ).
    • 서버의 머신 바인딩 정보가 포함된 서버 등록 요청 파일(
      server-registration-request.xml
      ). 두 번째 단계에서 이 파일을 업로드하여 서버를 등록합니다.
  • 두 번째 단계에서는 Unity ID 포털에서 서버를 등록하고 시트를 관리합니다.
    setup
    명령어로 생성된 XML 파일을 업로드하여 서버를 등록합니다. 이 파일은 다음 정보를 제공합니다.

    머신 바인딩 정보

    설명

    "FirstPhysicalAddress"
    서버의 MAC 주소
    "Platform"
    서버의 운영체제
    "ProcessorCount"
    서버의 프로세서 코어 수
    "MachineName"
    서버의 이름

시작하기 전에

다음 사항을 준비하십시오.
  • 서버 설정 파일을 다운로드합니다.
  • 라이선스 서버가 사용할 프로토콜(HTTP 또는 HTTPS)을 결정합니다.
  • HTTPS 프로토콜을 사용하는 경우 개인 정보 교환 형식(
    .pfx
    )의 서버 인증서가 있어야 합니다.
    중요
    Unity는 이 인증서를 제공하지 않습니다. 이 인증서를 관리하고 사용자 컴퓨터에서 승인되었는지 확인하는 것은 IT 팀의 책임입니다.
  • Unity.Licensing.Client
    가 라이선스를 얻을 수 있도록 네트워크 인터페이스에 대한 방화벽을 구성합니다.
  • 클라이언트 연결을 허용하는 데 사용할 포트를 결정합니다. 이미 다른 애플리케이션에서 사용되고 있지 않은 포트를 선택해야 합니다.
    setup
    커맨드를 실행하고 비어 있지 않은 포트를 선택한 경우, 설정을 처음부터 다시 시작하고 다른 포트를 선택해야 합니다.
  • 허용 목록의 IP 주소를 사용하여 관리 API에 대한 액세스를 제어할 수 있습니다.
    setup
    커맨드를 실행하기 전에 관리 API에 액세스해야 하는 모든 사용자의 IP 주소를 수집하십시오.

설정 커맨드 실행

커맨드 라인에서 인터랙티브 설정을 시작하려면 다음 단계를 따릅니다.
  1. Linux 터미널 또는 Windows PowerShell에서 운영체제와 일치하는 커맨드를 실행합니다.
    • Linux:
      ./Unity.Licensing.Server setup
    • Windows:
      .\Unity.Licensing.Server.exe setup
    터미널 또는 PowerShell 창에 환영 메시지가 나타납니다.
    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)을 설정합니다.
    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. 라이선스 서버가 서비스를 제공할 네트워크 인터페이스의 인덱스 번호를 입력합니다.
    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 2228Enter the index number of the network interface which server will operate on:

    참고
    이 인터페이스는 Unity Licensing Client가 라이선스를 얻기 위해 라이선스 서버와 통신할 수 있도록 방화벽에서 오픈이 되어 있어야 합니다.
  5. 클라이언트가 연결할 포트 번호를 입력합니다. 포트 충돌을 방지하려면 알려진 범위 밖의 포트를 사용하고 4자리 또는 5자리 번호를 지정합니다.
    Enter server's listening port number (between 0 and 65535): [80]

    참고
    선택한 포트가 이미 다른 애플리케이션에서 사용 중이고 이로 인해 정상적으로 서버가 실행되지 않는 경우 처음부터
    setup
    커맨드를 재실행 후 다른 포트를 선택하십시오.
  6. 관리자 액세스를 구성합니다.
  • 라이선스 서버는
    admin
    API 엔드포인트에 대한 관리자 액세스를 제한할 수 있습니다. 이러한 엔드포인트는 자세한 서버 정보를 포함하며, 일반적인 구성 문제를 진단하고 해결하는 데 유용합니다.
  • 서버 자체 내부 및 공개적으로 액세스 가능한 기본 IP 주소에서 서버에 대한 액세스를 허용하려면
    y
    를 입력합니다. 기본IP 주소를 사용하고 싶지 않을 경우,
    n
    을 선택하여 관리자 IP 허용 목록을 수동으로 추가합니다.
    Add default addresses to the Admin IP allowlist (127.0.0.1, ::1, 192.168.0.51)? [Y/n]List of current allow-listed admin IP addresses:- 127.0.0.1- ::1- 192.168.0.51Add an additional admin IP address to the allow list? [y/N] yEnter admin IP address (Press Enter to skip):
  • 추가 관리자 IP를 정의하려면
    y
    를 입력한 다음 관리자 IP 허용 목록에 추가할 새 IP를 입력합니다. 그렇지 않으면
    n
    을 입력합니다.
콘솔 출력을 검토하고
server-registration-request.xml
의 위치를 기억해 두십시오. 이 페이지 뒷부분에서 설명하는 다음 작업인 서버 등록 및 시트 관리를 수행하려면 이 파일이 필요합니다.

샘플 출력

설정이 성공적으로 완료되면 터미널 또는 PowerShell 창에 다음과 같은 출력이 표시됩니다.
Generating signing key... DoneGenerating server configuration ...DoneGenerating services configuration ...DoneReloading configuration... DoneGenerating server registration request file... DoneSetting 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 locationon 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.jsonWARNING: Please make sure to backup the following directory as it containsessential data for operating the licensing server: ... [Path varies by server version and operating system]

서버 등록 및 시트 관리

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

다음 단계

라이선스 서버 설정을 계속하려면 라이선스 아카이브 파일 다운로드 및 임포트를 진행합니다.