IT 부서를 위한 정보

Altium On-Prem Enterprise Server와 관련 서비스의 설치 및 사용 방법은 이 문서 사이트의 다른 페이지들에서 자세히 다루고 있지만, 이 페이지의 목적은 조직의 IT 부서를 위한 단일한 상세 참고 자료를 제공하는 데 있습니다. 즉, 다음을 포함해 이 기술과 관련하여 일반적으로 자주 묻는 질문에 대한 답을 찾을 수 있는 곳입니다.

• What are the hardware requirements to install the Enterprise Server?

• What is installed?

• What programs and processes are running?

• Where is the data stored?

• What ports are used?

• What protocol is used for communications?

• How is data backed up?

다음 섹션에서는 아키텍처 및 데이터 흐름에 대한 상위 수준 개요를 포함하여, 이러한 질문들과 기타 질문들에 대한 자세한 답변을 제공합니다.

IIS Configuration

IIS 구성의 일부로 ISAPI Extensions 기능이 활성화됩니다. 이 기능은 Windows의 Programs and Features 창에서 접근할 수 있는 Windows Features 대화 상자의 \Internet Information Services\World Wide Web Services\Application Development Features 섹션에서 찾을 수 있습니다.

Enterprise Server를 설치하면 IIS 구성의 일부인 Windows ISAPI Extensions 기능이 활성화됩니다.

HTTPS 프로토콜 지원

Enterprise Server는 데이터의 기밀성과 무결성을 보호하기 위해 HTTPS 프로토콜을 사용한 네트워크상의 보안 통신을 제공합니다.

인증서 구성

새로 설치하는 경우 Enterprise Server는 IIS에서 생성 및 구성된 자체 서명 인증서를 제공합니다. 보안상의 이유로, 자체 인증서를 직접 생성하고(표준/선호 도구 사용) 그 인증서를 IIS에 구성하는 것을 권장합니다. 인증서 요청을 생성하여 VeriSign 또는 GeoTrust와 같은 공인 인증 기관(CA)에 보내거나, 인트라넷 도메인의 온라인 CA에서 인증서를 받을 수 있습니다. 자세한 내용은 Microsoft 문서의 How to Set Up SSL on IIS 7 or later 페이지를 참조하십시오.

HTTPS 구성

Enterprise Server의 구성 및 서버 바인딩은 Administration Tools 창(Control Panel\System and Security\Administrative Tools)에서 사용할 수 있는 Windows Internet Information Services (IIS) Manager 패널에서 접근할 수 있습니다. 패널의 Connections 목록에서 'Altium On-Prem Enterprise Server' 항목을 선택한 다음 Features View 탭을 선택하십시오.

Enterprise Server의 액세스 구성 및 서버 바인딩 설정에 접근합니다.

Enterprise Server에 사용 가능한 포트와 서버 이름은 Actions 창에 선택 가능한 링크로 표시됩니다. 이 링크를 사용하여 서버 연결 프로토콜을 확인하고 테스트하거나, 창의 Edit Site 섹션에서 Bindings 링크를 선택해 현재 이름/포트 바인딩에 접근할 수 있습니다.

프로토콜 포트 번호를 포함한 바인딩은 Edit 버튼을 통해 Site Bindings 대화 상자에서 편집할 수 있습니다.

Site Bindings 대화 상자를 통해 바인딩을 구성합니다.

서버 이름 localhost 은(는) 로컬 머신에만 적용되므로, Enterprise Server를 호스팅하는 PC가 아닌 다른 PC는 연결 시 해당 호스트 머신의 실제(서버) 이름을 사용해야 합니다.

Enterprise Server가 설치 및 실행 중인 호스트 PC의 이름을 확인하려면, 해당 머신에서 Control Panel\System and Security\System 로 이동하여 Computer name 및 Full computer name(정규화된 도메인 이름)을 모두 확인하십시오. 이 중 후자가 네트워크를 통한 보안 연결에 Enterprise Server에서 사용됩니다.

Enterprise Server의 사이트 바인딩을 기본값과 다른 포트 번호를 사용하도록 편집한 경우, 그 변경 사항은 Enterprise Server의 LocalVault.ini 파일에도 반영해야 합니다. 이는 Altium Designer가 Enterprise Server에 연결할 때 해당 포트 참조를 사용하기 때문입니다. LocalVault.ini 파일은 Enterprise Server 설치의 루트 폴더에 있으며, 일반적으로 Program Files (x86)\Altium\Altium365 입니다.

