UEDRSPIHCRSSRSS

설치하기Windows/tlinstall


이 페이지는 네트워크(인터넷)를 통한 설치 방법을 설명한다. 네트워크 안정성을 확신할 수 없다면, isoimage를 통한 설치 방법을 고려해보라. 이 페이지에서 설명하는 방법과 큰 차이는 없으나 설치에 필요한 모든 파일을 미리 다운로드받은 다음에 시도하는 것이므로 실패할 가능성이 훨씬 적다.

1. 준비

  • 일반적인 상황은 아니나, 일부 Windows에서 C:\Windows\System32 폴더가 PATH 변수에 포함되어 있지 않은 경우가 있다. 설치 프로그램이 cmd.exe를 부르기 때문에 이 폴더가 PATH에 포함되어 있을 것이 필수적이다. 만약 설치 후에 fmt를 만드는 데 실패한다면 십중팔구 이 문제일 것이므로 확인이 필요하다.
  • MiKTeX이나 TeXLive 이전 버전이 설치되어 있다면 프로그램 추가/삭제에서 지운다.
    • TeXLive 이전 버전은 굳이 삭제하지 않아도 된다. 그러면 이전 연도 파일이 그대로 보존되면서 새로운 연도판이 설치된다. 예컨대 2022년판을 설치한 후 이를 삭제하지 않고 2023을 설치하면 C:\TeXLive\2022 폴더에 이전 연도 파일들이, C:\TeXLive\2023에 2023년 파일들이 보관되고 가장 최근에 설치한 것이 활성화된다.
    • C:\TeXLive\texmf-local 폴더는 연도가 바뀌어도 그대로 유지된다.
    • MiKTeX은 운용 방식이 전혀 다른 프로그램이므로 삭제할 것.
  • 윈도우즈 사용자 이름을 영문자와 숫자만으로 한다.
    • 영미권에서 만들어진 많은 프로그램들은 알파벳이외의 글자에 대해서 오작동을 하는 경우를 종종 만난다. 그러므로 컴퓨터에서는 영어만 사용한다고 생각하고 쓰는 편이 좋다. 또한 사용자 이름도 철수, 영희 보다 Cheolsu, Yeonghui로 입력하는 편이 좋다. 그렇지 않은 경우, 질문게시판의 242049번 글 과 같은 경우를 만날 수 있다. 윈도우10 사용자 이름 바꾸는 방법 의 방법으로 사용자 이름을 바꿀 수도 있으나, 항상 잘된다고는 보장하기 어렵다.
    • 자신의 사용자 이름에 한글이 포함되어 있는지 여부를 확인하려면 cmd (powershell 아님)를 열고 다음 명령을 실행해본다. 여기서 보이는 폴더 위치에 한글이 들어 있지 않아야 한다.
      echo %userprofile%
      
    • 한글이 포함되어 있더라도 TeX Live를 설치할 수 없는 것은 아니다. 설치 자체는 TEMP 환경 변수를 일시적으로 변경하여 설치가 가능하다. | KTUG Q&A 게시물 참조.
    • 설치에 성공했더라도 다음과 같은 문제를 만날 수 있다.
      1. 에디터와 뷰어 사이의 상호 바로가기(Forward / Inverse Search)가 동작하지 않는다.
      2. 사용자 권한으로 설치한 폰트를 XeLaTeX에서 사용할 수 없다.
      3. TeX Live 업데이트를 할 때 임시 화일 생성에 어려움이 생겨, 업데이트가 안될 수 있을 가능성도 있다.
    • 따라서 사용자 이름이 한글인 경우에는 MiKTeX 설치를 고려해보는 것이 좋다.
  • 아래 "문제상황 목록"에 보면 Perl이 이미 설치되어 있는 경우의 예상되는 문제 상황에 대한 설명이 있다. 이 절차가 번거로우므로 TeXLive를 처음 설치하고 TeX과 Perl에 대하여 잘 안다고 자신하지 않는 일반 사용자라면, TeXLive 설치 과정에서 Perl을 일시적으로 무력화해두는 것이 편리하다.
    • where.exe perl 명령을 실행하여 현재 설치된 perl의 위치를 확인한다. Strawberry Perl이 설치되어 있다면 설정->앱->설치된 앱에서 제거한다. (이 Perl이 반드시 필요하다면 TeXLive 설치 후 재설치한다.) winget으로 설치하였다면 winget uninstall StrawberryPerl.StrawberryPerl 명령을 주어서 삭제할 수 있다.
    • 환경 변수 변경 사항을 활성화하기 위하여 로그아웃하였다가 다시 로그인한다.
    • TeXLive 설치를 계속한다.
    • 이 권고 사항은 스스로 해결할 수 있다면 적용할 필요 없다. 또한 Windows Perl 앱이 추후 버전업으로 문제가 해결될 가능성도 있다.

