퍼포스 연결 셋업하기

에픽의 퍼포스 서버에 접속하여 언리얼 엔진 4 빌드를 구하는 방법 안내서입니다.

Windows
MacOS
Linux

에픽 게임스는 다른 전문화된 코드 드롭과 마찬가지로 언리얼 엔진 4의 QA-승인 빌드를 만들어서 외부적으로 접근 가능한 퍼포스 디포를 통해 라이선시에게 제공합니다. 이는 라이선시가 처음 엔진을 받을 때는 물론 업데이트할 때도 라이선시에게 적합하다 여겨지는 방법입니다. 여기서는 에픽의 언리얼 엔진 4 디포에 연결하여 엔진 빌드 동기화를 위한 로컬 퍼포스 셋업 방법을 단계별로 알아보겠습니다.

퍼포스에 연결하기 위해서는 먼저 에픽 게임스로 보안 VPN (가상 사설 네트워크) 연결을 셋업해야 합니다. VPN 연결 셋업 및 실행법에 대한 상세 정보는 에픽 게임스 VPN 연결 구성 문서를 참고해 주시기 바랍니다.

에픽 게임스는 퍼포스와 커스텀 라이선싱 계약을 체결했습니다. 이 계약을 준수하기 위해서는 라이선스당 한 기계에서만 풀 빌드로 동기화해야 하나, 소스 메타데이터 열람이나 지난 리비전 확인 목적으로는 같은 로그인 이름으로 여러 사용자가 접속을 할 수도 있습니다. 개별 UDN 로그인 정보는 되지 않습니다.

몇몇 경우 큰 조직에서는 팀 별로 계정이 있을 수 있는데, 그렇다 하더라도 팀 마다 한 기계에서만 풀 빌드를 동기화시켜야 합니다. 여러 대의 기계에서 풀 빌드를 동기화시키는 것은 퍼포스 라이선스 계약 위반이며, 에픽에도 마찬가지입니다.

에픽의 퍼포스 디포에서 언리얼 엔진 4 빌드나 리비전을 내려받는 전체 과정에 대한 자세한 내용은 퍼포스로 언리얼 엔진 내려받기 문서를 참고하시기 바랍니다.

저희 퍼포스 서버의 원활한 운영을 위해, 일정 기간 활동이 없는 계정에 대한 비활성화 및 삭제 정책을 두고 있습니다.

  • 6 개월동안 사용되지 않은 퍼포스 계정은 비활성화 됩니다.

  • 1 년 동안 접근되지 않은 퍼포스 계정은 삭제됩니다.

이 두 가지 조치 모두 쉽게 되돌릴 수 있으니, 나중에 언제라도 자신의 계정이 비활성화 내지 삭제된 것을 아시게 된 경우 P4AccountTrouble 로 메일 주시면 복원시켜 드리겠습니다. 다른 질문이 있으신 경우 주저없이 UDN 에 올려 주시기 바랍니다.

연결성(Connectivity) 정책

에픽으로의 VPN 연결성은 두 가지 방법 중 하나입니다. 첫째 방법은 스튜디오에 다섯개까지 내부 워크스테이션에서 에픽 프록시 서버로의 직접 VPN 연결을 허용하는 방법입니다 (단 풀 빌드 싱크는 한 기계에만 허용됩니다). 둘째 방법은 스튜디오가 자체 프록시를 직접 에픽의 디포에 연결하도록 하여, 스튜디오의 개발자는 자체 로컬 프록시에 연결하는 것입니다. 이 로컬 프록시에서 디포로는 1차적인 것과 백업, 동시에 두 개의 VPN 연결이 허용됩니다.

이 방법은 서로 독립적이라, 한 스튜디오가 두 연결 형식을 동시에 사용할 수는 없음을 이해해 주시기 바랍니다. 어느 경우든 한 기계의 동시 P4 연결 수는 제한되지 않으며, 스튜디오에서의 VPN 연결 수만 제한되는 것입니다.

