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

Trong khi 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ủa nó đã được trình bày chi tiết ở những trang khác trong bộ tài liệu này, mục đích của trang này là cung cấp một nguồn tham khảo duy nhất, đầy đủ dành cho bộ phận IT 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 về 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 dưới đây cung cấp câu trả lời chi tiết cho những câu hỏi này và nhiều câu hỏi khác, bao gồm cả phần tổng quan kiến trúc và luồng dữ liệu ở mức cao.

Cấu hình IIS

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

Việc cài đặt Enterprise Server sẽ kích hoạt tính năng Windows ISAPI Extensions, là 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 liên lạc an toàn qua mạng bằng giao thức HTTPS để bảo vệ tính riêng tư và 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ự tạo chứng chỉ của riêng mình (bằng các công cụ tiêu chuẩn/ưu tiên của bạn) rồi cấu hình chứng chỉ đó trong IIS. Bạn có thể tạo yêu cầu cấp chứng chỉ và gửi yêu cầu đó đến một tổ chức chứng thực (CA) uy tín 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. Hãy tham khảo trang How to Set Up SSL on IIS 7 or later trong tài liệu của Microsoft để tìm hiểu thêm.

Cấu hình HTTPS

Cấu hình và các server binding của Enterprise Server có thể được truy cập từ bảng điều khiển Internet Information Services (IIS) Manager của Windows – 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 của bảng điều khiển, rồi chọn tab Features View.

Truy cập cấu hình và thiết lập server binding cho Enterprise Server.

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

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

Cấu hình binding thông qua hộp thoại Site Bindings.

Lưu ý rằng tên máy chủ localhost chỉ áp dụng cho máy cục bộ, vì vậy các PC other máy đang lưu trữ Enterprise Server cần sử dụng tên thực của máy chủ đó để kết nối.

Để xác nhận tên của PC chủ nơi Enterprise Server được cài đặt và đang chạy, trên máy đó hãy vào Control Panel\System and Security\System và ghi nhận cả Computer name lẫn Full computer name (tên miền đủ điều kiện của máy) – trong đó giá trị sau sẽ là giá trị được Enterprise Server sử dụng cho các kết nối bảo mật qua mạng.

Nếu bạn đã chỉnh sửa site binding của Enterprise Server để dùng số Port khác giá trị mặc định, thay đổi đó cũng cần được phản ánh trong tệp LocalVault.ini của Enterprise Server. Lý do là vì các tham chiếu cổng trong đó được truy cập khi Altium Designer kết nối đến Enterprise Server. Tệp LocalVault.ini nằm 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 site binding của Enterprise Server để dùng cổng 443 tiêu chuẩn cho các kết nối HTTPS, hãy cập nhật dòng HttpsPort=9785 tương ứng trong tệp LocalVault.ini thành HttpsPort=443.

Khi cấu hình lại Site Binding

Nếu bạn đã thêm một IIS Site Binding mới cho Enterprise Server, hoặc chỉnh sửa một mục Site Binding hiện có (xem ở trên), nên khởi động lại PC máy chủ để thiết lập đúng cấu hình mới. Những thay đổi Site Binding điển hình có thể là chỉnh sửa số Port cho một mục host, hoặc thêm một binding mới cho bí danh miền.

Khi không tiện 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à đồng thời khởi động lại dịch vụ Altium DXP App Server Pinger (một dịch vụ Windows).

Truy cập qua HTTPS

Để thiết lập kết nối an toàn tớ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, đó là https://<computername>:9785 (trong đó [computername] là Computer Name hoặc tên miền đủ điều kiện của máy chủ).

  Altium Designer bao gồm sẵn hỗ trợ bảo mật cần thiết để chấp nhận kết nối HTTPS tới Enterprise Server mà không cần can thiệp thêm.

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

  Nếu bạn chọn giữ lại Identity Certificate 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 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) cho phép chấp nhận vĩnh viễn chứng chỉ này để không cần thao tác thêm về sau.

Mạng

Các cổng mặc định

Các số cổng giao tiếp mặc định sau đây được Enterprise Server sử dụng:

