Thông tin dành cho bộ phận CNTT

Mặc dù việc cài đặt và sử dụng Altium On-Prem Enterprise Server cùng các dịch vụ liên quan đã được trình bày chi tiết trên các trang khác trong trang tài liệu này, mục đích của trang này là cung cấp một nguồn tài liệu duy nhất và chi tiết dành cho bộ phận CNTT của tổ chức. Đây là nơi để tìm câu trả lời cho những câu hỏi thường gặp liên quan đến công nghệ này, bao gồm:

• 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?

Các phần sau đây cung cấp câu trả lời chi tiết cho những câu hỏi này và các câu hỏi khác, bao gồm tổng quan cấp cao về kiến trúc và luồng dữ liệu.

Cấu hình IIS

Trong quá trình cấu hình IIS, ISAPI Extensions tính năng này đã được kích hoạt. Tính năng này có thể được tìm thấy trong \Internet Information Services\World Wide Web Services\Application Development Features phần của Windows Features hộp thoại – truy cập từ cửa sổ Programs and Features .

Việc cài đặt Enterprise Server sẽ kích hoạt tính năng Windows ISAPI Extensions, một phần của cấu hình IIS.

Hỗ trợ giao thức HTTPS

Enterprise Server cung cấp khả năng giao tiếp an toàn qua mạng bằng cách sử dụng giao thức HTTPS để bảo vệ tính riêng tư và tính toàn vẹn của dữ liệu.

Cấu hình chứng chỉ

Đối với cài đặt mới, Enterprise Server cung cấp chứng chỉ tự ký được tạo và cấu hình trong IIS. Vì lý do bảo mật, bạn nên tạo chứng chỉ của riêng mình (bằng các công cụ tiêu chuẩn/ưa thích) rồi cấu hình chứng chỉ này trong IIS. Bạn có thể tạo yêu cầu chứng chỉ và gửi yêu cầu đó đến một cơ quan cấp chứng chỉ (CA) đáng tin cậy như VeriSign hoặc GeoTrust, hoặc lấy chứng chỉ từ một CA trực tuyến trong miền intranet của bạn. Tham khảo trang “Cách thiết lập SSL trên IIS 7 trở lên” trong tài liệu của Microsoft để biết thêm chi tiết.

Cấu hình HTTPS

Có thể truy cập cấu hình và liên kết máy chủ cho Enterprise Server từ bảng điều khiển Windows Internet Information Services (IIS) Manager – có sẵn từ cửa sổ Administration Tools (Control Panel\System and Security\Administrative Tools). Chọn mục 'Altium On-Prem Enterprise Server' trong danh sách Connections danh sách của bảng điều khiển, sau đó chọn tab Features View tab.

Truy cập các thiết lập cấu hình và liên kết máy chủ cho Enterprise Server.

Các cổng và tên máy chủ có sẵn cho Enterprise Server được hiển thị dưới dạng các liên kết có thể chọn trong Actions khung. Sử dụng các liên kết này để ghi lại và kiểm tra các giao thức kết nối máy chủ, hoặc truy cập các liên kết tên/cổng hiện tại bằng cách chọn Bindings liên kết trong Edit Site phần của khung.

Một thiết lập liên kết, bao gồm số cổng giao thức của nó, có thể được chỉnh sửa từ Site Bindings hộp thoại thông qua nút Edit nút này.

Cấu hình các kết nối thông qua Site Bindings hộp thoại.

Lưu ý rằng tên máy chủ localhost chỉ áp dụng cho máy cục bộ, do đó các máy tính other khác với máy chủ đang chạy Enterprise Server cần sử dụng tên (máy chủ) thực tế của máy chủ đó để kết nối.

Để xác nhận tên của máy chủ nơi Enterprise Server được cài đặt và đang chạy, trên máy đó, hãy truy cập Control Panel\System and Security\System và ghi lại cả Computer name và Full computer name (tên miền đầy đủ của nó) – tên miền đầy đủ này sẽ được Enterprise Server sử dụng để thiết lập các kết nối an toàn qua mạng.

