103 lines
4.4 KiB
Plaintext
103 lines
4.4 KiB
Plaintext
Metaverse Development Server 설치 매뉴얼
|
|
=======================================
|
|
|
|
작성일: 2025.04.04
|
|
|
|
📁 준비사항
|
|
----------
|
|
- Dev_Server 폴더 내 설치 파일들(`.exe`, `.msi`)이 모두 이 스크립트(`.bat`)와 같은 디렉터리에 있어야 합니다.
|
|
- 설치 중 로그가 `install_YYYYMMDD_log.txt` 형식으로 자동 저장됩니다.
|
|
- 설치 완료 후 5분 뒤 자동으로 시스템 재부팅됩니다.
|
|
|
|
📌 참고 사항
|
|
-----------
|
|
- 설치 로그는 `install_YYYYMMDD_log.txt`에 시간별로 기록됩니다.
|
|
- 에러 발생 시 해당 로그 파일을 통해 문제 원인 확인 가능합니다.
|
|
- 관리자 권한으로 실행해야 모든 설치가 정상 진행됩니다.
|
|
|
|
|
|
✅ 설치 순서
|
|
-----------
|
|
|
|
1. 날짜 및 로그 파일 설정
|
|
- 현재 날짜를 `YYYYMMDD` 형식으로 가져와 로그 파일 이름에 사용합니다.
|
|
- 예: `install_20250404_log.txt`
|
|
|
|
2. Microsoft Visual C++ 2015-2022 Redistributable 설치
|
|
- 파일: `VC_redist.x64.exe`
|
|
- 역할: C++ 기반 앱 실행용 런타임
|
|
- 명령어:
|
|
start /wait "" "%~dp0VC_redist.x64.exe" /quiet /install /norestart
|
|
|
|
3. Microsoft .NET 8.0 SDK 설치
|
|
- 파일: `dotnet-sdk-8.0.407-win-x64.exe`
|
|
- 역할: .NET 기반 애플리케이션 개발 및 실행
|
|
- 명령어:
|
|
start /wait "" "%~dp0dotnet-sdk-8.0.407-win-x64.exe" /quiet /install /norestart
|
|
|
|
4. Microsoft Windows SDK 설치
|
|
- 파일: `winsdksetup.exe`
|
|
- 기능: OptionId.WindowsDesktopDebugger
|
|
- 역할: Jenkins 도구 (ssindex, symstore 등) 제공
|
|
- 명령어:
|
|
start /wait "" "%~dp0winsdksetup.exe" /features OptionId.WindowsDesktopDebugger /quiet /norestart
|
|
|
|
5. Strawberry Perl 설치 (perl 명령어)
|
|
- 파일: `strawberry-perl-5.40.0.1-64bit.msi`
|
|
- 역할: Perl 스크립트 실행 (Jenkins 등에서 사용)
|
|
- 명령어:
|
|
start /wait "" "%~dp0strawberry-perl-5.40.0.1-64bit.msi" /quiet /norestart
|
|
|
|
6. OpenJDK 설치
|
|
- 파일: `OpenJDK21U-jdk_x64_windows_hotspot_21.0.6_7.msi`
|
|
- 역할: Java 기반 툴(Jenkins 등) 구동
|
|
- 명령어:
|
|
start /wait "" "%~dp0OpenJDK21U-jdk_x64_windows_hotspot_21.0.6_7.msi" /quiet /norestart
|
|
|
|
7. Docker 설치
|
|
- 파일: `Docker Desktop Installer.exe`
|
|
- 옵션: --quiet --accept-license --no-start
|
|
- 역할: 컨테이너 기반 개발 환경
|
|
- 명령어:
|
|
start /wait "" "%~dp0Docker Desktop Installer.exe" install --quiet --accept-license --no-start
|
|
|
|
8. ProudNET 설치
|
|
- 파일: `ProudNetLibSetup-1.7.56164-master.exe`
|
|
- 역할: 메타버스 서버 네트워크 라이브러리
|
|
- 명령어:
|
|
start /wait "" "%~dp0ProudNetLibSetup-1.7.56164-master.exe" /silent
|
|
|
|
9. ProudNET 라이선스 인증
|
|
- 파일: `PNLicenseKey.txt`, 실행 파일: `PNLicenseAuth.exe`
|
|
- 역할: ProudNET 라이선스 활성화
|
|
- 명령어:
|
|
start /wait "" "%~dp0PNLicenseAuth.exe" "%~dp0PNLicenseKey.txt"
|
|
|
|
10. 수동 설치 항목 안내
|
|
- 다음 항목은 사용자가 직접 설치해야 합니다:
|
|
- jenkins.msi
|
|
- TortoiseSVN-1.14.9.29743-x64-svn-1.14.5.msi
|
|
- 파일 위치: Dev_Server 폴더 내
|
|
- 설명: jenkins 설치시 openjdk 디렉토리를 지정해야함. C:\Program Files\Eclipse Adoptium\jdk-21.0.6.7-hotspot,
|
|
TortoiseSVN 설치시 CLI 명령어 패키지도 함께 설치한다. 모든 패키지 설치
|
|
|
|
11. 설치 완료 후 재부팅
|
|
- 5분(300초) 대기 후 자동 재부팅
|
|
- 명령어:
|
|
timeout /t 300
|
|
shutdown /r /t 0
|
|
|
|
12. Jenkins 설치 이후 워크스페이스 변경
|
|
- 파일: run_script_as_admin_for_change_workspace.bat 실행
|
|
- 설명: Powershell로 change_workspace.ps1 관리자 권한으로 실행되고 새로운 워크스페이스 경로를 입력받아 C:\ProgramData\Jenkins\.jenkins\config.xml 의
|
|
<workspaceDir>${JENKINS_HOME}/workspace/${ITEM_FULL_NAME}</workspaceDir> 부분을 자동 수정하고 Jenkins 재시작.
|
|
|
|
13. Windows SDK 환경변수 PATH 추가 (ssindex, symstore 명령어)
|
|
- 파일: run_script_as_admin_for_add_winsdk_path.bat 실행
|
|
- 설명: Powershell로 Add_WindowsSDK_Paths.ps1 관리자 권한으로 실행되며 경로 리부팅 없이 즉시 추가
|
|
|
|
14. Jenkins 로그인 이후 Jenkins 관리의 Plugins 에서 ThinBackup 설치한다. 그러면 Jenkins 관리의 Tools and Actions 항목에 설치된 것을 확인 할 수 있다.
|
|
- Jenkins 관리의 System Configuration 항목 System 에서 ThinBackup의 백업 및 복구 디렉토리 지정 ThinBackup Configuration > Backup directory, 예) E:\Jenkins_Backup_Thin
|
|
- 항목 체크: Backup userContent folder, Backup next build number file, Backup plugins archives, Backup config-history folder
|
|
|