2. TeXLive 설치

  • 설치 프로그램 파일 install-tl-windows.exe를 다운로드받는다.
  • 실행한다.
    • 이 실행 파일은 두 단계로 실행된다. 먼저 설치에 필요한 파일의 압축을 풀고, 그 다음에 인스톨러를 실행하는 것이다. 각 단계는 자동으로 진행하므로 사용자가 할 일은 (인스톨러가 실행될 때까지) 기다리는 것이다.
    • TeX Live 2021부터는 두 번째 단계, 즉 인스톨러가 실행될 때 CTAN mirror를 선택할 수 있게 되었다. Asia -> Korea를 찾아 들어가면 ktug, navercorp 등 몇몇 mirror의 목록이 나타난다. 되도록 ktug 서버를 선택하지 않는 것이 좋다.
    • mirror를 지정하여 실행할 수 있다. 위의 목록에 나타나지 않는 미러 사이트를 지정하여 실행할 수 있다. 예를 들면 kakao.com의 미러는 목록에 없다. 다운로드 폴더에서 cmd를 열고 다음과 같이 명령을 내린다.
      install-tl-windows.exe --repository http://mirror.kakao.com/CTAN/systems/texlive/tlnet
      
      미러 사이트 주소는 아래 repository mirror 항목을 참조.
    • Selected scheme이 scheme-full로 되어 있다. 원하는 것을 선택한다.
      • 시간이 오래 걸리더라도 scheme-full 설치하는 것이 사후관리를 위해서나 정신건강을 위해서나 좋다.
      • scheme full 설치가 망설여진다면 이 문서 9.1절 "small scheme으로 설치하기" 소절을 참고하라.
  • Install TeXLive 버튼을 누르고 기다린다.
    • 네트워크를 통하여 설치하는 것이므로 네트워크 사정에 따라 중간에 간간이 접속에 실패한 것같은 메시지가 나오지만 대부분 별 문제가 아니된다. 정말로 치명적인 오류가 발생하여 중단되었다면 처음부터 다시 한다.
    • 패키지를 받아 오다가 속도가 느려져 중간에 끊기면서 설치가 종료되는 일이 종종 발생하고 있다. 이경우 다시 설치하거나, 좀 더 속도가 빨라 보이는 다른 서버를 찾아 보는 수 밖에 없다. 주로 졸업논문 작성 시즌에 발생하는 일로서, 접속량 증가에 따라 속도가 느려져 발생하는 일이므로 다른 대안을 찾기는 어렵다. 대안이라면 ISO화일을 받아서 설치하는 방법으로 해결한 경우도 종종 있다고 한다.

