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 구성

IIS 구성의 일부로 ISAPI Extensions 기능이 활성화됩니다. 이 기능은 \Internet Information Services\World Wide Web Services\Application Development Features 섹션의 Windows Features 대화상자에서 찾을 수 있으며, Windows의 Programs and 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의 구성 및 서버 바인딩은 Windows Internet Information Services (IIS) Manager 패널에서 접근할 수 있으며, Administration Tools 창(Control Panel\System and Security\Administrative Tools)에서 사용할 수 있습니다. 패널의 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 other에서는 연결을 위해 해당 호스트 머신의 실제(서버) 이름을 사용해야 합니다.

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 플랫폼에서 서버 서비스(Restart, Manage Website 아래)를 재시작하고, 또한 Altium DXP App Server Pinger 서비스(Windows 서비스)도 재시작하십시오.

HTTPS를 통한 접근

Enterprise Server에 대한 보안 연결을 설정하려면:

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

  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 Service Port는 실제로 사용되지 않습니다. 표준 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

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

포트를 선택할 때, 다른 애플리케이션에서 사용하는 포트와 충돌하지 않아야 한다는 점에 유의하십시오. 포트가 현재 사용 중이면 설치 프로그램이 알려줍니다.

Altium Design 소프트웨어의 포트 및 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입니다.

Default Installation Paths

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.

Service Architecture – Overview

Enterprise Server는 여러 핵심 서비스와 브라우저 기반 관리 콘솔, 그리고 Explorer(이 또한 브라우저 기반)를 설치합니다. 이러한 서비스 중 어떤 것에 접근하든 사용자의 신원이 인식되고 인증되어야 합니다. Enterprise Server에는 미리 정의된 사용자 1명이 포함되어 있습니다(Username: admin, Password: admin). Enterprise Server Workspace의 브라우저 기반 인터페이스에 있는 Users 페이지를 사용하여 더 많은 사용자를 추가하고 관리할 수 있습니다. Enterprise Server에 등록하여 접근 및 사용할 수 있는 사용자 수에는 제한이 없지만, 동시 연결 수는 필요한 라이선스에 의해 결정되고 강제되는 제한이 있습니다.

Altium Designer는 다음 서비스와 통신하기 위해 암호화되지 않은 채널(HTTP 상의 SOAP)을 사용합니다:

• 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 페이지를 담당하는 애플리케이션.

Operations

Backup/Restore of Server Data

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

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

Re-Indexing Server Content after Data Migration

예를 들어 데이터 마이그레이션 후 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는 시작 시 콘텐츠를 다시 인덱싱합니다.

Increasing Java Heap Size

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 매개변수 값을 확인하여 변경 사항이 적용되었는지 검증합니다.

Increasing the Allowed URL Segment Length

Altium Designer에서 Release & Publish to PLM 기능을 사용하려면(learn more) Enterprise Server가 설치된 머신에서 Windows 레지스트리 업데이트가 필요합니다. 관리자 권한이 있는 Windows 명령 창(CMD)에서 다음을 실행하십시오:

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

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