예를 들어, Enterprise Server의 사이트 바인딩을 HTTPS 연결용 표준 443 포트를 사용하도록 변경했다면, LocalVault.ini 파일의 해당 HttpsPort=9785 줄을 HttpsPort=443 으로 업데이트하십시오.

사이트 바인딩 재구성 시

Enterprise Server에 새 IIS 사이트 바인딩을 추가했거나 기존 사이트 바인딩 항목을 편집한 경우(위 참조), 새 구성을 올바르게 적용하려면 서버 PC를 재시작해야 합니다. 일반적인 사이트 바인딩 변경 사례로는 호스트 항목의 포트 번호 편집 또는 도메인 별칭용 새 바인딩 추가가 있습니다.

서버 호스트 머신을 재시작하기 어려운 경우에는 대안으로 IIS 플랫폼에서 서버 서비스(Manage Website 아래의 Restart)를 재시작하고, Altium DXP App Server Pinger 서비스(Windows 서비스)도 함께 재시작하면 됩니다.

HTTPS를 통한 액세스

Enterprise Server와 보안 연결을 설정하려면 다음과 같이 하십시오.

• Altium Designer에서 – HTTPS 접두사가 붙은 서버 주소와 구성된 HTTPS 포트를 사용합니다. 기본적으로 이는 https://<computername>:9785 입니다([computername] 는 호스트 머신의 컴퓨터 이름 또는 정규화된 도메인 이름).

  Altium Designer에는 별도의 조치 없이 Enterprise Server에 대한 HTTPS 연결을 수락하는 데 필요한 보안 지원이 포함되어 있습니다.

