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