Nếu bạn đã chỉnh sửa các ràng buộc trang web của Enterprise Server để sử dụng số cổng khác với giá trị mặc định, thay đổi đó cũng cần được phản ánh trong tệp LocalVault.ini của Enterprise Server. Điều này là do các tham chiếu cổng của nó được truy cập khi Altium Designer thiết lập kết nối với Enterprise Server. Tệp LocalVault.ini có thể được tìm thấy trong thư mục gốc của bản cài đặt Enterprise Server – thường là Program Files (x86)\Altium\Altium365.

Ví dụ: nếu bạn đã thay đổi liên kết trang web của Enterprise Server để sử dụng cổng tiêu chuẩn 443 cho các kết nối HTTPS, hãy cập nhật dòng tương ứng HttpsPort=9785 trong LocalVault.ini tệp thành HttpsPort=443.

Khi cấu hình lại các liên kết trang web

Nếu bạn đã thêm một liên kết trang web IIS mới cho Enterprise Server hoặc đã chỉnh sửa một mục liên kết trang web hiện có (xem phần trên), máy chủ PC cần được khởi động lại để thiết lập cấu hình mới một cách chính xác. Các thay đổi thông thường đối với liên kết trang web có thể bao gồm việc chỉnh sửa số cổng cho một mục máy chủ hoặc thêm một liên kết mới cho một tên miền bí danh.

Khi không thể khởi động lại máy chủ, quy trình thay thế là khởi động lại dịch vụ máy chủ trên nền tảng IIS – Restart trong Manage Website – và cũng khởi động lại Altium DXP App Server Pinger dịch vụ (một dịch vụ Windows).

Truy cập qua HTTPS

Để thiết lập kết nối an toàn với Enterprise Server:

• Từ Altium Designer – sử dụng địa chỉ máy chủ có tiền tố HTTPS và cổng HTTPS đã được cấu hình. Theo mặc định, đây là https://:9785 (trong đó [computername] là Tên máy chủ hoặc tên miền đầy đủ của máy chủ).

  Altium Designer đã tích hợp sẵn các tính năng bảo mật cần thiết để chấp nhận kết nối HTTPS với Enterprise Server mà không cần can thiệp thủ công.