설치 및 환경설정

에픽의 퍼포스 디포에 연결하기 위해서는, 엔진 빌드를 내려받고 저장하는 데 사용되는 기계에 퍼포스 클라이언트를 설치해야 합니다.

P4V 셋업하기

P4V 클라이언트는 현재 퍼포스가 제공하는 클라이언트입니다. 그래픽 인터페이스를 통한 버전 파일에 접근할 수 있도록 해 주고, 코드 진화를 병합 및 시각화하기 위한 도구 역시도 포함됩니다.

P4VUpdated.png

전체 P4V 인스톨러는 Perforce Downloads: The Essentials 페이지에서 내려받을 수 있습니다.

주: 운영체제에 해당하는 32- 또는 64- 비트 버전인지를 확인하시기 바랍니다.

에픽의 퍼포스 디포에 연결하기 위한 P4V 클라이언트 셋업법 안내서는, 언리얼 엔진 4용 P4V 셋업하기 문서를 참고하시기 바랍니다.

부가 다운로드

플러그인이나 기타 툴 등 추가로 내려받을 수 있는 다운로드 전체 목록은 http://www.perforce.com/perforce/downloads/platform.html 문서를 참고하시기 바랍니다.

로컬 퍼포스 프록시

자체 로컬 프록시를 운영하려할 경우입니다. 다음 정보는 퍼포스에 5대 이상의 기계가 연결되도록 하고 싶은 경우에 한합니다.

로컬 프록시의 장점은:

  • 싱크가 실패하면 프록시에 싱크된 사본이 유지됩니다. 싱크를 재시작해도 에픽이 아닌 로컬 프록시에서 데이터를 끌어옵니다.

  • 다수의 사용자에 데이터 접근 속도가 더 빠릅니다.

프록시 환경설정을 사용하기 위해서는 먼저 UDN 에 요청을 하셔야 합니다. 이 권한이 허용되면, 두 개의 VPN 연결과 하나의 주요 디포 액세스 권한을 받으며, 라이선시 프록시로의 액세스는 잃게 됩니다.

퍼포스 http://perforce.com/perforce/downloads/ 에서 프록시 어플리케이션 (P4P) 을 구할 수 있습니다. 설치 도중 프록시 서버를 p4-server.epicgames.net 으로 체이닝하기 위해 환경설정해 줘야 합니다.

프록시 셋업법 안내서는 다음 문서를 참고하십시오: http://www.perforce.com/perforce/r10.1/manuals/p4sag/09_p4p.html#1056059

원격 디포

자세한 정보는 다음 스레드를 참고해 주십시오:

https://udn.epicgames.com/lists/showpost.php?list=unedit3&id=5885

원격 디포를 통해 귀하의 위치에다 자동으로 저희 서버와 동기화되는 퍼포스 서버를 셋업할 수 있습니다. 장점은 귀사 내부에 엔진 코드를 쉽게 배포할 수 있다는 것입니다. 단점은 파일이 원격 디포로만 동기화되기에, 원격 디포의 사용자는 저희의 변경 번호, 변경목록 정보, 라벨 등을 확인할 수 없다는 점입니다.

원격 디포 셋업을 위해서는 UDN 으로 요청해 주시기 바랍니다.

캐릭터 인코딩

퍼포스에 텍스트를 유니코드 파일로 저장하면, 로컬 라인 끝에 일치시키기 위해 0xd 를 추가하기에, 0x0a 0x00 0x0d 0x00 로 끝나는 유니코드 라인 끝은 0x0a 0x0d 0x00 0x0d 0x00 로 변환되어 너무 깨지게 됩니다. 그러나 이 작업을 할 때, 로컬 버전은 변경하지 않은 (그리고 작동하는) 상태로 놔둡니다. 이전 버전으로 동기화한 다음 다시 헤드로 싱크하면 문제를 확인할 수 있습니다.

