Tích hợp lai áp dụng cho trường hợp một công ty sử dụng Altium 365 muốn tích hợp Workspace của mình với một hệ thống PLM được lưu trữ on-premises, bên trong mạng của công ty, không có địa chỉ IP công khai – tức là không được đưa ra internet.
Để thực hiện việc này, một chương trình nhỏ có tên là Hybrid Agent sẽ chạy bên trong mạng của công ty. Chương trình này giao tiếp với Altium 365, chuyển tiếp thông tin giữa Altium 365 Workspace và hệ thống PLM nằm trong mạng khép kín. Việc giao tiếp với Hybrid Agent diễn ra qua HTTPS và không cần mở bất kỳ cổng mạng nào cho lưu lượng đi vào từ internet. Chỉ cần cổng HTTPS tiêu chuẩn 443 cho lưu lượng đi ra.
Thiết lập Hybrid Integration
Tải xuống gói lưu trữ Agent (
) và giải nén nội dung của nó vào một vị trí đã biết. Gói này chứa một ứng dụng Java (hybrid-agent.jar) cần được chạy trên một máy nằm trong mạng của công ty, từ đó có thể truy cập được hệ thống PLM on-premises và Altium 365.
Máy đó not không cần phải có thể truy cập công khai từ internet, nhưng cần có khả năng kết nối với môi trường Altium 365 mà công ty bạn đang sử dụng.
-
Lưu ý rằng Hybrid Agent notkhông cần phải chạy trên máy đang lưu trữ hệ thống PLM, mặc dù cách thiết lập như vậy cũng không gây ra vấn đề gì.
-
Ứng dụng Hybrid Agent bao gồm các tệp shell script tương đương (chẳng hạn như
agent.sh) cho các hệ thống chạy Linux – hãy dùng chúng thay cho các tệp Windows *.bat trong hướng dẫn thiết lập agent bên dưới.
Hybrid Agent yêu cầu Java Development Kit (JDK) phiên bản 11 trở lên.
Installing JDK
Có thể sử dụng Oracle JDK hoặc OpenJDK. Hãy bảo đảm bạn có giấy phép hợp lệ khi sử dụng Oracle JDK.
Nếu cài đặt JDK từ một gói lưu trữ thuần túy (thay vì một tệp thực thi cài đặt), thì các biến môi trường đường dẫn của nó cần được thêm vào. Với máy/VM Windows, các biến này thường là:
-
PATH – trỏ đến thư mục bin của bản cài đặt.
-
JAVA_HOME – trỏ đến chính thư mục cài đặt.
Kiểm tra quyền truy cập tới tệp thực thi Java bằng cách chạy lệnh Java -version.
Sau khi ứng dụng Hybrid Agent đã được đặt đúng chỗ:
-
Tạo API key trong trang Hybrid Agent của Altium 365 Workspace (
).
-
Tạo một biến môi trường
HYBRID_AGENT_API_KEY với giá trị là API key đó.
-
Chạy agent.bat bằng ngữ cảnh lệnh sau, trong đó đối số tham số URL phải là URL của Altium 365 Workspace của bạn:
agent.bat https://acme.365.altium.com
Khi hoạt động, Hybrid Agent sẽ tạo một tệp nhật ký trong thư mục hybrid-agent\logs của ứng dụng.
Lưu ý rằng Workspace chỉ có một API Key hợp lệ tại một thời điểm, và chỉ một phiên bản duy nhất của Hybrid Agent có thể chạy. Agent sẽ hỗ trợ nhiều hơn một phiên bản cấu hình PLM nếu cả hai hệ thống PLM đều được lưu trữ trong cùng một mạng khép kín.
Rất khuyến nghị chạy Hybrid Agent như một dịch vụ Windows trong môi trường production thay vì chạy trực tiếp trong terminal, mặc dù cách sau có thể dùng để kiểm thử.
Một ví dụ về cách chạy Hybrid Agent như một dịch vụ Windows bằng trình quản lý dịch vụ NSSM:
-
Chạy lệnh:
nssm install HybridAgent.
-
Trong cửa sổ hộp thoại NSSM (ở tab Application), nhập đường dẫn tệp
agent.bat vào trường Path và URL Workspace của bạn vào trường Arguments, rồi nhấp vào Install service.
-
Bạn có thể thiết lập hành vi khởi động của dịch vụ bằng tùy chọn Startup type trong tab Details của hộp thoại NSSM. Nếu cần, hãy chạy
nssm edit HybridAgent để thực hiện các thay đổi đó.
-
Như một phương án thay thế cho việc tạo các biến môi trường chuẩn
PATH và JAVA_HOME cho Java, chúng có thể được thêm trong tab Environment của NSSM. Với cách này, các biến sẽ chỉ hoạt động khi dịch vụ HybridAgent đang chạy.
-
Tương tự như trên, biến HYBRID_AGENT_API_KEY cũng có thể được chuyển sang phần thiết lập môi trường của NSSM để nó hoạt động khi dịch vụ đang chạy.
-
Khởi động dịch vụ
HybridAgent bằng công cụ quản lý Services của Windows, hoặc bằng lệnh NSSM: nssm start HybridAgent. Việc này không cần thiết (sau khi khởi động lại PC) nếu dịch vụ được đặt tự động khởi động.
-
Đảm bảo dịch vụ
HybridAgent đang chạy trong công cụ quản lý Services của Windows, hoặc bằng lệnh NSSM: nssm status HybridAgent.
Sau khi Hybrid Agent đã kết nối với Altium 365 Workspace của bạn (làm mới cửa sổ trình duyệt để kiểm tra trạng thái), bạn có thể tiếp tục cấu hình PLM Integration trong Altium 365 Workspace. Trong trang Add Configuration, hãy bật tùy chọn kết nối Hybrid Agent và nhập URL của hệ thống PLM on-premises của bạn, như được nhìn thấy bên trong mạng khép kín của bạn, vào trường URL.
API Key hiện tại có thể bị hủy bằng lệnh Revoke tương ứng của nó. Khi đó, cần tạo một API Key mới và cập nhật biến môi trường HYBRID_AGENT_API_KEY bằng giá trị Key mới.
Khởi động lại Hybrid Agent để sử dụng Key mới – với NSSM, dùng lệnh nssm restart HybridAgent, hoặc dừng/khởi động dịch vụ HybridAgent trong Services của Windows.
AI-localized