• HTTP Port – 9780

• HTTPS Port – 9785

• LDAP Synchronisation Service Port – 9791

• Websocket Port – 4649

  Lưu ý rằng /websocket/WebService.asmx là một endpoint SOAP HTTP cho các lệnh gọi API, vì vậy, giống như các endpoint API khác, nó dùng cổng HTTPS (mặc định là 9785).

• 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 trang Altium On-Prem Enterprise Server Configuration của trình cài đặt.

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

Xem thêm thông tin về các cổng và địa chỉ IP cho phần mềm thiết kế Altium.

Giao thức dùng cho truyền thông 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

Sau đâ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ữ

Một Design Repository được tạo thông qua dịch vụ Version Control cục bộ sẽ có dữ liệu nội bộ được lưu trong thư mục con tương ứng trong thư mục \ProgramData\Altium\Altium365Data\Repository (đối với bản cài đặt Enterprise Server mặc định).

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 với các bảng điều khiển quản trị chạy trên trình duyệt và một Explorer (cũng chạy trên trình duyệt). Để truy cập bất kỳ dịch vụ nào trong số này, danh tính người dùng phải được nhận diện và xác thực. Enterprise Server đi kèm một người dùng được định nghĩa sẵn (Username: admin, Password: admin). Trang Users trong giao diện chạy trên trình duyệt của Enterprise Server Workspace có thể được dùng để thêm và quản lý nhiều người dùng hơn. Không có giới hạn về số lượng người dùng có thể được đă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à thực thi theo giấy phép yêu cầu.

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

• Applications Registry Service (khi Network Installation Service được dùng làm nguồn cho phần mở rộng/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 giao thức SVN://)

• Tasks Service

• Team Configuration Service (TC2)

• Vault Service

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

Phần lớn các dịch vụ cần truy cập cùng một cơ sở dữ liệu Enterprise Server để lưu trữ dữ liệu áp dụng cho chúng. Sau đây là các ví dụ về dữ liệu được một số dịch vụ này lưu trữ:

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

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

• Vault Service – lưu cấu trúc của nó (thư mục, mục, phiên bản phát hành, 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ên hệ thống tệp, trong thư mục Revision (\ProgramData\Altium\Altium365Data\Revisions).

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

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

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

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

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

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

Vận hành

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ông cụ chuyên dụng Backup & Restore Tool. Công cụ này – avbackup.exe – có thể được tìm thấy trong thư mục \Program Files (x86)\Altium\Altium365\Tools\BackupTool\ (đối với bản cài đặt Enterprise Server mặc định).

Hãy tham khảo trang Backing up & Restoring Your Installation để tìm hiểu thêm.

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ụ sau khi di chuyển dữ liệu:

1. Dừng tất cả các IIS application pool liên quan đến Enterprise Server.

2. Dừng dịch vụ Elasticsearch (AltiumElasticSearch). Việc này được thực hiện từ bảng điều khiển Services của Windows – được truy cập từ cửa sổ Administrative Tools của Windows.

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

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

5. Khởi động lại các IIS application pool liên quan đến Enterprise Server.

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

Tăng kích thước Java Heap

Kích thước Java heap không đủ có thể làm hỏng chỉ mục tìm kiếm linh kiện và khiến dữ liệu linh kiện không khả dụng trong Altium Designer. Nếu bạn gặp vấn đề về chỉ mục tìm kiếm (báo cáo Health Monitor Status Report có lỗi SearchService Schema not found: 'vault1ex2_04 trong log), hãy cân nhắc tăng kích thước Java heap.

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

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 tab Java của hộp thoại mở ra, thực hiện các thay đổi sau:

   • Trong trường Java Options, cập nhật -Xms1g thành -Xms4g và cập nhật -Xmx1g thành -Xmx4g.

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

   Khi tăng kích thước Java heap lên một giá trị khác 4 GB, hãy thay đổi các tùy chọn ở trên tương ứng (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ừ bảng điều khiển Services của Windows (truy cập từ cửa sổ Administrative Tools của Windows), khởi động lại dịch vụ AltiumElasticsearch .

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