• Từ trình duyệt – nhập địa chỉ của dịch vụ tên máy chủ (https://:9785).

  Nếu bạn chọn giữ lại Chứng chỉ Danh tính tự ký được tạo cho Enterprise Server, trình duyệt của bạn sẽ cảnh báo rằng kết nối này không an toàn/riêng tư. Bạn có thể chọn chấp nhận trong trình duyệt để tiếp tục. Một số trình duyệt (ví dụ: Firefox) cung cấp tùy chọn chấp nhận chứng chỉ vĩnh viễn để không cần thực hiện thêm bất kỳ thao tác nào nữa.

Cổng mạng

Cổng mặc định

Máy chủ Enterprise sử dụng các số cổng giao tiếp mặc định sau:

• HTTP Port – 9780

• HTTPS Port – 9785

• LDAP Synchronisation Service Port – 9791

• Websocket Port – 4649

  Lưu ý rằng /websocket/WebService.asmx là một điểm cuối HTTP SOAP dành cho các cuộc gọi API, do đó, giống như các điểm cuối API khác, nó sử dụng cổng HTTPS (9785 theo mặc định).

• Firebird Server Port – 3050

• SVN Port – 3690

• Elasticsearch Ports – 9200 và 9300

Ba mục đầu tiên trong danh sách có thể được cấu hình trong quá trình cài đặt ban đầu, trên Altium On-Prem Enterprise Server Configuration trang của Trình cài đặt.

Khi chọn cổng, lưu ý rằng cổng đó không được trùng với bất kỳ cổng nào đang được các ứng dụng khác sử dụng – nếu một cổng hiện đang được sử dụng, trình cài đặt sẽ thông báo cho bạn.

Xem thông tin vềcổng và địa chỉ IP cho phần mềm Altium Design.

Giao thức được sử dụng cho giao tiếp giữa các dịch vụ

SOAP qua HTTP.

Lưu trữ dữ liệu

Đường dẫn cài đặt mặc định

Dưới đây là danh sách các đường dẫn cài đặt mặc định khi cài đặt 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.

Kho lưu trữ thiết kế SVN cục bộ – Lưu trữ

Kho thiết kế được tạo thông qua Dịch vụ Kiểm soát Phiên bản cục bộ sẽ lưu trữ dữ liệu nội bộ của nó trong một thư mục con tương ứng trong thư mục \ProgramData\Altium\Altium365Data\Repository thư mục (đối với cài đặt mặc định của Enterprise Server).

Kiến trúc Dịch vụ – Tổng quan

Enterprise Server cài đặt một số dịch vụ cốt lõi, cũng như các bảng điều khiển quản lý dựa trên trình duyệt và một trình khám phá (cũng dựa trên trình duyệt). Để truy cập bất kỳ dịch vụ nào trong số này, danh tính của người dùng phải được nhận diện và xác thực. Enterprise Server đi kèm với một người dùng được định nghĩa sẵn (Username: admin, Password: admin). Trang Users trang của giao diện dựa trên trình duyệt trong Enterprise Server Workspace có thể được sử dụng để thêm và quản lý thêm người dùng. Không có giới hạn về số lượng người dùng có thể đăng ký để truy cập và sử dụng Enterprise Server, nhưng có giới hạn về số kết nối đồng thời, được xác định và áp dụng theo giấy phép bắt buộc.

Altium Designer sử dụng kênh không được mã hóa (SOAP qua HTTP) để giao tiếp với các dịch vụ sau:

• Applications Registry Service (khi Dịch vụ Cài đặt Mạng được sử dụng làm nguồn cho các tiện ích mở rộng/bản cập nhật)

• 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 (thông qua SVN:// giao thức)

• Tasks Service

• Team Configuration Service (TC2)

• Vault Service

Tất cả các dịch vụ khác đều giao tiếp với nhau.

Phần lớn các dịch vụ yêu cầu quyền truy cập vào cùng một cơ sở dữ liệu Enterprise Server, nơi lưu trữ dữ liệu liên quan đến chúng. Dưới đây là các ví dụ về dữ liệu được lưu trữ bởi một số dịch vụ này:

• Part Catalog Service – lưu trữ các mặt hàng của nhà cung cấp và nhà sản xuất, lịch sử thay đổi về giá và số lượng, v.v...

• Identity Service – lưu trữ thông tin về người dùng, nhóm, cấu hình giấy phép và thông tin phiên làm việc.

• Vault Service – lưu trữ cấu trúc của nó (thư mục, mục, bản sửa đổi, loại nội dung, trạng thái vòng đời, v.v...).

Các tài liệu thực tế được lưu trữ trên hệ thống tệp, trong thư mục Revisionthư mục (\ProgramData\Altium\Altium365Data\Revisions).

Các ứng dụng dựa trên trình duyệt sau đây sử dụng API SOAP để giao tiếp với các dịch vụ tương ứng – chúng không yêu cầu quyền truy cập vào cơ sở dữ liệu Enterprise Server, cũng như không cần bất kỳ tệp nào khác để hoạt động:

• User Management – ứng dụng phía sau Users trang và các trang con trong giao diện trình duyệt của Enterprise Server Workspace.

• Vault Explorer – ứng dụng phía sau Explorer trang của giao diện trình duyệt Enterprise Server Workspace.

• Catalog Management – ứng dụng phía sau Part Providers trang của giao diện trình duyệt Enterprise Server Workspace.

• Projects Management – ứng dụng phía sau Projects trang của giao diện trình duyệt Enterprise Server Workspace.

• TC2 Console – ứng dụng phía sau Configurations trang của giao diện trình duyệt Enterprise Server Workspace.

Hoạt động

Sao lưu/Khôi phục dữ liệu máy chủ

Việc sao lưu và khôi phục dữ liệu Enterprise Server của bạn được thực hiện từ dòng lệnh, theo cách tự động, bằng cách sử dụng Công cụ Sao lưu & Khôi phục chuyên dụng. Công cụ này – avbackup.exe – có thể tìm thấy trong thư mục \Program Files (x86)\Altium\Altium365\Tools\BackupTool\ (đối với cài đặt mặc định của Enterprise Server).

Tham khảo trangSao lưu và khôi phục cài đặt của bạn để biết thêm chi tiết.

Lập chỉ mục lại nội dung máy chủ sau khi di chuyển dữ liệu

Để lập chỉ mục lại nội dung Enterprise Server, ví dụ như sau khi di chuyển dữ liệu:

1. Dừng tất cả các nhóm ứng dụng IIS liên quan đến Enterprise Server.

2. Dừng Elasticsearch (AltiumElasticSearch) dịch vụ này. Thao tác này được thực hiện từ Services – truy cập từ cửa sổ Administrative Tools .

3. Xóa nội dung của thư mục SearchData thư mục, nơi chứa dữ liệu lập chỉ mục tìm kiếm (\ProgramData\Altium\Altium365Data\SearchData trong trường hợp cài đặt mặc định).

4. Khởi động lại Elasticsearch (AltiumElasticSearch) dịch vụ.

5. Khởi động lại các nhóm ứng dụng IIS liên quan đến Enterprise Server.

Khi phát hiện thấy SearchData thư mục trống, Enterprise Server sẽ lập chỉ mục lại nội dung của nó ngay khi khởi động.

Tăng kích thước bộ nhớ đệm Java

Kích thước bộ nhớ đống Java không đủ có thể làm hỏng chỉ mục tìm kiếm thành phần và khiến dữ liệu thành phần không thể truy cập được từ Altium Designer. Nếu bạn gặp sự cố với chỉ mục tìm kiếm ( Báo cáo trạng thái Health Monitor hiển thị lỗi SearchService Schema not found: 'vault1ex2_04 trong nhật ký), hãy cân nhắc tăng kích thước bộ nhớ đống Java.

Bạn có thể kiểm tra kích thước bộ nhớ heap Java hiện tại bằng cách mở http://localhost:9200/_cat/nodes?h=heap*&v trên máy chủ Enterprise Server. Nếu heap.max giá trị này khoảng 1 GB, hãy tăng giá trị này theo hướng dẫn dưới đây.

1. Chạy Command Prompt ở chế độ quản trị viên.

2. Chạy lệnh sau:

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

3. Trên Java của hộp thoại vừa mở ra, thực hiện các thay đổi sau:

   • Trong Java Options , cập nhật -Xms1g bằng -Xms4g và cập nhật -Xmx1g bằng -Xmx4g.

   • Cập nhật các giá trị trong Initial memory pool và Maximum memory pool các trường bằng 4096.

   Khi tăng kích thước heap của Java lên một giá trị khác với 4 GB, hãy điều chỉnh các tùy chọn trên cho phù hợp (ví dụ: cập nhật các tùy chọn Java bằng -Xms6g và -Xmx6g và chỉ định 6144 cho Initial memory pool và Maximum memory pool nếu bạn đang tăng kích thước lên 6 GB).

   

4. Nhấp Apply và OK trong hộp thoại.

5. Từ Services (truy cập từ cửa sổ Administrative Tools ), khởi động lại AltiumElasticsearch dịch vụ.

6. Kiểm tra xem các thay đổi đã được áp dụng chưa bằng cách mở http://localhost:9200/_cat/nodes?h=heap*&v và kiểm tra heap.max giá trị tham số.