Helix SwarmHelix Swarm
Loading...

INSTALL.txt

  • //
  • guest/
  • thomas_gray/
  • jambox/
  • main/
  • swarm/
  • readme/
  • ko/
  • INSTALL.txt #1
  • View
  • Commits
  • Open Download .zip Download (30 KB) 
  1. 				Perforce Swarm
  2. 					버전 2015.1
  3.  
  4. 					설치 안내서
  5.  
  6. 소개
  7.  
  8. 	이 문서는 Perforce Swarm(이후 "Swarm"으로 명시) 릴리스 2014.4.의 설치 및 
  9. 초기 구성 	프로세스에 대해 	설명합니다. 다양한 OS 배포판에 따라 동일한 결과에 
  10. 이르는 방식이 	서로 다를 수 있습니다. 따라서 당사는 최선의 설명을 제공하기 위해 
  11. 노력하지만, 	사용자가 특정 배포판 설명서를 참조해야 하는 경우도 있습니다.
  12.  
  13. 	* Swarm의 설치 및 구성에는 시스템	관리자 기능이 필요하며 많은 경우 루트 
  14. 권한 액세스를 필요로 합니다.
  15.  
  16. 개요
  17.  
  18. 	Swarm 웹 응용프로그램의 설치 및 구성을 위해 이 	문서가 다루는 주요 영역은 
  19. 다음과 같습니다.
  20.  
  21. 	* 런타임 종속성
  22. 	* Swarm 설치
  23. 	* 사용자 환경에 맞는 Swarm 구성
  24. 	* 트리거 토큰 설정
  25. 	* Swarm에 맞는 Perforce 구성
  26. 	* 워커 생성을 위한 반복 작업 설정
  27.  
  28.  
  29. ------------------------------------------------------------------------
  30. 런타임 종속성
  31. ------------------------------------------------------------------------
  32.  
  33. Swarm은 다음과 같은 런타임 종속성을 필요로 합니다.
  34.  
  35. 	* 지원되는 운영 체제 플랫폼
  36.  
  37. 	* mod_rewrite 및 mod_php5 모듈이 포함된 Apache 웹 서버
  38.  
  39. 	* 다음 확장이 포함된 PHP:
  40. 		* iconv
  41. 		* json
  42. 		* session
  43. 		* P4PHP
  44. 		* APC(최적 성능용)
  45. 		* imagick(선택 사항, 비 웹 안전 이미지 보기용)
  46. 		* Zip(선택 사항, 파일/폴더 아카이브 다운로드용)
  47.  
  48. 	* LibreOffice(선택 사항, 오피스 유형 문서 보기용)
  49.  
  50. 	* zip 명령줄 도구(선택 사항, Zip 확장이 설치되어 있지 않은 경우 	파일/폴더 
  51. 아카이브 다운로드용)
  52.  
  53. 	* 연결을 위한 지원되는 Perforce 서비스 및 기능
  54.  
  55. 	참고: "Perforce 서비스"란 Perforce 서버, 프록시, 	브로커, 레플리카, 에지 
  56. 서버, 커밋 서버 또는 클러스터/노드를 지칭합니다.
  57. 		이는 "서비스" 사용자를 지칭하지 않습니다. 서비스 사용자는 Perforce 
  58. 서비스 내 			복제 코디네이션에 사용됩니다.
  59.  
  60. 지원하는 운영 체제 플랫폼
  61.  
  62. 	Swarm은 이진 버전 P4PHP(PHP용 퍼포스 확장)를 포함하므로 다음 운영 체제에서 
  63. 지원됩니다.
  64.  
  65. 	* Linux 2.6+ Intel(x86, x86_64), gblic 2.3.3+ 사용
  66.  
  67. 	* Mac OS X 10.6+(x86_64)
  68.  
  69. 	직접 P4PHP를 구축하거나 기타 런타임 의존성이 충족되는 경우에는 다른 
  70. 플랫폼에서도 Swarm을 실행할 수 있습니다. 소스에서 P4PHP를 불러와 빌드하는 방법은 
  71. 다음을 참조하십시오.
  72.  
  73. 	http://www.perforce.com/perforce/doc.current/user/p4phpnotes.txt
  74.  
  75. Apache 웹 서버
  76.  
  77. 	Swarm을 작동하려면 Apache HTTP 서버 2.2 이상이 필요합니다.
  78.  
  79. 	http://httpd.apache.org/
  80.  
  81. 	Swarm은 또한 다음 Apache 모듈을 필요로 합니다.
  82.  
  83. 	* PHP와 상호 작용을 위한 mod_php5
  84. 	일반적으로 PHP와 함께 설치됩니다.
  85.  
  86. 	* mod_rewrite URL 재작성 엔진
  87. 	http://httpd.apache.org/docs/2.2/mod/mod_rewrite.html
  88.  
  89. PHP
  90.  
  91. 	Swarm은 PHP 5.3.3+, 5.4.x 또는 5.5.x에서 지원됩니다:
  92.  
  93. 	http://www.php.net
  94.  
  95. 	Swarm은 다음과 같은 PHP 확장을 필요로 합니다.
  96.  
  97. 	* iconv(문자 인코딩 변환기)
  98. 	http://php.net/iconv
  99. 	대부분의 PHP 배포판에서 일반적으로 활성화됩니다.
  100.  
  101. 	* JSON(JavaScript 개체 노테이션)
  102. 	http://php.net/json
  103. 	대부분의 PHP 배포판에서 일반적으로 활성화되지만 	최근 배포판에서는 선택 
  104. 사항으로 처리되기도 합니다.
  105.  
  106. 	* Session(세션 처리)
  107. 	http://php.net/session
  108. 	대부분의 PHP 배포판에서 일반적으로 활성화됩니다.
  109.  
  110. 	* P4PHP(Perforce PHP 확장)
  111. 	Swarm 패키지에 포함되어 있으며 설치 방법은 아래를 참조하십시오. 
  112.  
  113. 	Swarm은 다음과 같은 PHP 확장과 함께 사용하면 매우 큰 이점을 가지게 됩니다.
  114.  
  115. 	* APC(대체 PHP 캐시)
  116. 	http://php.net/apc
  117. 	APC 설치 지침은 아래를 참조하십시오.
  118.  
  119. 	* Imagick(ImageMagick을 PHP에 통합)
  120. 	http://php.net/imagick
  121. 	Imagick 설치 지침은 아래를 참조하십시오.
  122.  
  123. Perforce 서버 요구 사항
  124.  
  125. 	* Swarm은 다음 패치 수준 이상의 Perforce 서버 버전과 	연동합니다.
  126.  
  127. 		* 2010.2/503309 
  128. 		* 2011.1/506384
  129. 		* 2012.1/512349
  130. 		* 2012.2/525804
  131. 		* 2013.1/610569
  132. 		* 2013.2/708877
  133. 		* 2013.3/740675
  134. 		* 2014.1/807760
  135.  
  136. 	* Swarm은 Perforce 2013.1 이상에서 최고의 성능을 발휘합니다.
  137. 	http://www.perforce.com
  138.  
  139. 	이후 단계에서 Perforce 서비스에 설치되는 Swarm 트리거의 요구 	사항은 
  140. 다음과 같습니다.
  141.  
  142. 	* Linux 호스트에 설치된 Perforce 서비스의 경우 다음 중 하나가 필요:
  143.  
  144. 	* curl
  145. 	http://curl.haxx.se/download.html
  146. 	* wget
  147. 	http://ftp.gnu.org/gnu/wget/
  148.  
  149. 	* Windows 호스트에 설치된 Perforce 서비스의 경우 다음 중 하나가 필요:
  150.  
  151. 	* curl
  152. 	http://curl.haxx.se/download.html
  153.  
  154. SELinux(Security-Enhanced Linux)
  155.  
  156. 	* Swarm은 현재 SELinux*를 *지원하지 않습니다. 향후 릴리스에서 	SELinux를 
  157. 지원하고 필요한 구성에 대한 지침을 제공하게 되기를 	바랍니다.
  158.  
  159. 	* 본 버전의 Swarm은 '시행 모드'의 기본 구성을 	사용하는 경우 SELinux와 
  160. *연동되지 않습니다*. SELinux 시스템을 	실행 중인 경우 다음 명령을 통해 'Permissive 
  161. 모드'로 설정하면 Swarm이 	작동하지 않을 수 있습니다.
  162.  
  163. 		$ sudo setenforce 0
  164.  
  165. 	시스템을 'Permissive 모드'로 설정하면 댄 월시(Dan Walsh)를 슬프게 할 수 
  166. 있습니다.
  167. 	https://plus.google.com/112917221531140868607/posts/ZiqZVXAjrev
  168.  
  169. ------------------------------------------------------------------------
  170. Swarm 패키지 설치
  171. ------------------------------------------------------------------------
  172.  
  173. Swarm은 두 가지 배포 형식으로 사용할 수 있습니다. Debian(.deb) 및 RPM
  174. (.rpm)
  175.  
  176. 패키지 관리 도구가 각 패키지의 종속성을 파악하기 때문에 배포 패키지를 사용하면 
  177. 소프트웨어의 설치, 업데이트 및 제거를 매우 간소화할 수 있습니다.
  178.  
  179. 참고: Swarm 패키지는 Ubuntu 12.04 LTS, Ubuntu 14.04 LTS(Debian 패키지의 경우) 및 
  180. CentOS 6.1+(RPM 패키지)에 대해 철저한 테스트를 거쳤습니다. 각 패키지는 다른 호환 
  181. 배포판에서도 작동이 가능하지만 이는 아직 테스트된 바 없습니다.
  182.  
  183. 1. Perforce 패키지 리포지토리를 구성합니다.
  184.  
  185. 	루트 권한으로 다음 중 하나를 실행합니다.
  186.  
  187. 	a. Debian의 경우:
  188.  
  189. 	다음 컨텐츠로 '/etc/apt/sources.list.d/perforce.list' 	파일을 생성합니다.
  190.  
  191. 	deb http://package.perforce.com/apt/ubuntu/ precise release
  192.  
  193. 	이는 Debian 및 Ubuntu 시스템에서 작동합니다.
  194.  
  195. 	b. RPM의 경우:
  196.  
  197. 	다음 컨텐츠로 '/etc/yum.repos.d/perforce-swarm.repo' 	파일을 생성합니다.
  198.  
  199. 		[Perforce]
  200. 		name=Perforce
  201. 		baseurl=http://package.perforce.com/yum/rhel/6/x86_64/
  202. 		enabled=1
  203. 		gpgcheck=1
  204.  
  205. 	이는 RedHat 및 CentOS 모두에 적용됩니다.
  206.  
  207. 2. Perforce 패키지 서명 키를 가져옵니다.
  208.  
  209. 	다음 중 한 가지를 실행합니다:
  210.  
  211. 	a. Debian의 경우:
  212.  
  213. 		$ wget -qO - http://package.perforce.com/perforce.pubkey | sudo 
  214. apt-key add -
  215. 		$ sudo apt-get update
  216.  
  217. 	b. RPM의 경우(루트 권한으로 실행):
  218.  
  219. 		# rpm --import http://package.perforce.com/perforce.pubkey
  220.  
  221. 	서명 키의 승인 여부 확인에 대한 자세한 정보는 다음을 참조하십시오.
  222.    
  223. 	http://answers.perforce.com/articles/KB_Article/Public-Key-for-
  224. Installation-Packages
  225.  
  226. 3. 주요 Swarm 패키지를 설치합니다.
  227.  
  228. 	두 가지 패키지 파일을 선택할 수 있습니다.
  229.  
  230. 	다음 중 한 가지를 실행합니다:
  231.  
  232. 	i.  Debian의 경우:
  233.  
  234. 		$ sudo apt-get install perforce-swarm
  235.  
  236. 	ii. RPM의 경우(루트 권한으로 실행):
  237.  
  238. 		# yum install perforce-swarm
  239.  
  240. 4. Swarm 트리거 패키지를 설치합니다.
  241.  
  242. 	이 패키지를 Perforce 서비스 호스팅 서버에 설치합니다. 	해당 서버는 Swarm 
  243. 호스팅 서버와 동일한 서버이거나 또는 네트워크 상의 다른	서버일 수 있습니다.
  244.  
  245. 	중요: Perforce 서비스 호스팅 서버가 		패키지를 사용할 수 없는 경우(예: 
  246. 서버에서 Widnows 실행 중), 	'/opt/perforce/swarm/p4-bin/scripts'에서 
  247. 	Perforce 서비스 호스팅 서버로 적절한 Swarm 트리거 스크립트를 	복사해야 
  248. 합니다. Linux 시스템용은 'swarm-trigger.sh'입니다. 	Windows 시스템용은 
  249. 'swarm-trigger.vbs'입니다. 복사한 후 	트리거 스크립트를 구성해야 합니다. 자세한 
  250. 정보는 	아래 "Swarm용 Perforce 구성" 절을 참조하십시오.
  251.  
  252. 	다음 중 한 가지를 실행합니다:
  253.  
  254. 	i.  Debian의 경우:
  255.  
  256. 		$ sudo apt-get install perforce-swarm-triggers
  257.  
  258. 	ii. RPM의 경우(루트 권한으로 실행):
  259.  
  260. 		# yum install perforce-swarm-triggers
  261.  
  262. 5. Swarm 옵션 패키지를 설치합니다.
  263.  
  264. 	반드시 필요하지는 않지만 이 패키지는	 Imagick 및 LibreOffice Swarm 모듈 
  265. 사용에 필요한 종속성을 	설치합니다. 이러한 모듈은 다양한 이미지 및 오피스 문서의 
  266. 	미리보기를 제공합니다.
  267.  
  268. 	다음 중 한 가지를 실행합니다:
  269.  
  270. 	i.  Debian의 경우:
  271.  
  272. 		$ sudo apt-get install perforce-swarm-optional
  273.  
  274. 	ii. RPM의 경우(루트 권한으로 실행):
  275.  
  276. 		# yum install perforce-swarm-optional
  277.  
  278. 	중요: 이 패키지는 EPEL 프로젝트의 "php-pecl-imagick" 		패키지의 
  279. 영향을 받습니다. EPEL에서 			패키지를 설치하려면 			EPEL 
  280. 리포지토리를 추가하고 서명 키를 허용해야 합니다. 관련 지침은 			 
  281. https://fedoraproject.org/wiki/EPEL에서 참조하실 수 있습니다.
  282.  
  283. 6. 다음 사전 설치 단계를 완료합니다.
  284.  
  285. 	*perforce-swarm* 패키지가 설치되면 추가 구성이	필요합니다.
  286.  
  287. 	1. Swarm 구성 스크립트를 사용하여 Swarm을 설정합니다.
  288.  
  289. 	참고: Swarm 구성 스크립트에는 몇 가지 사용 방식이 		있습니다. 아래의 
  290. 단계는 대화형 설치를 통한 			가장 간편한 구성에 대한 요약이지만 루트 권한을 
  291. 사용하면 실행 중에 			옵션을 검토할 수 있습니다.
  292.  
  293. 			$ /opt/perforce/swarm/sbin/configure-swarm.sh -h
  294.  
  295. 	루트 권한으로 대화형 설치 실행:
  296.  
  297. 		$ /opt/perforce/swarm/sbin/configure-swarm.sh -i
  298.  
  299. 	2. 구성 스크립트에 정보를 입력합니다.
  300.  
  301. 	a. P4PORT의 값을 지정합니다.
  302.  
  303. 		Perforce 서비스의 호스트 이름 및 포트를 지정합니다. 정의된 		경우 
  304. P4PORT 값은 기본값으로 사용됩니다. 구성 		스크립트가 자신의 연결 가능 
  305. 여부를 확인합니다.
  306.  
  307. 	b. Perforce 서비스에서 		관리자 수준 권한으로 일반 사용자의 사용자 ID 
  308. 및 암호를 지정합니다.
  309.  
  310. 		기본 사용자 ID는 'swarm'입니다.
  311.  
  312. 		안내에 따라 사용자 ID에 따른 로그인 티켓 또는 암호를 		입력합니다.
  313.  
  314.  	참고: 로그인 티켓은 다음을 실행하여 얻을 수 있습니다(다른 셸에서).
  315.  
  316. 		$ p4 -p myp4host:1666 -u userid login -p
  317.  
  318. 		입력한 로그인 티켓의 만료일이 		1년 이내인 경우 경고가 
  319. 표시됩니다.
  320.  
  321.  	c. Swarm UI의 호스트 이름을 지정합니다.
  322.  
  323. 		기본값은 현재 호스트 이름입니다. 구성 스크립트는 호스트 	
  324. 	이름의 실제 작동 여부를 확인하지 않습니다.
  325.  
  326. 	d. 메일 릴레이 호스트를 지정합니다.
  327.  
  328. 	참고: 구성 스크립트는 입력한 메일 릴레이 호스트가 실제로 		SMTP 연결을 
  329. 허용하는지 확인하지 않습니다.
  330.  
  331. 	이 정보가 입력되면 구성 스크립트는 다음 작업을 수행합니다.
  332.  
  333. 	- P4PHP 구성
  334. 	- 워커 작업의 상시 실행 보장을 위한 크론 잡 생성
  335. 	- Swarm 'data/config.php' 구성 파일 생성
  336. 	- Swarm용 Apache 가상 호스트 생성
  337. 	- Apache 다시 시작
  338.  
  339. 	3. Swarm 트리거를 구성합니다.
  340.  
  341. 	자세한 정보는 아래 "Swarm용 Perforce 구성" 절을 	참조하십시오.
  342.  
  343. 모두 완료되었습니다.
  344.  
  345. ------------------------------------------------------------------------
  346. Swarm OVA 설치
  347. ------------------------------------------------------------------------
  348.  
  349. Swarm은 최소한의 구성을 필요로 하는 OVA(Open Virtualization Appliance)로
  350. 설치할 수 있습니다.
  351.  
  352. 다음이 필요한 경우 OVA를 사용할 수 있습니다.
  353.  
  354. 	* 설치 및 구성 단계 간소화
  355. 	* 추가 하드웨어 없이 Swarm 실험
  356. 	* Linux 기반 서버 없이 Swarm 설치
  357.  
  358. OVA를 사용하려면 아래 지침에 따른 후
  359. "트리커 토큰 설정" 절로 건너 뜁니다.
  360.  
  361. 	1. Swarm OVA를 다운로드합니다.
  362.  
  363. 	2. OVA를 사용자의 가상화 환경으로 가져옵니다.
  364.  
  365. 	3. 가상 컴퓨터를 시작합니다. 진단 및 부트 정보가 나타납니다.
  366.  
  367. 	4. 여러 구성 프롬프트가 순차적으로 표시됩니다.
  368.  
  369. 		a. 루트 사용자 암호
  370. 		b. 시스템 *swarm* 사용자 암호
  371. 		c. 가상 컴퓨터 호스트 이름
  372.  		d. 메일 릴레이 호스트
  373. 		e. Perforce 서비스 포트
  374. 		f. *admin* 권한을 가진 Perforce 서비스의 일반 사용자 		
  375. 		사용자 ID
  376. 		g. *admin-level* Perforce 사용자의 티켓 또는 암호
  377.  
  378. 	프롬프트가 성공적으로 답변되면 가상 	컴퓨터는 구성 작업을 완료합니다. 모든 
  379. 작업이 완료되면 	시작 화면이 표시됩니다.
  380.  
  381. 	시작 화면에서 Swarm, 문서 및 가상 컴퓨터 관리 콘솔에 	액세스하는 URL을 
  382. 제공합니다.
  383.  
  384. 이제 OVA를 통해 Swarm에 액세스할 수 있습니다.
  385.  
  386. 참고:
  387.  
  388. 	OVA가 구성되고 실행되면 SSH를 이용하여 시스템 	*swarm* 사용자로 가상 컴퓨터에 
  389. 연결하고 	다음 Swarm config.php 파일을 수정하여 구성을 조정할 수 있습니다.
  390.  
  391. 		/opt/swarm/data/config.php
  392.  
  393. 	Swarm 설치 폴더는 /opt/swarm입니다.
  394.  
  395. 더 아래 쪽의 "트리거 토큰 설정" 절로 진행합니다.
  396.  
  397.  
  398. ------------------------------------------------------------------------
  399. Swarm 설치
  400. ------------------------------------------------------------------------
  401.  
  402. 높은 수준에서 Swarm은 다음을 수행하여 설치됩니다.
  403.  
  404. 	* Swarm Tarball을 적절한 디렉토리에 확장
  405.  
  406. 	* Apache가 Swarm 'data' 폴더에 쓰기 가능한지 확인
  407.  
  408. 	* PHP용 iconv, json, session, P4PHP 및 APC 	확장 설치 및 활성화
  409.  
  410. 	* Swarm 'public' 폴더를 포인팅하는 Apache 가상 호스트 생성
  411.  
  412. 단계별 설치 지침
  413.  
  414. 	1. Swarm 패키지("압축 Tarball")를 확장합니다.
  415.  
  416. 		* 다양한 그래픽 파일 관리 응용프로그램(Linux의 Nautilus, 	Mac의 
  417. Finder 등)에서 Swarm 	Tarball 패키지를 두 번 클릭하면 자동으로 패키지가 
  418. 확장됩니다.
  419.  
  420. 		* 명령줄에서 tar 명령으로 확장합니다.
  421.  
  422. 		$ tar -zxf swarm.tgz
  423.  
  424. 		* Swarm 패키지의 컨텐츠가 이름이 "swarm-<version>"인 상위 	수준 
  425. 폴더로 확장되며 여기서 <version>은 	다운로드된 버전을 나타냅니다.
  426.  
  427. 	2. Swarm 패키지의 컨텐츠를 올바른 위치로 이동합니다.
  428.  
  429. 	* Swarm 파일의 위치를 확인합니다. 이는 Apache에서 	구성된 가상 호스트와 
  430. 일치해야 	합니다(아래의 Apache 구성 및 설치 절 참조).
  431.  
  432. 		$ mv /path/to/swarm-<version> /path/to/vhosts/swarm
  433.  
  434. 	3. Swarm 파일에 대해 올바른 소유권과 권한을 할당합니다.
  435.  
  436. 	* Swarm 배포판의 상위 수준 폴더 'data'에 대해 	웹 서버가 쓰기 가능해야 
  437. 합니다. 이를 적용하려면 데이터 폴더의 	소유권을 웹 사용자로 변경하면 됩니다.
  438.  
  439. 		$ sudo chown -R www /path/to/vhosts/swarm/data
  440.  
  441. 	* 위에서 'www' 사용자는 웹 서버 사용자 이름의 	한 예입니다. 사용자의 
  442. 배포판에 따라 이는 	'_www', 'web', 'nobody' 또는 기타 다양한 이름이 될 수 있습니다.
  443.  
  444. 	보안 관점에서, Swarm 배포판과 웹 서버가 충돌하는 경우 	사용자/그룹에 
  445. 최소한의 파일 권한만 	부여하는 것이 좋습니다.
  446.  
  447.  
  448. 	Apache 구성 및 설정
  449.  
  450. 	* Apache HTTP 서버(Apache) 구성은 OS 배포판에 따라 	다를 수 있습니다. 
  451. 자신의 Apache 설치에 맞는 	문서를 참조하십시오.
  452.  
  453. 	* 예를 들어 Mac OS X에서는 시스템 환경 설정의 공유 제어에서 	웹 공유를 
  454. 활성화해야 할 수 있습니다.
  455.  
  456. 	4. 설치에 맞는 Apache 가상 호스트("vhost")를 설정합니다.
  457.  
  458. 	* 자세한 정보는 Apache 전체 설명서를 참조하십시오.
  459.  
  460. 		http://httpd.apache.org/docs/2.2/vhosts/
  461. 		http://httpd.apache.org/docs/2.4/vhosts/
  462.  
  463. 	* Apache 2.2용 가상 호스트 구성 예:
  464.  
  465. 		<VirtualHost *:80>
  466. 			ServerName myswarm
  467. 			ServerAlias myswarm.machine.domain.com
  468. 			ErrorLog "/path/to/apache/logs/myswarm.error_log"
  469. 			CustomLog "/path/to/apache/logs/myswarm.access_log" common
  470. 			DocumentRoot "/path/to/vhosts/swarm/public"
  471. 			<Directory "/path/to/vhosts/swarm/public">
  472. 				AllowOverride All
  473. 				Order allow,deny
  474. 				Allow from all
  475. 			</Directory>
  476. 		</VirtualHost>
  477.  
  478. 	* Apache 2.4용 가상 호스트 구성 예:
  479.  
  480. 		<VirtualHost *:80>
  481. 			ServerName myswarm
  482. 			ServerAlias myswarm.machine.domain.com
  483. 			ErrorLog "/path/to/apache/logs/myswarm.error_log"
  484. 			CustomLog "/path/to/apache/logs/myswarm.access_log" common
  485. 			DocumentRoot "/path/to/vhosts/swarm/public"
  486. 			<Directory "/path/to/vhosts/swarm/public">
  487. 				AllowOverride All
  488. 				Require all granted
  489. 			</Directory>
  490. 		</VirtualHost>
  491.  
  492. 	* DocumentRoot 및 Directory 값이 위 2단계에서 배치한 	Swarm 배포판의 
  493. "public" 폴더에 	대응하는지 확인하십시오.
  494.  
  495. 	5. 올바른 Apache 모듈이 활성화되었는지 확인합니다.
  496.  
  497. 	* PHP 및 Rewrite 모듈의 활성화 여부를 쿼리하기 위해 모든 활성 모듈 목록을 
  498. 	표시하도록 'apachectl' 유틸리티를 사용할 수 있습니다(사용자 	시스템에서는 
  499. 'apache2ctl'이라는 이름으로 표시될 수 있음).
  500.  
  501. 		$ apachectl -t -D DUMP_MODULES
  502.  
  503. 	* 결과에서 'php5_module' 및 'rewrite_module'을 	찾습니다. 해당 모듈이 
  504. 보이면 6단계로 건너 뜁니다.
  505.  
  506. 	사용자의 배포에 'a2enmod' Apache 유틸리티가 포함되어 있는 경우, 	이를 
  507. 이용하여 PHP 및 Rewrite 모듈을 활성화합니다.
  508.  
  509. 		$ sudo a2enmod php5 rewrite
  510.  
  511. 	* 'a2enmod' 유틸리티를 사용하지 않고 Apache 구성 파일을 직접 	편집합니다. 
  512. 모듈에 대한 Apache 구성 파일을 찾아 주석을 	해제하거나 다음 줄을 추가합니다.
  513.  
  514. 		LoadModule  php5_module     libexec/apache2/libphp5.so
  515. 		LoadModule  rewrite_module  libexec/apache2/mod_rewrite.so
  516.  
  517. 	* 참고로 사용자의 Apache 설치에 따라 모듈(.so 파일)의 	위치는 다를 수 
  518. 있습니다.
  519.  
  520. 	6. 웹 서버를 다시 시작합니다.
  521.  
  522. 	* 활성화한 Apache 구성 변경 사항이 적용되도록 	웹 서버를 다시 
  523. 시작합니다.
  524.  
  525. 		$ sudo apachectl restart
  526.  
  527. 	* Apache 활성 가상 호스트 및 모듈을 쿼리하여 변경 사항이 	적용되었는지 
  528. 확인합니다.
  529.  
  530. 		$ apachectl -t -D DUMP_VHOSTS
  531. 		$ apachectl -t -D DUMP_MODULES
  532.  
  533.  
  534. 	PHP 구성:
  535.  
  536. 	* PHP는 OS 배포판에 따라 다양하며 PHP 설치에 	대한 해당 문서를 참조하십시오.
  537.  
  538. 	7. 먼저 PHP Apache 	모듈이 사용할 php.ini 파일을 결정합니다. 참고로 
  539. 명령줄에서 PHP를 호출할 때 사용되는 php.ini 파일과 	반드시 동일할 필요는 없습니다. 
  540. (명령줄에서 'php 	--ini'를 실행하면 이 정보가 표시됩니다).
  541.  
  542. 	PHP Apache 	모듈이 사용하는 php.ini가 어떤 것인지 파악하기 어렵다면, 
  543. Apache를 통해 사용할 수 있는 PHP 파일을 	다음 컨텐츠로 생성합니다.
  544.  
  545. 		<?php phpinfo();?>
  546.  
  547. 	이 파일에 브라우저를 표시하고 결과 테이블에서 해당 테이블 행을 
  548. 	검색하십시오.
  549.  
  550. 			불러온 구성 파일
  551.  
  552. 	8. 시스템에 대한 date.timezone이 정확하게 설정되어 있는지 확인합니다.
  553.  
  554. 	일부 배포판에는 PHP가 사용할 수 있는 기본 시간대가 설정되어 있지 않습니다. 
  555. 	따라서 PHP용 시간대를 명확하게 설정하는 것이 좋습니다. 지원되는 시간대 	목록:
  556.  
  557. 		http://www.php.net/manual/en/timezones.php
  558.  
  559. 	php.ini 내 date.timezone 설정 예:
  560.  
  561. 		date.timezone = America/Vancouver
  562.  
  563. 	9. iconv, json 및 세션 확장이 있는지 확인합니다.
  564.  
  565. 	* 해당 확장은 일반적으로 활성화되어 있지만, 	OS 패포판을 통해 패키지를 
  566. 설치해야 할 수도 있습니다. 위 	phpinfo 결과에서 각 이름을 검색하여 확장이 
  567. 	존재하는지 확인합니다.
  568.  
  569. 	10. PHP용 Perforce 확장 P4PHP 활성화:
  570.  
  571. 	* Swarm이 Perforce 서비스와 통신하도록 하려면 	P4PHP 확장이 필요합니다.
  572.  
  573. 	* 당사는 Linux 	플랫폼(32 및 64비트) 및 Mac OS X(Darwin)용, PHP 5.3, 
  574. 5.4, 및 5.5를 위한 다양한 P4PHP 이진 베리언트를 	제공합니다.
  575.  
  576. 	* Linux의 경우 기본 베리언트는 glibc 2.11로 컴파일되지만, 	Red Hat 
  577. Enterprise Linux 5.9. 등 이전 배포판 사용자를 지원하기 위해 	glibc 2.3.3으로 
  578. 컴파일된 PHP 5.3 베리언트도 함께 	포함되어 있습니다.
  579.  
  580. 	* P4PHP를 활성화하려면 웹 서버의 php.ini 파일을 편집하여 	다음 줄을 
  581. 추가합니다.
  582.  
  583. 		extension=/path/to/swarm/p4-bin/bin.<platform>/perforce-
  584. <variant>.so
  585.  
  586. 	예 1: PHP 5.4 실행 64비트 Linux 시스템의 경우:
  587.  
  588. 		extension=/path/to/swarm/p4-bin/bin.linux26x86_64/perforce-
  589. php54.so
  590.  
  591. 	예 2: 2.11 이전 glibc을 사용하는 PHP 5.3 실행 32비트 Linux 	시스템의 
  592. 경우:
  593.  
  594. 		extension=/path/to/swarm/p4-bin/bin.linux26x86/perforce-php53-
  595. glibc2.3.3.so
  596.  
  597. 	* 아니면 PHP 확장의 기본 위치에 	확장 파일을 복사하고 다음 줄을 추가하십시오.
  598.  
  599. 		extension=perforce-<variant>.so
  600.  
  601. 	11. Apache를 다시 시작하면 변경 사항이 적용됩니다.
  602.  
  603. 	12. P4PHP의 활성화를 확인하려면 7단계에서 생성한 phpinfo 	파일로 이동합니다. 
  604. 그런 다음 "perforce" 섹션을 확인합니다	("Perforce Module" 검색). 모듈이 
  605. 활성화되었음을 알리고 	버전 정보가 표시됩니다.
  606.  
  607.  
  608. 	PHP용 대체 PHP 캐시(APC) 확장:
  609.  
  610. 	APC는 PHP 중간 코드 캐싱 및 최적화를 위한 견고한 	무료 개방형 
  611. 프레임워크입니다. APC를 활성화하면 	Swarm의 성능이 향상됩니다. APC에 대한 자세한 
  612. 정보는 다음에서 확인할 수 있습니다.
  613.  
  614. 		http://php.net/apc
  615. 		http://pecl.php.net/package/APC
  616.  
  617. 	13. APC는 사용자의 OS 배포판을 통해 설치하는 것이 좋습니다(apt-get, yum 등을 
  618. 통해).
  619.  
  620. 	* 배포판이 PHP용 APC 패키지를 제공하지 않을 경우 	PECL을 통해 설치할 수도 
  621. 있습니다(시스템 	종속성 문제를 해결해야 할 수 있음).
  622.  
  623. 		$ sudo pecl install apc
  624.  
  625. 	14. PHP Apache 모듈의 php.ini 파일에서 APC가 활성화되었는지 확인합니다
  626. 	(P4PHP에 대한 위 절에서 지정된 대로). 다음 줄을 	php.ini에 추가해야 할 수 
  627. 있습니다.
  628.  
  629. 		extension=apc.so
  630.  
  631. 	15. Apache를 다시 시작하면 변경 사항이 적용됩니다.
  632.  
  633. 	16. APC의 활성화를 확인하려면 P4PHP에 	대한 위 절 1단계에서 생성한 phpinf 
  634. 파일로 이동합니다. 그런 다음 "apc" 	섹션을 확인합니다("APC Support"를 검색해야 
  635. 할 수 있음). 해당 	버전 정보 및 지시문 테이블이 	보고됩니다.
  636.  
  637. 	설정할 APC 지시문에 대해 현재 권장되는 	바는 없습니다.
  638.  
  639. 	** 위에서 생성한 phpinfo 파일에 대한 노트 참조 **
  640.  
  641. 	* P4PHP 및 APC의 설치 및 활성화가 완료되면 설치 정보가 노출되지 	않도록 
  642. 생성한 phpinfo 	파일을 제거하는 것이 좋습니다.
  643.  
  644.  
  645. 	PHP용 Imagemagick(imagick) 확장
  646.  
  647. 	* Imagick은 이미지의 생성 및 처리를 위한 ImageMagick 	그래픽 라이브러리 
  648. API가 통합된 PHP 확장입니다. 	Enabling Imagick을 활성화하면 웹 브라우저에서 
  649. 일반적으로 표시할 수 없는 그래픽 형식에 대한 	Swarm의 미리 보기 기능이 강화됩니다. 
  650. Imagick에 	대한 자세한 정보는 다음을 참조하십시오.
  651.  
  652. 		http://php.net/imagick
  653. 		http://pecl.php.net/package/imagick
  654.  
  655. 	17. Imagick는 사용자의 OS 배포판을 통해 설치하는 것이 좋습니다
  656. 	(apt-get, yum 등을 통해).
  657.  
  658. 	* 배포판이 PHP용 Imagick 패키지를 제공하지 않을 경우 	PECL을 통해 
  659. 설치하십시오(시스템 종속성 문제를 해결해야 	할 수 있음).
  660.  
  661. 		$ sudo pecl install imagick
  662.  
  663. 	18. PHP Apache 모듈의 	php.ini 파일에서 Imagick의 활성화 여부를 
  664. 확인합니다(P4PHP에 대한 위 절에서 지정된 대로). 다음 	줄을 php.ini에 추가해야 
  665. 할 수 있습니다.
  666.  
  667. 		extension=imagick.so
  668.  
  669. 	19. Apache를 다시 시작하면 변경 사항이 적용됩니다.
  670.  
  671. 	20. Imagick의 활성화를 확인하려면 P4PHP에 대한 위 절의 1단계에서 생성한 
  672. 	:파일:`phpinfo`파일로 	이동합니다. 그런 다음 "imagick" 섹션을 확인합니다. 
  673. 해당 버전 정보 	및 지시문, 지원되는 이미지 파일 형식 등을 	나타내는 테이블이 
  674. 보고됩니다.
  675.  
  676. 	** 위에서 생성한 phpinfo 파일에 대한 노트 참조 **
  677.  
  678. 	* P4PHP 및 Imagick의 설치 및 활성화가 완료되면 설치 정보가 노출되지 
  679. 	않도록 생성한 phpinfo 	파일을 제거하는 것이 좋습니다.
  680.  
  681.  
  682. 	LibreOffice
  683.  
  684. 	LibreOffice는 무료이면서 강력한 오픈 소스 개인 	생산성 제품군입니다. 
  685. Swarm은 이를 숨김 모드로 활용하여 	오피스 유형 문서의 미리 보기를 생성할 수 
  686. 있습니다. LibreOffice에 대한 자세한 	정보는 다음을 참조하십시오.
  687.  
  688. 		https://www.libreoffice.org/
  689.  
  690. 	21. LibreOffice는 사용자의 OS 배포판을 통해 설치하는 것이 	좋습니다(apt-get, 
  691. yum 등을 통해).
  692.  
  693. 	* 특히, Swarm에 대해 필요한 최소 패키지 및 	해당 패키지의 추이 종속성은 
  694. 다음과 같습니다.
  695.  
  696. 		* libreoffice-calc
  697. 		* libreoffice-draw
  698. 		* libreoffice-impress
  699. 		* libreoffice-writer
  700. 		* libreoffice-headless(CentOS/RHEL만 해당)
  701.  
  702.  
  703. ------------------------------------------------------------------------
  704. Swarm 구성
  705. ------------------------------------------------------------------------
  706.  
  707. 이제 Swarm을 사용할 준비가 되었으며 사용자의 환경에 맞게
  708. 구성해야 합니다. 구성을 위한 높은 수준의 항목은 다음과 같습니다.
  709.  
  710. 	* Swarm이 Perforce 서버와 통신할 수 있도록 구성 파일 	생성
  711.  
  712. 	* 워커 프로세스 생성을 위한 반복 작업 설정
  713.  
  714. Swarm 구성 파일
  715.  
  716. 	* 'data' 디렉토리 아래에 다음과 같은 컨텐츠로 'config.php'라는 	이름의 
  717. 파일을 생성합니다.
  718.  
  719. 		<?php
  720. 		return array(
  721. 			'p4' => array(
  722. 				'port'     => 'myp4server.domain.com:1666',
  723. 				'user'     => 'admin_userid',
  724. 				'password' => 'ticket-value',
  725. 			)
  726. 		);
  727.  
  728. 	* 'port' 값의 경우 Perforce 서버에 연결할 때 사용된 	P4PORT 값을 
  729. 입력합니다.
  730.  
  731. 	* 'user' 값의 경우 Perforce 서비스에 대한 'admin' 	수준 액세스를 가진 
  732. Perforce 사용자 이름을 입력합니다.
  733.  
  734. 	* 'password' 값의 경우 일반적인 텍스트 암호를 사용할 수도 있으나, 
  735. 	그것보다는 티켓 값을 사용하는 것이 좋습니다. 다음 명령을 사용하여 로그인 중 
  736. 	admin_userid용 티켓 값을 가져옵니다.
  737.  
  738. 		$ p4 -u <admin_userid> login -p
  739.  
  740. 	참고: 3에 대한 *security* 구성 설정을 사용하는 Perforce 서비스의 경우 	티켓 
  741. 기반 인증이 필요합니다.
  742.  
  743. 	중요: 티켓 기반 인증 사용 시 티켓이 만료되기까지의 	기간이 충분한지 
  744. 확인하십시오. 만료된 티켓으로는 많은 	Swarm 작동을 수행할 수 없습니다.
  745.  
  746. 	다음을 통해 <admin_userid>의 티켓 만료 시점을 확인할 수 	있습니다.
  747.  
  748. 		$ p4 -u <admin_userid> -P <ticket_value> login -s
  749.  
  750. 	티켓에 대한 자세한 정보는 다음에서 확인할 수 있습니다.
  751.  
  752. 	http://www.perforce.com/perforce/doc.current/manuals/p4sag/03_superuser
  753. .html
  754.  
  755.  
  756. ------------------------------------------------------------------------
  757. 트리거 토큰 설정
  758. ------------------------------------------------------------------------
  759.  
  760. 트리거 토큰은 Swarm 작업에 영향을 주는 승인되지 않은 이벤트를 방지하며
  761. 트리거는 유효한 토큰이 무시되지 않도록 Swarm에
  762. 요청합니다.
  763.  
  764. 	* Swarm에 수퍼 사용자로 로그인합니다.
  765.  
  766. 	* 주 도구 모음 오른쪽의 사용자 ID를 클릭합니다.
  767.  
  768. 	* Swarm 정보를 선택합니다. Swarm 정보 대화 상자가 나타납니다.
  769.  
  770. 	Swarm 정보 대화 상자가 표시되면 Swarm은 API 	토큰이 없을 경우 이를 
  771. 생성합니다.
  772.  
  773. 	* 대화 상자 아래쪽의 트리거 토큰 값을 메모하여 다음 	단계에서 사용하십시오. 
  774. 토큰을 클릭하여 선택하면 	간편하게 복사할 수 있습니다.
  775.  
  776.  
  777. ------------------------------------------------------------------------
  778. Swarm용 Perforce 구성
  779. ------------------------------------------------------------------------
  780.  
  781. 이제 Swarm 인스턴스가 구성되었으며 마지막 단계는 관심 이벤트에 대한 정보를
  782. Swarm에 전달하도록Perforce를 구성하는 것입니다. 이는
  783. 트리거를 사용하여 구성할 수 있습니다. Perforce 트리거에 대한
  784. 자세한 정보는 Perforce 시스템 관리자 안내서를 참조하십시오.
  785.  
  786. 	http://www.perforce.com/perforce/doc.current/manuals/p4sag/06_scripting
  787. .html
  788.  
  789. Perforce 트리거를 사용하여 이벤트를 Swarm으로 푸시
  790.  
  791. 	* 다음 Swarm 트리거 스크립트를 사용하여 Perforce 이벤트를 Swarm으로 
  792. 	푸시합니다. 다음을 통해 사용할 수 있습니다.
  793.  
  794. 		p4-bin/scripts/swarm-trigger.sh
  795.  
  796. 	* 상기한 스크립트를 Perforce 서버 컴퓨터에 복사하여 	Perforce 트리거가 이를 
  797. 호출할 수 있도록 합니다.
  798.  
  799. 	* 스크립트를 수정하여 SWARM_HOST 변수를 적절하게 설정합니다.
  800.  
  801. 	* 스크립트를 수정하여 SWARM_TOKEN 변수를 적절하게 설정합니다. 	이는 이전 
  802. 단계에서 설정된 API 토큰입니다.
  803.  
  804. 	* 스크립트에 실행 권한이 있는지 확인합니다.
  805.  
  806. 		$ chmod +x swarm-trigger.sh
  807.  
  808. 	* 이 트리거 스크립트에는 트리거 테이블에 추가되어야 할 항목을 표시하는 
  809. 	간편한 플래그가 포함되어 있습니다.
  810.  
  811. 		$ ./swarm-trigger.sh -o
  812.  
  813. 	* '수퍼' 권한을 가진 Perforce 사용자로, 'p4 triggers' 	명령을 실행한 다음 
  814. 해당 명령의 결과 줄을 	추가하여 트리거 테이블을 편집합니다.
  815.  
  816.  
  817. ------------------------------------------------------------------------
  818. 워커 생성을 위한 반복 작업 설정
  819. ------------------------------------------------------------------------
  820.  
  821. 수신 Perforce 이벤트가 Swarm을 위해 자동으로 처리되는지 여부를 확인하려면
  822. 크론 잡을 설정하는 것이 중요합니다.
  823.  
  824. 	* crontab을 편집합니다. 사용자는 Swarm 호스트에 배치하고 싶을 수 있으나 
  825. 	이는 어떤 호스트에도 상주할 수 있습니다.
  826.  
  827. 		$ crontab -e
  828.  
  829. 	* 매 분마다 워커를 생성하도록 항목을 추가합니다.
  830.  
  831. 	* * * * * curl -o /dev/null -m1 http://myswarm/queue/worker
  832.  
  833. 	* Swarm에 대해 적절한 호스트 이름을 지정했는지 확인합니다.
  834.  
  835.  
  836. 이제 Swarm을 사용할 준비가 되었습니다. 즐겁게 사용하십시오!
  837.  
  838. 끝
  839.  
# Change User Description Committed
#1 18730 Liz Lam clean up code and move things around 9 years ago