2.1. repository mirror

  • KTUG에서도 CTAN을 미러하고 있으나 서버의 대역폭이 좁아서 ftp.ktug.org로부터 TeX Live를 설치하면 20시간 정도 걸릴 수 있다. 그러므로 다른 미러 사이트를 사용하는 것을 권한다.
  • 다음은 현재 알려진 국내의 미러 사이트 주소이다. 다음 주소는 --repository 옵션 다음에 적어주면 된다.
    • install-tl-windows.bat --repository URL 의 명령으로 설치간 필요한 패키지를 받아올 repository를 지정할 수 있다. 현재 한국내에서 사용가능한 곳과 설치 명령은 아래와 같다.
      • 카카오(다음):
        http://mirror.kakao.com/CTAN/systems/texlive/tlnet/
      • 네이버 주식회사 :
        http://mirror.navercorp.com/CTAN/systems/texlive/tlnet/
      • harukasan :
        http://ftp.harukasan.org/CTAN/systems/texlive/tlnet/
      • Yongbok.net:
        http://mirror.yongbok.net/ctan/systems/texlive/tlnet/
      • CRAN (Comprehensive R Archive Network) mirror, 동아시아 권역 (0-Cloud-East-Asia)
        https://cran.asia/tex/systems/texlive/tlnet/
        (2020-07-29부터)
      • KAIST :
        http://ftp.kaist.ac.kr/tex-archive/systems/texlive/tlnet/
      • KTUG : 살아 있지만 매우 느리다.
        http://ftp.ktug.org/tex-archive/systems/texlive/tlnet/


    • 물론 URL에 다른 곳을 넣어도 된다. 예를 들어 JAIST에서 제공하는 미러를 사용하여도 된다.
      • JAIST :
        http://ftp.jaist.ac.jp/pub/CTAN/systems/texlive/tlnet/

3. 설치 종료 후

  • 가장 안전한 것은 시스템을 한 번 리부팅해주거나 로그아웃했다가 다시 로그인하는 것이다. 그렇지 않다면 적어도 실행중인 모든 프로그램을 다 중단했다가 다시 실행하라.
  • 설치 종료 후 tlmgr update --all --self를 한번 실행할 것을 권장한다.

4. ko.TeX Live 설정

  • ko.TeX Live[1]설정은 TeX Live 설치후 KTUG repository[2]를 이용하여 한글 환경에 필요한 추가 패키지를 설치하는 과정을 설명한다.
  • 다만 꼭 필요한 부분은 아니므로, KTUG repository에서 필요한 패키지만 골라서 설치하여도 된다.
  • TeX Live command-line(cmd 프로그램)을 열어서 다음 명령을 차례로 실행한다. (> 표시는 프롬프트이므로 직접 써넣는 것이 아님.)
    > tlmgr repository add https://cran.asia/KTUG/texlive/tlnet ktug
    > tlmgr pinning add ktug *
    > tlmgr install ktugbin
    > tlmgr install nanumttf hcr-lvt
    
    여기까지 진행하면 ko.TeX Live와 비슷한 상태가 된다.
    • 참고사항 1: 수동설정시 참고할 점
      • cmd 프로그램 열기에 익숙하지 않으면, 명령창열기 참고.
      • 띄어쓰기와 대소문자에 주의한다. 특히 첫 줄 명령에서 마지막의 tlnet과 ktug 사이를 반드시 띄어야 한다.
      • pinning add 명령의 별표(*)는 "*"처럼 따옴표로 둘러싸서 입력할 수 있다.
      • Tip: 타이핑하면서 오타가 나는 경우가 있으므로, 복사-붙이기로 하면 편리하다.
        • 첫줄에서 tlmgr ... ktug를 복사하여 명령창에 붙이기한 후 엔터를 쳐서 실행하고
        • 차례로 다음 줄을 복사-붙이기 하여 실행해나가면 끝.
    • 참고사항 2: 위의 수동설정 과정을 클릭 한 번으로 자동설정하는 방법
      • ko. TeX Live 설정 과정 전체 자동화 배치파일. @tl-kotex-2019.zip (548 Bytes) (설치연도에 무관하게 실행 가능)
        • 위에 설명된 과정 중에서 texworks-config와 hcr-lvt 설치 과정은 제외함. (texworks-config는 사용자 취향에 따라 선택할 수 있도록, 그리고 hcr-lvt는 ktug 서버가 너무 느리기 때문에 시간 관계상.)
      • zip 파일을 풀면 나오는 배치파일을 실행. (TeX Live 설치가 완전히 종료된 후 실행)
      • cmd를 관리자 권한으로 여는 것이 필요할 수 있다.
  • 설치하기Windows/UserFont의 권고를 따르는 것이 좋다. (해당 조치는 ktugbin을 설치하는 것으로 해결된다.)