퍼포스는 UTF-8 을 유니코드로 정의합니다. 아무도 실수로 ASCII 전환하지만 않는다면 UTF-16 이 이상적입니다. Binary 역시 머징이나 다중 체크아웃을 피하기만 한다면 괜찮습니다.

UnrealEngine3 는 사용가능한 파일이라 할 때, ASCII 또는 UTF-16 with BOM 을 로드합니다.

동아시아 퍼포스 미러

VPN 연결 셋업하기 를 완료하고서 동아시아 VPN 미러 에 연결하면, 프록시에 연결할 수 있습니다. p4-licensee-proxy-asia.epicgames.net 에 포트 1667 로 연결하기만 하면 됩니다. US 프록시(p4-licensee-proxy.epicgames.net:1667)도 이 연결을 통해 사용할 수는 있지만, 아시아 프록시가 안될 때만 사용하는 것이 좋습니다.

프록시를 사용하여 일차 디포 서버(p4-server.epicgames.net:1666)에 연결하는 경우, 프록시 서버 상에서 압축을 꺼 두어야 합니다. 다운로드 위치 사이에 WAN 옵티마이저를 두어 프록시를 사용하는 라이선시께 더 나은 성능을 제공해 드릴 수 있습니다. 압축은 데이터 감소 효율성을 떨어뜨려 낮은 성능으로 이어질 수 있습니다.

압축 끄기에 대한 정보는 이 페이지 에서 P4P 플래그 관련된 부분을 살펴보시기 바랍니다. 퍼포스를 Windows 서버 상의 서비스로 실행중인 경우, 압축을 끄는 명령은 다음과 같습니다:

p4 set -S "Perforce Proxy" P4POPTIONS="-c -p 1667 -t p4-server.epicgames.net:1666"

"-c" 가 바로 압축을 끄는 옵션입니다.

유지 및 지원

프록시 관리

프록시 디포가 리비전으로 넘처나는 것을 방지하여 프록시 디포를 깨끗이 유지시켜 주는 스크립트입니다:

저희 프록시에도 사용하고 있는 것입니다. 일정 기간동안 이용되지 않은 파일들을 제거하여 보기좋고 깔끔하게 유지시켜 주는 VBScript입니다. 이를 Windows의 at job 또는 예정된 태스크로서 설정하는 것이 가장 좋습니다. 반드시 파일 시스템에서 이 위치에 적합한 권한을 가진 사용자로서 실행하도록 하십시오.

이 스크립트는 아래와 같이 호출 가능합니다:

cscript StartCleaning.vbs [인수]

Windows에서만 작동합니다. 또한 Windows 서버 2008 R2, Windows 비스타, Windows 7 에서 실행하는 경우, 최근 접근일 (last access date)이 디폴트로 꺼져 있습니다. 최근 접근일을 다시 켜려면 "fsutil behavior set disablelastaccess 0" 를 해 줘야 합니다.

정기 점검 시간

에픽의 퍼포스 서버는 매주 일요일 오후 4시(EST 새벽 2시)부터 4 시간동안 체크포인트 인증 및 데이터베이스 백업을 위한, 매달 둘째 넷째 일요일 오후 10시(일광절약시간제 적용시 9시) 부터 4 시간동안 퍼포먼스 관리를 위한 정기 점검 시간을 갖습니다. 이 기간 도중엔 지원 창구, 특히 네트워크/서버 리소스 일부 또는 전부가 영향을 받을 수 있다는 점 유념해 주시기 바랍니다.

연결 문제

어떤 이유로 퍼포스 디포에 접속되지 않습니까? UDN 에 올려 주시기 바랍니다.

Select Skin
Light
Dark

Welcome to the new Unreal Engine 4 Documentation site!

We're working on lots of new features including a feedback system so you can tell us how we are doing. It's not quite ready for use in the wild yet, so head over to the Documentation Feedback forum to tell us about this page or call out any issues you are encountering in the meantime.

We'll be sure to let you know when the new system is up and running.

Post Feedback