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 button을 통해 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]은 호스트 머신의 컴퓨터 이름 또는 정규화된 도메인 이름).

  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

• 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 소프트웨어의 포트 및 IP 주소에 대한 정보를 참조하십시오.

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

HTTP 상의 SOAP.

데이터 저장소

기본 설치 경로

다음은 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.

로컬 SVN 설계 리포지토리 – 저장소

로컬 Version Control Service를 통해 생성된 Design Repository는 (Enterprise Server 기본 설치 기준) 내부 데이터를 \ProgramData\Altium\Altium365Data\Repository 폴더의 해당 하위 폴더에 저장합니다.

서비스 아키텍처 – 개요

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

운영

서버 데이터 백업/복원

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

자세한 내용은 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 값이 약 1 GB 정도라면 아래 설명대로 이 값을 늘리십시오.

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

2. 다음 프롬프트를 실행합니다:

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

3. 열리는 대화상자의 Java 탭에서 다음 변경을 수행합니다:

   • Java Options 필드에서 -Xms1g를 -Xms4g로 업데이트하고, -Xmx1g를 -Xmx4g로 업데이트합니다.

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

   Java 힙 크기를 4 GB가 아닌 다른 값으로 늘리는 경우, 위 옵션도 그에 맞게 변경하십시오(예: 6 GB로 늘리는 경우 Java 옵션을 -Xms6g 및 -Xmx6g 로 업데이트하고, Initial memory pool 및 Maximum memory pool에 대해 6144를 지정).

   

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

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

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