Cài bản dùng chung (IIS)

Bản dùng chung chạy trên IIS của một máy chủ trong công ty. Nhân viên mở trình duyệt trên máy của mình và đăng nhập bằng user SAP Business One của họ. Trang này dành cho IT của công ty.

Dành cho: IT của công ty
License: Dùng chung (Team)
Cần: Quyền Administrators trên máy chủ

Cách bản dùng chung hoạt động

Mỗi nhân viên đăng nhập bằng user SAP của chính họ. SAP AddOns ghi vào SAP chỉ qua Service Layer, bằng user đó, theo quyền và phê duyệt của SAP. Mật khẩu SAP của nhân viên không được lưu.
Không dùng DI API và cách đăng nhập “SAP đang mở trên máy này” (chỉ có ở bản cá nhân).
Nhóm Setting (kết nối công ty SAP, máy chủ database, License) chỉ hiện cho superuser SAP của công ty đang đăng nhập. Ngay trên máy chủ (https://localhost) thì luôn mở được, kể cả khi chưa đăng nhập SAP.
License dùng chung không dùng được cho bản cá nhân, và ngược lại: license cá nhân không dùng được trên IIS.

Điều kiện

Thành phần	Yêu cầu
Máy chủ	Windows Server 2016 trở lên (hoặc Windows 10 / 11), 64-bit.
IIS	Vai trò IIS (Web Server), sau đó cài ASP.NET Core Hosting Bundle cho .NET 10 của Microsoft (miễn phí, tại `https://dotnet.microsoft.com/download/dotnet/10.0` → Hosting Bundle). Cài IIS trước, Hosting Bundle sau.
SAP Business One	Có Service Layer. Bản dùng chung ghi vào SAP chỉ qua Service Layer.
Database (khuyên dùng)	Tài khoản database chỉ đọc (SQL Server hoặc SAP HANA) đọc được các database công ty: đọc nhanh hơn, dùng được mọi màn và chọn công ty từ danh sách. Không có thì một số màn bị giới hạn (xem dưới).
HTTPS	Chứng chỉ của công ty mang tên máy chủ (nên dùng), hoặc để script tạo chứng chỉ tự ký.
Internet	Máy chủ ra được Internet tới `https://license.tgblogs.site` (cổng 443, chiều đi) để kích hoạt và kiểm tra license. Không cần mở cổng nào cho bên ngoài vào. Có proxy: khai ở màn kích hoạt. Không được ra Internet: kích hoạt bằng file.

Nhân viên không đăng nhập vào máy chủ này

Ai mở SAP AddOns ngay trên máy chủ (https://localhost) đều sửa được Setting và License, kể cả khi không đăng nhập SAP. Chỉ IT được đăng nhập (Remote Desktop hay ngồi tại máy) vào máy chủ cài SAP AddOns. Nếu nhân viên làm việc qua Remote Desktop trên một máy chủ, cài bản dùng chung trên một máy chủ khác.

Khi không có máy chủ database

SAP AddOns vẫn đăng nhập và import qua Service Layer, nhưng:

Import theo lô / serial, xuất kho (gợi ý FEFO / FIFO): không dùng được.
Phiếu nhập kho, hàng bán trả lại có serial: không kiểm được serial đang ở kho nào; SAP kiểm khi ghi.
Phiếu thu / chi theo hóa đơn: chỉ hóa đơn một kỳ thanh toán; bút toán công nợ và hóa đơn nhiều kỳ không dùng được.
Hóa đơn từ phiếu giao, chứng từ không gốc: cột lô đã giao chỉ ghi “Theo phiếu giao hàng”.
Dữ liệu chủ: một số kiểm tra trước khi ghi bỏ qua, SAP báo lỗi khi ghi.
Đọc dữ liệu chậm hơn nhiều (ví dụ tìm chứng từ, kiểm tra file).

Có thể khai máy chủ database sau, ở Setting › Máy chủ database.

Cài đặt

Giải nénFile zip SAP AddOns trên máy chủ
Kiểm điều kiệnCai-dat-IIS.cmd -CheckOnly
Chạy script càiRun as administrator
Kích hoạt và thiết lậpTại https://localhost/ trên máy chủ

Giải nén file zip
Giải nén toàn bộ file zip SAP AddOns vào một thư mục trên máy chủ (không chạy trong file zip). Bản cá nhân và bản dùng chung dùng chung một file zip; các script cài IIS nằm trong thư mục iis, kèm HUONG-DAN-IIS.txt.
Kiểm điều kiện trước (không thay đổi gì)
Mở PowerShell và chạy:
```
<thư mục giải nén>\iis\Cai-dat-IIS.cmd -CheckOnly
```
Script liệt kê từng điều kiện còn thiếu và cách sửa. Đủ điều kiện thì báo Đủ điều kiện và chưa thay đổi gì trên máy.
Chạy script cài bằng quyền Administrators
Bấm chuột phải iis\Cai-dat-IIS.cmd → Run as administrator. Script:
- kiểm lại điều kiện; thiếu gì thì báo từng mục và dừng, chưa thay đổi gì;
- hỏi chứng chỉ HTTPS: chọn chứng chỉ có trên máy, hoặc tạo chứng chỉ tự ký;
- hỏi có mở cổng trong Windows Firewall cho mạng nội bộ (Domain, Private) không;
- chép ứng dụng vào %ProgramFiles%\SAP AddOns, tạo app pool và site SAP AddOns (chỉ HTTPS, cổng 443), thư mục dữ liệu %ProgramData%\SAP AddOns (chỉ app pool và Administrators đọc được);
- mở https://localhost/ trên máy chủ.
Script chạy lại được nhiều lần, không tạo bản thứ hai.
Kích hoạt license dùng chung
Ở trang vừa mở trên máy chủ: nhập mã license dùng chung → Kích hoạt. Xem Kích hoạt và quản lý license. Kích hoạt chỉ làm được trên chính máy chủ.
Thiết lập trên máy chủ
Khai công ty SAP mà nhân viên sẽ đăng nhập (mục Thiết lập trên máy chủ).
Gửi địa chỉ cho nhân viên
Script in địa chỉ ở cuối, ví dụ https://ten-may-chu.congty.local/. Gửi đúng địa chỉ https (gõ http:// sẽ không vào được).

Tham số của script cài

Tham số	Dùng khi
`-CheckOnly`	Chỉ kiểm điều kiện, không thay đổi gì.
`-Port 8443`	Cổng 443 đã có web khác. Nhân viên dùng địa chỉ có cổng, ví dụ `https://ten-may-chu:8443/`.
`-CertificateThumbprint <thumbprint>`	Dùng chứng chỉ của công ty mà không qua câu hỏi.
`-DetailedLog On` / `-DetailedLog Off`	Bật / tắt log chi tiết khi cần hỗ trợ (log vào `%ProgramData%\SAP AddOns\logs`). Xong việc thì tắt.

Thiết lập trên máy chủ

Sau khi kích hoạt, trang trên máy chủ hiện Thiết lập trên máy chủ gồm 3 bước. Chỉ làm được trên chính máy chủ (https://localhost). Từ máy khác, nhân viên chỉ thấy SAP AddOns chưa được thiết lập cho tới khi IT làm xong.

Bước 1 / 3 · Máy chủ database
Chọn SQL Server hoặc SAP HANA, nhập Máy chủ (ví dụ sapsql01, sapsql01\SAP, sapsql01,1433; HANA: hana01:30015), Tài khoản database (nên là tài khoản chỉ đọc) và Mật khẩu, rồi bấm Kiểm tra và tiếp. SAP AddOns không ghi vào database.

Không có tài khoản database: bấm Bỏ qua, chỉ dùng Service Layer; hộp xác nhận liệt kê các giới hạn ở trên.
Bước 2 / 3 · Công ty và Service Layer
Có máy chủ database: chọn một hay nhiều công ty trong danh sách đọc từ máy chủ (gõ để tìm). Không có: nhập tên database công ty. Sau đó nhập Địa chỉ Service Layer (ví dụ https://sap-app01:50000/b1s/v1/, xem trong SAP Business One Service Layer Control Center), đánh dấu Máy chủ dùng chứng chỉ tự ký nếu Service Layer dùng chứng chỉ mặc định khi cài SAP, và Tên kết nối (ví dụ PROD). Tên kết nối hiện cạnh tên công ty ở màn đăng nhập; tên có PROD hiện màu đỏ. Công ty thử (DEV, TEST) thêm sau ở Setting với tên kết nối riêng.
Bước 3 / 3 · Kiểm tra bằng user SAP
Nhập User SAP và Mật khẩu SAP của bạn. SAP AddOns thử đăng nhập Service Layer một lần. SAP nhận thì lưu thiết lập và vào thẳng ứng dụng; chưa nhận thì chưa lưu gì. Nhiều công ty: chọn công ty để thử ở Thử đăng nhập vào công ty; các công ty khác được kiểm khi có người đăng nhập vào đó, hoặc bằng nút Kiểm tra kết nối ở Setting.

Thêm, sửa công ty và máy chủ database sau này ở Kết nối công ty SAP và Máy chủ database.

Khi không ai đăng nhập được

Ví dụ địa chỉ Service Layer đã đổi nên mọi người đều báo không kết nối được. Trên máy chủ:

Mở SAP AddOns ngay trên máy chủ
Mở https://localhost/ (cổng khác: https://localhost:<cổng>/).
Bấm Sửa cấu hình trên máy chủ
Nút nằm dưới nút Đăng nhập, chỉ có trên chính máy chủ. Ứng dụng mở nhóm Setting mà không cần đăng nhập SAP, với dòng Đang sửa cấu hình trên máy chủ, chưa đăng nhập SAP.
Sửa kết nối rồi kiểm tra
Nút Kiểm tra kết nối hỏi một tài khoản SAP để thử (Cần một tài khoản SAP để thử); mật khẩu chỉ dùng cho lần thử đó, không được lưu.
Bấm Đăng nhập SAP
Sửa xong, bấm Đăng nhập SAP ở thanh trên để quay lại màn đăng nhập.

Máy chủ không ra được Internet

Khi máy chủ không kết nối được máy chủ license, kể cả qua proxy, dùng kích hoạt bằng file:

Tạo file yêu cầu
Ở màn kích hoạt trên máy chủ, bấm Máy chủ không vào được Internet? (hoặc nút Kích hoạt bằng file trong thông báo không kết nối được). Nhập mã license → Tạo file yêu cầu. Trình duyệt tải file SAP-AddOns-yeu-cau-<tên máy>-<ngày>.txt (thường trong thư mục Downloads).
Gửi file cho nhà cung cấp
Đính kèm file, hoặc bấm Sao chép nội dung rồi dán vào email. File có mã license, không có dữ liệu SAP, user hay mật khẩu. Chỉ gửi cho nhà cung cấp.
Nhập file giấy phép
Nhà cung cấp gửi lại file SAP-AddOns-giay-phep-<tên máy>-het-han-<ngày>.txt. Bấm Chọn file giấy phép… (hoặc dán toàn bộ nội dung) → Kích hoạt bằng file. Đóng trình duyệt giữa chừng không sao: mở lại https://localhost/ sẽ về đúng bước.

Không sửa nội dung file: sửa một ký tự là SAP AddOns không nhận. File chỉ dùng được trên đúng máy chủ và đúng lần cài đã tạo file yêu cầu.
Máy chủ không kiểm tra license online nên không tự gia hạn. SAP AddOns nhắc từ 14 ngày trước hạn; nhà cung cấp gửi file giấy phép mới, nhập ở Setting › License › Nhập file giấy phép mới… (không cần file yêu cầu mới).
Khi máy chủ ra được Internet: Setting › License › Chuyển sang kiểm tra online…, nhập mã license.
Gỡ kèm xóa dữ liệu, hoặc cài lại trên máy chủ khác: cần tạo file yêu cầu mới.

Chi tiết các thông báo: Kích hoạt bằng file.

Proxy và chứng chỉ tự ký

Proxy: ứng dụng chạy bằng tài khoản app pool nên không thấy proxy của người dùng Windows. Công ty dùng proxy thì ở màn kích hoạt bấm Mạng công ty dùng proxy? → Dùng proxy riêng, khai địa chỉ (và tài khoản nếu proxy yêu cầu).
Chứng chỉ tự ký: trình duyệt của nhân viên báo “không an toàn” tới khi máy họ tin chứng chỉ này. Script lưu chứng chỉ ở %ProgramData%\SAP AddOns\chung-chi-tu-ky-SAP-AddOns.cer: cài file này vào Trusted Root Certification Authorities của các máy (ví dụ bằng Group Policy).

Nâng cấp

Giải nén bản mới
Giải nén file zip bản mới vào một thư mục.
Chạy script nâng cấp
Bấm chuột phải iis\Nang-cap-IIS.cmd (trong thư mục bản mới) → Run as administrator. Script không nâng cấp khi đang có người ghi vào SAP: báo và dừng; chạy lại khi lần ghi xong. Dữ liệu ở %ProgramData%\SAP AddOns giữ nguyên.
Báo nhân viên tải lại trang
Nhân viên bấm F5 để dùng bản mới.

Không cắt ngang lần ghi vào SAP

Không dừng site / app pool SAP AddOns hay khởi động lại máy chủ khi có người đang import; dùng các script ở trên vì script hỏi SAP AddOns trước. Đặt giờ Windows Update khởi động lại máy chủ ngoài giờ làm việc. Lần ghi bị cắt giữa chừng thì SAP có thể đã nhận một phần chứng từ: người import cần xem trên SAP trước khi ghi lại.

Gỡ

Hủy kích hoạt nếu dùng license ở máy chủ khác
Trước khi gỡ: Setting › License › Hủy kích hoạt trên máy này…. License nhận bằng file: hủy xong báo nhà cung cấp để giải phóng.
Chạy script gỡ
Bấm chuột phải iis\Go-IIS.cmd → Run as administrator. Script hỏi xác nhận, và hỏi riêng có xóa dữ liệu ở %ProgramData%\SAP AddOns không (mặc định giữ lại: cài lại sẽ dùng tiếp). Không đụng tới SAP.

Dữ liệu và sao lưu

%ProgramData%\SAP AddOns: cấu hình kết nối, license, khóa mã hóa (thư mục keys).
Mật khẩu đã lưu (tài khoản database chỉ đọc, proxy) được mã hóa bằng khóa gắn với máy chủ này: chép sang máy khác thì không đọc được, phải nhập lại.
Mật khẩu SAP của nhân viên không lưu ở đâu.
Không gửi mật khẩu, mã license đầy đủ hay file trong thư mục keys cho bất kỳ ai (riêng file yêu cầu kích hoạt bằng file có mã license: chỉ gửi cho nhà cung cấp).

Lỗi thường gặp

Hiện tượng	Nguyên nhân	Cách sửa
Script báo `Chưa cài được, còn … điều kiện cần sửa`	Thiếu IIS, Hosting Bundle, quyền Administrators, cổng bận…	Làm theo từng mục script liệt kê rồi chạy lại. Chưa có gì thay đổi trên máy.
Cổng 443 đã có web khác	Site khác trên IIS đang dùng cổng 443.	Chạy lại với `-Port 8443` (hoặc cổng trống khác).
Trình duyệt nhân viên báo “không an toàn”	Chứng chỉ tự ký chưa được máy nhân viên tin.	Cài `chung-chi-tu-ky-SAP-AddOns.cer` vào Trusted Root của các máy, hoặc dùng chứng chỉ của công ty.
Nhân viên thấy SAP AddOns chưa được thiết lập	Chưa khai công ty SAP nào.	IT mở `https://localhost/` trên máy chủ và làm Thiết lập trên máy chủ.
Mọi người báo Không kết nối được Service Layer	Địa chỉ Service Layer đổi, dịch vụ Service Layer dừng, hoặc mạng.	Trên máy chủ: Sửa cấu hình trên máy chủ, sửa địa chỉ rồi Kiểm tra kết nối.
Mã này là license cá nhân	Nhập mã license cá nhân trên IIS.	Liên hệ nhà cung cấp để nhận license dùng chung.
Script nâng cấp / gỡ báo đang có lần ghi vào SAP	Có người đang import.	Chờ lần ghi xong rồi chạy lại script.

Chi tiết cho IT: xem lỗi của ứng dụng trên máy chủ

Event Viewer → Windows Logs → Application, nguồn IIS AspNetCore Module V2 và .NET Runtime.
Log chi tiết khi cần hỗ trợ: Cai-dat-IIS.cmd -DetailedLog On (log vào %ProgramData%\SAP AddOns\logs); xong thì Cai-dat-IIS.cmd -DetailedLog Off.

Giới hạn hiện tại

Ghi vào SAP chỉ qua Service Layer; không dùng DI API.
Không có máy chủ database thì một số màn bị giới hạn như liệt kê ở trên.
Không tự cập nhật: nâng cấp bằng script Nang-cap-IIS.cmd.
Kích hoạt bằng file không thu hồi hay gia hạn tự động được: mỗi lần gia hạn cần file giấy phép mới.