NX Product Template Studio 실행오류 해결｜UGII_JAVA_HOME Java 경로 설정
Siemens NX를 사용하다 보면 반복되는 설계 형상을 매번 처음부터 모델링하는 대신 회사에서 정해둔 치수와 설계규칙을 입력해 필요한 모델을 빠르게 생성하고 싶은 경우가 있습니다.
이럴 때 활용할 수 있는 기능이 NX Product Template Studio, 줄여서 PTS입니다.
PTS를 단순히 “박스나 기어를 자동으로 만들어주는 기능”이라고 이해하기보다는 NX 모델의 파라미터, 설계 규칙, 검증조건과 사용자 입력 화면을 하나의 제품 템플릿으로 만들어 반복 설계에 재사용하는 Knowledge Reuse 도구라고 보는 것이 더 정확합니다.
그런데 구버전 NX나 기존 사내 환경에서 Product Template Studio를 실행하면 다음과 같은 오류가 나타나는 경우가 있습니다.
이 메시지는 단순히 “컴퓨터에 Java가 설치되지 않았다”는 뜻으로만 보면 안 됩니다.
NX PTS가 참조하는
UGII_JAVA_HOME 환경변수에서 사용할 수 있는 Java Runtime을 찾지 못했다는 의미로 접근하는 것이 좋습니다.
NX Product Template Studio는 어떤 기능인가?
PTS는 반복적으로 사용하는 제품이나 부품의 설계방법을 다른 설계자도 사용할 수 있도록 템플릿으로 만드는 기능입니다.
회사에서 이미 만들어진 Product Template을 사용하는 것과 새로운 템플릿을 직접 작성하는 것은 필요한 기능·라이선스가 다를 수 있습니다.
Siemens NX 모듈 구성에서도 Product Template Studio Author와 Product Template Studio Consumer를 구분하고 있으므로, 메뉴 자체가 보이지 않는다면 Java보다 먼저 회사가 보유한 NX 라이선스 구성도 확인하는 것이 좋습니다.
Java was not found using UGII_JAVA_HOME 오류
오류 화면에는 다음과 비슷한 내용이 표시될 수 있습니다.
NX path established
UGII_BASE_DIR = NX 설치 위치
Testing for UGII_JAVA_HOME
JAVA path could not be established
using UGII_JAVA_HOME
기존 자료에는 eatablished라고 적힌 경우가 있지만
의미상 established가 맞습니다.
오류가 의미하는 핵심
PTS 실행 과정에서 NX가 Java Runtime을 찾으려고 했지만
UGII_JAVA_HOME이 없거나,
값이 잘못됐거나,
해당 경로에 NX가 사용할 수 있는 Java가 없는 상태입니다.
먼저 Java를 새로 설치하지 말고 확인할 것
기존 글처럼 오류가 뜨자마자 최신 Oracle Java를 설치하는 방식은 권장하지 않습니다.
NX는 버전에 따라 지원하는 Java Runtime 조건이 달라질 수 있기 때문에 “Java는 무조건 최신 버전이 좋다”는 방식으로 접근하면 오히려 다른 호환성 문제가 생길 수 있습니다.
PTS의 Java 요구조건은 NX Release별로 달라질 수 있습니다. 따라서 특정 Java 버전을 모든 NX에 공통 적용하기보다 현재 사용하는 NX Release의 Siemens 인증·지원 환경을 기준으로 설치해야 합니다.
현재 Java 경로부터 확인
Windows 명령 프롬프트를 실행한 뒤 다음 명령을 입력합니다.
java -version이 명령이 정상이라면 PATH에서 찾은 Java 정보를 보여줍니다.
하지만 여기서 중요한 점이 있습니다.
java -version은 Windows의 PATH에서 Java를 찾지만,
PTS는 UGII_JAVA_HOME에서 지정한 Java를 별도로 참조할 수 있습니다.따라서 두 경로가 다른 Java를 가리키는지 반드시 비교하세요.
Windows 10·Windows 11 UGII_JAVA_HOME 환경변수 설정
1환경 변수 창 열기
Windows 버전과 상관없이 가장 빠른 방법은 Windows + R을 누른 뒤 다음 명령을 실행하는 것입니다.
sysdm.cpl그 다음 고급 → 환경 변수로 이동합니다.
2UGII_JAVA_HOME 생성 또는 수정
| 항목 | 입력값 |
|---|---|
| 변수 이름 | UGII_JAVA_HOME |
| 변수 값 | 현재 NX Release가 사용하는 Java 설치 루트 |
UGII_JAVA_HOME은 bin 폴더가 아니다
예를 들어 Java 구조가 다음과 같다고 가정해보겠습니다.
C:\Java\jdk-xx\
├─ bin\
│ └─ java.exe
├─ lib\
└─ ...이 경우 일반적으로 환경변수는 Java 설치 루트를 가리켜야 합니다.
UGII_JAVA_HOME=C:\Java\jdk-xxC:\Java\jdk-xx\binC:\Java\jdk-xx\bin\java.exePTS가 기대하는 것이 Java Home이라면 bin이나 java.exe 파일 자체가 아니라 Java 설치 루트를 지정해야 합니다.
환경변수에 Program Files 경로는 따옴표가 필요한가?
기존 FAQ에는
Program Files처럼 공백이 있는 경로는 환경변수 값을
반드시 따옴표로 감싸야 한다고 되어 있었지만,
Windows 환경 변수 편집창 자체에 경로를 입력할 때는 일반적으로 따옴표를 넣지 않는 편이 맞습니다.
예를 들어 다음처럼 입력합니다.
C:\Program Files\Java\jdk-xx환경변수 값 자체를 아래처럼 저장하는 것은 피하는 편이 좋습니다.
"C:\Program Files\Java\jdk-xx"반대로 Command Prompt에서 이 경로에 있는 실행파일을 직접 실행할 때는 공백 때문에 명령 전체를 따옴표로 감싸는 것이 맞습니다.
"%UGII_JAVA_HOME%\bin\java.exe" -version환경변수 값 → 보통 따옴표 없이 경로만 저장
명령어 실행 → 공백이 있는 전체 실행경로를 따옴표로 감싸기
UGII_JAVA_HOME이 실제로 적용됐는지 확인
환경변수를 저장한 뒤에는 기존에 열려 있던 NX와 명령 프롬프트를 모두 종료하고 새로 실행합니다.
Command Prompt에서는 다음처럼 확인할 수 있습니다.
echo %UGII_JAVA_HOME%그 다음 NX가 실제로 참조할 Java 실행파일까지 확인합니다.
"%UGII_JAVA_HOME%\bin\java.exe" -version첫 번째 명령은 정상인데 두 번째에서 파일을 찾을 수 없다고 나온다면 UGII_JAVA_HOME 경로가 잘못됐을 가능성이 높습니다.
JAVA_HOME과 PATH도 반드시 설정해야 할까?
꼭 그렇지는 않습니다.
JAVA_HOME과 Windows PATH는
다른 Java 기반 프로그램이나 개발도구에서 널리 사용하는 환경변수입니다.
하지만 현재 문제는 “Java was not found using UGII_JAVA_HOME”이므로 가장 먼저 확인해야 할 것은 UGII_JAVA_HOME 자체입니다.
| 변수 | 주요 역할 | PTS 오류에서 우선순위 |
|---|---|---|
UGII_JAVA_HOME |
NX가 사용할 Java Home 지정 | 가장 먼저 확인 |
JAVA_HOME |
일반 Java 프로그램이 Java 설치 위치를 찾는 데 사용 | NX Release와 사내 환경에 따라 확인 |
PATH |
명령행에서 java.exe 등의 실행파일 검색 | PTS 자체 해결을 위해 무조건 수정할 필요 없음 |
PC에 Java 8, 11, 17, 21 등이 함께 설치돼 있고 PATH 순서까지 뒤섞여 있으면
java -version 결과와 NX가 실제 사용하는 Java가 서로 달라질 수 있습니다.오류 해결을 위해 무조건 PATH를 추가하기보다 NX가 어느 Java를 참조해야 하는지 먼저 고정하는 편이 안전합니다.
ugii.env 파일을 바로 수정해도 될까?
기존 FAQ에는 ugii.env의 Java 경로까지 직접 수정하라는 내용이 있었지만,
이것도 모든 NX 버전에 공통으로 권장할 방법은 아닙니다.
설치 디렉터리의 환경설정 파일은 회사별 배포환경이나 NX Release에 따라 관리방식이 다를 수 있고, 업데이트 또는 패치에서 덮어써질 수도 있습니다.
ugii.env를 직접 편집해야 하는 환경이라면
원본 파일을 백업하고 회사 CAD 관리자 또는 해당 NX Release의 Siemens 문서를 기준으로 변경하는 것이 좋습니다.
관리자 권한으로 NX를 실행하면 해결될까?
일반적으로 UGII_JAVA_HOME 오류의 근본 해결방법은 아닙니다.
같은 사용자 계정에서 설정한 사용자 환경변수는 일반적으로 해당 사용자로 실행한 프로그램에서도 사용할 수 있습니다. 관리자 권한이 없어서 UGII_JAVA_HOME을 읽지 못한다고 단정해서는 안 됩니다.
다만 기업 PC에서 별도 관리자 계정으로 실행하거나 보안정책·로그온 스크립트·VDI 환경을 사용한다면 실행 계정마다 환경변수가 달라질 가능성은 있습니다.
이럴 때는 관리자 실행을 반복하기보다 현재 NX 프로세스가 어느 사용자 계정과 어떤 환경변수를 사용하는지부터 확인하는 것이 맞습니다.
Java가 설치됐는데 PTS가 계속 실행되지 않을 때
UGII_JAVA_HOME을 제대로 설정했는데도 오류가 계속된다면 아래 순서로 확인합니다.
1. 변수 이름 오타 확인
다음처럼 정확히 입력되어 있어야 합니다.
UGII_JAVA_HOME2. Java Home에 java.exe가 실제 존재하는지 확인
"%UGII_JAVA_HOME%\bin\java.exe" -version3. Java 버전과 아키텍처 확인
현재 NX Release에서 인증된 Java Runtime과 맞는지 확인합니다. 현대 NX Windows 환경은 64비트이므로 구형 32비트 Java가 섞여 있는지도 확인할 필요가 있습니다.
4. 여러 Java 설치본 충돌 확인
다음 명령으로 PATH에서 검색되는 Java를 볼 수 있습니다.
where java
여러 경로가 나온다면
java -version과
%UGII_JAVA_HOME%\bin\java.exe가
같은 Runtime을 가리키는지 비교합니다.
5. NX를 완전히 종료하고 다시 실행
환경변수는 실행 중인 프로세스에 실시간으로 갱신되지 않을 수 있습니다.
NX와 Command Prompt를 모두 닫은 뒤 다시 실행하고, 필요하면 Windows에서 로그아웃 후 다시 로그인합니다.
PTS 메뉴가 아예 보이지 않을 때는 Java 문제가 아닐 수 있다
Product Template Studio 메뉴가 존재하고 실행 과정에서 Java was not found가 뜨는 것과 PTS 명령 자체가 보이지 않는 것은 다른 문제입니다.
| 증상 | 먼저 확인할 항목 |
|---|---|
| PTS 실행 후 Java 오류 | UGII_JAVA_HOME·Java Runtime |
| PTS 메뉴 자체가 없음 | NX Role·메뉴 검색·PTS 라이선스 |
| 템플릿은 사용할 수 있지만 수정·작성 불가 | PTS Consumer / Author 권한 차이 |
| 특정 PC에서만 실행 안 됨 | 환경변수·Java 경로·Windows 사용자 환경 |
| 회사 전체에서 동시에 안 됨 | NX 배포환경·라이선스·Site 설정 |
구버전 NX와 최신 NX의 PTS 메뉴가 다른 이유
오래된 NX에서는 명령 검색에서 PTS라는 영문 약어로 찾았던 환경도 있었지만, 한글 UI에서는 제품 템플릿 스튜디오처럼 번역된 이름으로 표시될 수 있습니다.
또 NX는 버전이 바뀌면서 Ribbon, Role, Command Search와 메뉴 구성이 변경돼왔기 때문에 예전 화면과 현재 화면의 위치가 같다고 가정하지 않는 것이 좋습니다.
현재 사용하는 NX에서 Product Template Studio, Product Template, PTS, 제품 템플릿 등으로 검색해 실제 등록된 명령을 확인하는 편이 빠릅니다.
회사에서 PTS를 사용할 때 더 중요한 것은 Java보다 표준화
PTS의 장점은 단순히 모델링 클릭 횟수를 줄이는 데만 있지 않습니다.
실무에서는 숙련 설계자가 알고 있는 “이 치수는 이 범위를 넘어가면 안 된다”, “이 옵션에서는 이 Feature가 반드시 들어가야 한다”, “부품 크기에 따라 다른 형상을 사용한다” 같은 판단을 템플릿 안으로 옮길 수 있다는 점이 더 중요합니다.
모든 Feature와 치수를 노출하면 일반 NX 모델을 직접 수정하는 것과 큰 차이가 없어집니다. 실제 사용자가 선택해야 할 입력값만 정리하고, 나머지는 Template 내부 규칙으로 처리하는 편이 PTS의 장점을 살리기 좋습니다.
NX PTS Java 오류 빠른 진단표
| 증상 | 1순위 확인 | 다음 확인 |
|---|---|---|
| Java was not found using UGII_JAVA_HOME | UGII_JAVA_HOME 경로 | 해당 경로의 java.exe |
| java -version은 정상인데 PTS 실패 | UGII_JAVA_HOME | PATH Java와 경로 비교 |
| 환경변수 변경 후 그대로 오류 | NX 재시작 | 로그아웃·새 세션 |
| Java 새 버전 설치 후 PTS 실패 | NX Release 호환성 | 기존 인증 Runtime 확인 |
| PTS 메뉴 자체가 없음 | PTS 라이선스 | Role·Command Search |
| Consumer는 되는데 Author가 안 됨 | 라이선스 구성 | PTS Author 권한 |
| 한 PC에서만 실패 | 환경변수 | Java 설치·사용자 설정 |
| 회사 전체에서 실패 | NX 배포 설정 | CAD 관리자·Site 환경 |
디크리노랗 NX 관련글
Siemens 공식 확인자료
NX는 장기간 여러 Release가 현장에서 함께 사용되고 있기 때문에 인터넷에서 찾은 특정 Java 8·11·17 버전을 모든 NX에 동일하게 적용하면 안 됩니다.
Siemens Support Center에서 현재 사용하는 NX Release의 System Requirements·Certification·Release Notes를 확인하는 것이 가장 안전합니다.
NX Product Template Studio FAQ
NX Product Template Studio는 무엇인가요?
NX 모델의 파라미터와 설계규칙, 입력 UI 등을 제품 템플릿으로 만들어 반복 설계와 기업의 설계 노하우를 재사용할 수 있게 하는 Knowledge Reuse 기능입니다.
Java was not found using UGII_JAVA_HOME은 무슨 뜻인가요?
NX PTS가 UGII_JAVA_HOME에 지정된 위치에서 사용할 수 있는 Java Runtime을 찾지 못했다는 의미입니다. 환경변수 누락·오타·잘못된 경로·Java 호환성 등을 확인해야 합니다.
UGII_JAVA_HOME에는 bin 폴더를 입력하나요?
일반적으로 Java의 설치 루트를 지정하고,
그 아래 bin\java.exe가 존재하는 구조여야 합니다.
bin 폴더나 java.exe 자체를 변수값으로 넣지 않는 것이 좋습니다.
Java 8을 설치하면 모든 NX PTS에서 해결되나요?
아닙니다. NX Release별로 지원하는 Java Runtime 조건이 달라질 수 있으므로 특정 Java 버전을 모든 NX에 공통 적용하면 안 됩니다. 사용 중인 NX Release의 Siemens 지원환경을 먼저 확인하세요.
JAVA_HOME과 PATH도 반드시 추가해야 하나요?
UGII_JAVA_HOME 오류를 해결하기 위해 JAVA_HOME과 PATH를 무조건 변경할 필요는 없습니다.
먼저 NX 전용 UGII_JAVA_HOME이 정확한 Java를 가리키는지 확인하는 것이 우선입니다.
Program Files의 Java 경로에는 따옴표를 넣어야 하나요?
Windows 환경변수 편집창의 변수값에는 일반적으로 따옴표 없이 경로를 입력합니다. Command Prompt에서 공백이 포함된 실행파일 경로를 직접 실행할 때는 전체 경로를 따옴표로 감쌉니다.
관리자 권한으로 NX를 실행하면 UGII_JAVA_HOME 오류가 해결되나요?
일반적인 해결방법은 아닙니다. 환경변수 경로와 Java 호환성을 먼저 확인해야 합니다. 다만 회사 PC에서 별도의 관리자 계정이나 로그온 정책을 사용한다면 계정별 환경변수 차이가 있는지 확인할 필요는 있습니다.
PTS 메뉴 자체가 보이지 않는데 Java를 설치하면 되나요?
먼저 PTS Author·Consumer 라이선스와 NX Role·Command Search를 확인하세요. 명령 자체가 없는 문제와 명령 실행 후 Java 오류가 나는 문제는 서로 다릅니다.
ugii.env를 직접 수정해야 하나요?
모든 NX 버전에서 공통으로 필요한 작업은 아닙니다. Windows 환경변수와 NX Release별 공식 설정을 먼저 확인하고, 기업의 Site 환경에서 직접 수정해야 한다면 원본을 백업한 후 CAD 관리자와 Siemens 문서를 기준으로 변경하세요.
NX Product Template Studio를 실행할 때 Java was not found using UGII_JAVA_HOME이 나타난다면 Java를 무작정 재설치하는 것보다 먼저 NX Release → UGII_JAVA_HOME → Java 설치 루트 → java.exe 실행 → Java 호환성 순으로 확인하는 것이 좋습니다.
특히
java -version이 정상이라고 해서
NX PTS가 같은 Java를 사용하고 있다는 뜻은 아니므로,
%UGII_JAVA_HOME%\bin\java.exe -version으로
PTS가 실제 참조하는 경로를 따로 확인하는 것이 핵심입니다.