• 브라우저에서 – 호스트 컴퓨터 이름 서비스의 주소를 입력합니다(https://<computername>:9785).

  Enterprise Server용으로 생성된 자체 서명 Identity Certificate를 계속 사용하기로 한 경우, 브라우저는 연결이 안전하지 않거나 비공개가 아니라는 경고를 표시합니다. 계속 진행하려면 브라우저에서 이를 수락할 수 있습니다. 일부 브라우저(예: Firefox)는 인증서를 영구적으로 수락하는 옵션을 제공하므로 이후에는 추가 조치가 필요하지 않습니다.

네트워크

기본 포트

Enterprise Server에서는 다음 기본 통신 포트 번호를 사용합니다.

• HTTP Port – 9780

• HTTPS Port – 9785

• LDAP Synchronisation Service Port – 9791

  LDAP 서비스 포트는 실제로는 사용되지 않습니다. 표준 LDAP(URL이 ldap:// 인 경우)에서는 이 URL의 포트를 사용합니다. 보안 LDAP(URL이 ldaps:// 인 경우)에서는 포트 636 가 사용됩니다.

• Websocket Port – 4649

  /websocket/WebService.asmx 는 API 호출용 HTTP SOAP 엔드포인트이므로, 다른 API 엔드포인트와 마찬가지로 HTTPS 포트(기본값은 9785)를 사용한다는 점에 유의하십시오.

• Firebird Server Port – 3050

• SVN Port – 3690

• Elasticsearch Ports – 9200 및 9300

목록의 처음 세 항목은 Installer의 Altium On-Prem Enterprise Server Configuration 페이지에서 초기 설치 중 구성할 수 있습니다.

포트를 선택할 때는 다른 애플리케이션에서 사용하는 포트와 충돌하지 않도록 주의해야 합니다. 포트가 현재 사용 중이면 설치 프로그램이 알려줍니다.

 Altium Design software의 포트 및 IP 주소 정보도 참조하십시오.

서비스 간 통신에 사용되는 프로토콜

HTTP 상의 SOAP.

AltiumLive Identity Subsystem 연결

AltiumLive Identity subsystem에 대한 연결은 기본적으로 HTTPS를 통해 수행되며, C:\Program Files (x86)\Altium\Altium365 폴더(기본 설치 기준)에 있는 LocalVault.ini 파일의 IdentityCloudServiceUrl 항목은 기본적으로 https://ids.api.altium.com/ids?cls=soap 로 설정됩니다.

Platform API 구성

Platform API의 일부 응답은 초기 구성 시 설정한 WebsiteDomain을(를) 기반으로 URL을 반환합니다. 드문 경우지만(예: 서버가 로드 밸런서나 프록시 뒤에 있는 경우) 이러한 URL이 동작하지 않을 수 있습니다. 이 문제를 해결하려면 LocalVault.ini 파일(기본 설치에서는 C:\Program Files (x86)\Altium\Altium365 폴더에 위치)의 [PublicServices] 섹션 아래에 있는 FilesServiceUrl 항목을 업데이트하십시오. 이 항목의 값은 <PubliclyAccessibleUrl>/napi/files로 설정해야 하며, 여기서 <PubliclyAccessibleUrl>는 Enterprise Server 외부에서 접근 가능한 외부 URL입니다.

기본 설치 경로

다음은 Enterprise Server 설치 시의 기본 설치 경로 목록입니다:

• Enterprise Server Installation Folder – \Program Files (x86)\Altium\Altium365.

• Firebird Installation Folder – \Program Files\Firebird\Firebird_3_0.

• Firebird Database – \ProgramData\Altium\Altium365Data\DXPSERVER.DAT.

• Revision Files Folder – \ProgramData\Altium\Altium365Data\Revisions.

• Search Index Data Folder – \ProgramData\Altium\Altium365Data\SearchData.

서비스 아키텍처 – 개요

Enterprise Server는 여러 핵심 서비스와 브라우저 기반 관리 콘솔, 그리고 Explorer(이 역시 브라우저 기반)를 설치합니다. 이러한 서비스에 액세스하려면 사용자의 신원이 인식되고 인증되어야 합니다. Enterprise Server에는 사전 정의된 사용자 하나가 포함되어 있습니다(Username: admin, Password: admin). Enterprise Server Workspace의 브라우저 기반 인터페이스에 있는 Users 페이지를 사용하여 더 많은 사용자를 추가하고 관리할 수 있습니다. Enterprise Server에 등록하여 액세스하고 사용할 수 있는 사용자 수에는 제한이 없지만, 동시 연결 수에는 필요한 라이선스에 따라 결정되고 적용되는 제한이 있습니다.

Altium Designer는 다음 서비스와 통신할 때 암호화되지 않은 채널(SOAP over HTTP)을 사용합니다:

• Applications Registry Service (Network Installation Service가 확장 프로그램/업데이트의 소스로 사용되는 경우)

• Collaboration Service

• Comments Service

• Data Acquisition Service

• Data Storage Service (DSS)

• Identity Service (IDS)

• Notifications Service

• Part Catalog Service

• Projects Service

• Simple Lock Service (SLS)

• SVN (SVN:// 프로토콜을 통해)

• Tasks Service

• Team Configuration Service (TC2)

• Vault Service

그 외의 모든 서비스는 서로 통신합니다.

대부분의 서비스는 해당 서비스에 적용되는 데이터를 저장하기 위해 동일한 Enterprise Server 데이터베이스에 액세스해야 합니다. 다음은 이러한 서비스 중 일부가 저장하는 데이터의 예입니다:

• Part Catalog Service – 공급업체 및 제조업체 항목, 가격 및 수량 이력 변경 사항 등을 저장합니다...

• Identity Service – 사용자, 그룹, 라이선스 구성 및 세션 정보를 저장합니다.

• Vault Service – 자체 구조(폴더, 항목, 리비전, 콘텐츠 유형, 라이프사이클 상태 등...)를 저장합니다.

실제 문서는 파일 시스템의 Revisions 폴더(\ProgramData\Altium\Altium365Data\Revisions)에 저장됩니다.

다음 브라우저 기반 애플리케이션은 해당 서비스와 통신하기 위해 SOAP API를 사용합니다. 이들은 Enterprise Server 데이터베이스에 대한 액세스가 필요하지 않으며, 동작을 위해 다른 파일도 필요하지 않습니다:

• User Management – Enterprise Server Workspace 브라우저 인터페이스의 Users 페이지 및 하위 페이지를 구동하는 애플리케이션입니다.

• Vault Explorer – Enterprise Server Workspace 브라우저 인터페이스의 Explorer 페이지를 구동하는 애플리케이션입니다.

• Catalog Management – Enterprise Server Workspace 브라우저 인터페이스의 Part Providers 페이지를 구동하는 애플리케이션입니다.

• Projects Management – Enterprise Server Workspace 브라우저 인터페이스의 Projects 페이지를 구동하는 애플리케이션입니다.

• TC2 Console – Enterprise Server Workspace 브라우저 인터페이스의 Configurations 페이지를 구동하는 애플리케이션입니다.

운영

서버 데이터 백업/복원

Enterprise Server 데이터의 백업 및 복원은 전용 Backup & Restore Tool을 사용하여 명령줄에서 자동으로 수행됩니다. 이 도구인 avbackup.exe은(는) \Program Files (x86)\Altium\Altium365\Tools\BackupTool\ 폴더(Enterprise Server 기본 설치 기준)에서 찾을 수 있습니다.

자세한 내용은 Backing up & Restoring Your Installation 페이지를 참조하십시오.

데이터 마이그레이션 후 서버 콘텐츠 재인덱싱

예를 들어 데이터 마이그레이션 후 Enterprise Server 콘텐츠를 다시 인덱싱하려면 다음과 같이 하십시오:

1. Enterprise Server와 연결된 모든 IIS 애플리케이션 풀을 중지합니다.

2. Elasticsearch (AltiumElasticSearch) 서비스를 중지합니다. 이는 Windows Services 패널에서 수행하며, 해당 패널은 Windows의 Administrative Tools 창에서 액세스할 수 있습니다.

3. 검색 인덱싱 데이터가 포함된 SearchData 폴더의 내용을 삭제합니다(기본 설치의 경우 \ProgramData\Altium\Altium365Data\SearchData).

4. Elasticsearch (AltiumElasticSearch) 서비스를 다시 시작합니다.

5. Enterprise Server와 연결된 IIS 애플리케이션 풀을 다시 시작합니다.

SearchData 폴더가 비어 있는 것이 확인되면 Enterprise Server는 시작 후 콘텐츠를 다시 인덱싱합니다.

Java 힙 크기 증가

Java 힙 크기가 부족하면 컴포넌트 검색 인덱스가 손상되어 Altium Designer에서 컴포넌트 데이터를 사용할 수 없게 될 수 있습니다. 검색 인덱스 문제가 있는 경우(Health Monitor Status Report의 로그에 SearchService Schema not found: 'vault1ex2_04 오류가 있는 경우), Java 힙 크기 증가를 고려하십시오.

현재 Java 힙 크기는 Enterprise Server를 호스팅하는 시스템에서 http://localhost:9200/_cat/nodes?h=heap*&v을(를) 열어 확인할 수 있습니다. heap.max 값이 약 1GB라면 아래 설명에 따라 이 값을 늘리십시오.

1. 관리자 모드로 명령 프롬프트를 실행합니다.

2. 다음 명령을 실행합니다:

   "C:\Program Files (x86)\Altium\Altium365\Services\ElasticSearch\bin\service-nexus-server.bat" manager AltiumElasticsearch

3. 열리는 대화상자의 Java 탭에서 다음과 같이 변경합니다:

   • Java Options 필드에서 -Xms1g 및 -Xmx1g 항목을 제거합니다.

   • Initial memory pool 및 Maximum memory pool 필드의 값을 4096(으)로 업데이트합니다.

     Java 힙 크기를 4GB가 아닌 다른 값으로 늘리는 경우 Initial memory pool 및 Maximum memory pool 옵션도 그에 맞게 변경하십시오(예: 크기를 6GB로 늘리는 경우 6144 지정).

   

4. 대화상자에서 Apply 및 OK을(를) 클릭합니다.

5. Windows Services 패널(Windows의 Administrative Tools 창에서 액세스)에서 AltiumElasticsearch 서비스를 다시 시작합니다.

6. http://localhost:9200/_cat/nodes?h=heap*&v 을(를) 열고 heap.max 매개변수 값을 확인하여 변경 사항이 적용되었는지 검증합니다.

필터 범주별 최대 컴포넌트 매개변수 값 구성

MaxHitsPerFacet 구성 옵션을 [Search] 파일의 LocalVault.ini 섹션에 추가할 수 있습니다. 지정한 값은 컴포넌트를 검색할 때 Altium Designer의 Components panel의 Filters 창에서 카테고리별로 표시되는 개별 항목(체크박스 포함)의 수를 제한합니다. 관리자의 경우 이 값을 낮추면 필터 카테고리별 결과 수가 줄어들어 검색 서비스의 부하를 크게 줄이고 검색 성능을 향상시킬 수 있습니다.

Allowed URL Segment Length 늘리기

Altium Designer에서 Release & Publish to PLM 기능을 사용하려면(자세히 알아보기), Enterprise Server가 설치된 컴퓨터의 Windows에서 레지스트리 업데이트가 필요합니다. 관리자 권한으로 실행한 Windows 명령 창(CMD)에서 다음을 실행하십시오.

reg add "HKLM\SYSTEM\CurrentControlSet\Services\HTTP\Parameters" /v UrlSegmentMaxLength /t REG_DWORD /d 2048

이 변경은 허용되는 URL 세그먼트 길이를 늘리며, 이는 시스템 기능을 지원하는 데 필요합니다. 이 변경을 적용한 후에는 수정 사항이 적용되도록 반드시 컴퓨터를 다시 시작해야 합니다.