5. 사용자 환경 만들기

  • TeX Live를 설치하면 TeXworks 에디터를 바로 사용할 수 있다. pdf viewer를 내장한 에디터이다.

6. 업데이트와 삭제

6.1. 업데이트

  • cmd를 열어서 업데이트
    > tlmgr update --all --self
    
    • 텍라이브 매니저 자체가 업데이트 되지 않아 업데이트가 잘 동작하지 않을 수 있다. 이 경우 이 링크에서 update-tlmgr-latest.exe 파일을 받아 실행 후 업데이트를 다시 시도한다. (참고링크, KTUG게시판 191705글)
    • 또는 Windows 메뉴 (찾기)에서] TeX Live Manager를 실행하여 업데이트할 수 있다.

6.2. 삭제

  • 설치한 패키지만 삭제하려 하는 경우
    > tlmgr remove <package>
    
  • TeX Live 전체 삭제
    • 프로그램 추가/제거에서 TeX Live 20XX를 삭제하고
    • c:\usr\texlive 폴더를 직접 삭제
      • 참고: 이전에 설치된 버전을 제거하고 다음 연도 TeX Live를 설치하기 위해서라면 폴더 삭제는 하지 않아도 상관없다. 참고: TeXLiveUpdate

7. 다른 방법

8. 발생 가능한 문제상황 목록

  • 일부 바이러스 진단 프로그램이 TeX Live 2016에 대하여 바이러스로 진단하는 경우가 있다고 한다. 대부분은 오진일 가능성이 높다.
  • 일부 바이러스 진단 프로그램이 TeX Live 2016의 실행을 방해하는 경우가 있다. 바이러스 진단 프로그램의 실행을 잠시 중단하고 설치하는 수밖에 없다. 대부분의 잘 알려진 바이러스 진단 프로그램은 이런 동작을 보이지 않는다. (바이러스 진단 프로그램을 종료하고 설치할 것을 권한다.)
  • perl.exe 에러
  • Can't spawn "cmd.exe"
  • biber.win32 설치중 중단
  • 패키지 다운로드 중 설치가 멈추는 경우
  • 네트웍 상태가 나빠서 설치가 어려운 경우, iso를 다운로드 받아서 설치하는 것이 편리할 수도 있다. 이방법은 위의 다른 방법 항을 참조한다.
  • 한글 문서를 XeLaTeX으로 컴파일 시 시간이 오래 걸리는 경우 설치 후 ko.TeXLive 설정 부분을 수행하지 않은 경우 한글 문서를 XeLaTeX으로 컴파일 시 시간이 오래 걸릴 수 있다. 이 경우 ko.TeXLive 설정을 참고하여 nanumttf를 설치하여 해결할 수 있다.
  • Locale 'Korean_Korea.949' is unsupported 메시지가 나오면서 설치가 진행되지 않는 문제가 보고되었다. KTUG 게시판 268453 이 문제는 시스템에 이미 다른 Perl이 설치되어 있고 그 Perl이 Locale을 설정해두었는데 TeXLive 설치 스크립트가 이를 이해하지 못하기 때문에 발생하는 일로 보인다. 다음과 같이 설치를 시도한다.
    • install-tl-windows.exe를 다운로드받은 폴더에서 명령 프롬프트(cmd)를 연다. (powershell이 아님에 유의)
    • 명령 프롬프트 상에서 다음 명령을 써넣는다.
      set LANG=C
      set LC_ALL=C
      
    • 그런 다음 명령줄에 직접 다음 명령을 적어넣어서 설치 프로그램을 실행한다. 탐색기의 더블 클릭으로는 문제가 해결되지 않을 것이다.
      > install-tl-windows
      
    • tlmgr로 업데이트 등을 시도할 때도 명령 프롬프트를 열고 LANG 설정한 다음 tlmgr을 실행하면 된다.
      > set LANG=C
      > set LC_ALL=C
      > tlmgr update --all --self
      

9. 설치 관련 참고사항

9.1. small scheme으로 설치하기

  • 이 문서는 TeX Live를 전체 설치(full scheme)하는 것을 기준으로 서술하고 있으나 이것은 시간이나 용량 면에서 부담스러울 수 있다. 따라서 설치 시에 Advanced 버튼을 눌러서 설치 옵션을 medium이나 small을 선택하고 운영 시에 필요한 패키지를 추가해가면서 활용하는 방법이 있다.
  • 이 방법에 대해서는 KTUG게시판의 관련 글을 참고하라.

9.2. 환경 변수의 확인

개인이 설치한 폰트나 매크로를 위한 디렉토리는 아래의 명령으로 확인할 수 있다.
  • kpsewhich --var=value=TEXMFHOME : 혼자만 사용하는 글꼴, 매크로등을 설치할 위치
  • kpsewhich --var=value=TEXMFLOCAL : TeX Live로 설치되지 않았으나, system안에서 함께 사용할 글꼴, 매크로등을 설치할 위치

9.3. exe 대신 설치 압축파일을 이용하는 방법

  • 위의 설치 exe는 압축을 풀고 install-tl-windows.bat라는 배치파일을 실행하는 일을 하는 파일이다. 이 과정을 수동으로 할 수 있다.
  • http://mirror.navercorp.com/CTAN/systems/texlive/tlnet/install-tl.zip 다운로드
  • 압축을 풀고 intall-tl-YYYYMMDD라는 폴더로 들어간다.
  • command 명령창을 연다
    • windows key + R 을 누른후 cmd를 입력하고 enter를 누르면 DOS 시절과 같은 terminal 창이 뜬다.
  • install-tl-windows.bat 를 입력하고 실행한다.
    설치되는 디렉토리를 기본값에서 바꾸어 설치할 필요가 있을 수도 있다. 위의 항목 "미러 사이트"를 참고하여 가까운 서버를 지정하자.
    • 커맨드창 실행 시 GUI가 안 뜨고 바로 goodbye로 꺼지는 경우(오류메시지: cmd.exe를 찾을 수 없다고 함)가 있는데, 윈도우 환경에서 시스템 속성 > 환경 변수의 시스템 변수 'Path'에 C:\Windows\system32; 를 추가하면 된다.

9.4. 64bit binaries

  • TeXLive 2023부터 windows binaries는 x64이다. win32는 더이상 제공하지 않는다.

10. 설치 사례, 강의

11. 이전(전년도) 버전으로부터 업그레이드

  • 매년 TeXLive는 새 버전이 나온다. 매년 새로이 설치하는 것도 한 가지 방법이다.
  • 이전 년도에 설치된 상태를 그대로 두고 버전을 새 년도의 것으로 업그레이드 하려면 다음과 같이 한다. 이 때에는 설치 위치의 연도 표시가 처음 설치된 연도(예: c:\texlive\2019)를 그대로 유지한다. 그러나 시스템 자체는 새 연도 버전으로 바뀐다. 설치 연도를 새 연도로 고치고 싶으면 새로 설치한다.
  • |update-tlmgr-latest.exe를 다운로드 받는다.
  • 실행한다.
  • 실행이 끝난 후에 시스템 전체를 업데이트한다.
    • cmd에서 tlmgr update --all --self를 실행하거나
    • TeX Live Manager를 실행하여 update

12. 이 문서를 수정하시는 분께 드리는 말씀

wiki에서 URLs의 문법이 다른 점에 주의 바랍니다. [:koTeXLive ko.TeX Live] 로 적으시면 안되고 [koTeXLive ko.TeX Live]로 적으셔야 합니다. 혹은 [wiki:명령창열기]과 같은 문법도 검토하시길 바랍니다.

----
  • [1] KTUG 표준한글텍환경 프로젝트팀이 KTS의 지원을 받아 제작하여 배포한 윈도우즈용 인스톨러였다. CTAN에 한국어 관련한 패키지의 많은 부분이 올라감에 따라, 한글 환경에 맞는 별도의 인스톨러를 만들고 유지할 필요성이 없어짐에 따라 2014년 이후 부터는 제공하지 않고 있다.
  • [2] CTAN에서 제공하지 않는 한국어 사용자를 위한 패키지 저장소이다.