Giám sát độc lập cho Firebird
Giám sát độc lập cho Firebird
Cách cài đặt và cấu hình Firebird Advanced Monitoring độc lập
1. Cài đặt
1.1. Đăng ký trên “Online Tools For Firebird” để nhận file keyanswers.txt
Để sử dụng tính năng giám sát nâng cao, bạn cần tạo tài khoản miễn phí trên cổng thông tin “Online Tools For Firebird”: https://cc.ib-aid.com/, sau đó tải file keyanswers.txt để liên kết tài khoản và máy chủ của bạn.
Đối với người dùng sử dụng Control Center riêng, tài khoản tương ứng phải được tạo bởi quản trị viên.
1.1.1. Các bước đăng ký
1. Mở https://cc.ib-aid.com/ và nhấp vào Tạo tài khoản mới:

2. Sau đó, chỉ định email hợp lệ, tên người dùng và công ty (tùy chọn):

3. Sau đó, đợi 2-3 phút để nhận email xác nhận và nhấp vào liên kết xác nhận. Nó sẽ mở biểu mẫu, nơi bạn cần nhập mật khẩu và xác nhận mật khẩu, sau đó bạn có thể đăng nhập vào cổng thông tin “Online Tools For Firebird”.
1.1.2. Tải keyanswers.txt
Sau khi đăng nhập, bạn sẽ thấy tiện ích “Download Firebird Monitoring Agents”:

Tải agent cho hệ điều hành cần thiết (hiện tại chỉ hỗ trợ Windows phiên bản 7+/ Server 2008+ và Linux với systemd).
Ngoài ra, hãy tải file keyanswers.txt.
Keyanswers.txt chứa thông tin cần thiết để liên kết tài khoản Control Center và Advanced Monitoring, sau đó tiến hành cài đặt.
1.2. Cài đặt trên Windows
Bản phân phối agent cho Advanced Monitoring trên Windows là file lưu trữ zip: install_fbcc.zip.
Giải nén file lưu trữ cài đặt fbcc.zip vào thư mục Firebird, ví dụ: C:\Program Files\Firebird\Firebird_3_0\fbcc, sau đó sao chép file keyanswers.txt từ bước trước vào thư mục fbcc.
Kết quả là, thư mục sẽ trông như thế này:

Ngoài ra, hãy đảm bảo rằng keyanswers.txt nằm trong thư mục chứa các file giám sát nâng cao:

Sau đó, chạy file lệnh install_fbcc.cmd với tùy chọn “Run As Administrator”. File cmd sẽ thực hiện các việc sau:
- tạo 2 dịch vụ: FBHQbird Monitor 4 và FBHQbird Trace 4
- tạo tác vụ trong Task Scheduler để khởi động lại giám sát lúc 23:50
- Tìm Firebird (nếu nó nằm trong đường dẫn chuẩn) và cấu hình nó. Quá trình cài đặt Advanced Monitoring tự động cố gắng cấu hình quyền truy cập vào Firebird với người dùng/mật khẩu mặc định và kiểm tra kết nối với cơ sở dữ liệu mẫu employee.fdb. Nếu người dùng sở hữu của bạn không phải là SYSDBA hoặc mật khẩu không phải là masterkey, quá trình cài đặt sẽ yêu cầu cung cấp người dùng và mật khẩu.
- Kết nối với cổng Control Center, được chỉ định trong keyanswers.txt và đăng ký máy chủ trong tài khoản của bạn ở đó.
1.2.1. Cài đặt với SYSDBA/masterkey mặc định
Dưới đây là ví dụ về nhật ký cài đặt từ Firebird với người dùng/mật khẩu mặc định (SYSDBA/masterkey):
c:\Firebird30\fbcc>install_fbcc.cmd
The Service FBHQbirdMON4 has been installed
2022-02-12 09:41:40 ERROR MainCreateConf:287 - Not found location, return empty string
Checking access to Firebird Monitoring Portal...
Connected to Portal: Ok
Determined architecture: SuperServer and version: 3.0.6
Verified connection with Firebird user: SYSDBA: Ok.
Using autodiscovery to watch for all active databases.
Registering server in Firebird Monitoring Control Center
Registered new server with name=SRV-DESKTOP-NS28RCG-2202012214, GUID=99c54d1jjqxj0r (id=314285)
Successful! Now you can see your server in Firebird Control Center: https://cc.ib-aid.com
The Service FBHQbirdTrace4 has been installed
SUCCESS: The scheduled task "Restart Mon4 Service (Firebird Monitoring)" has successfully been created.
The FBHQbird Monitor 4 service is starting.
The FBHQbird Monitor 4 service was started successfully.
The FBHQbird Trace 4 service is starting.
The FBHQbird Trace 4 service was started successfully.
c:\Firebird30\fbcc>
1.2.2. Cài đặt với tên người dùng/mật khẩu tùy chỉnh
Trong trường hợp tên người dùng và/hoặc mật khẩu không phải mặc định, bạn sẽ được yêu cầu nhập chúng trong quá trình cài đặt trong cmd.
1.2.3. Gỡ cài đặt Advanced Monitoring trên Windows
Nếu bạn mắc lỗi trong quá trình cài đặt, hoặc thấy bất kỳ lỗi nào, hoặc chỉ đơn giản là quyết định gỡ bỏ agent Advanced Monitoring, hãy chạy remove_fbcc.cmd, nó sẽ dừng và gỡ bỏ dịch vụ và tác vụ lập lịch, nhật ký gỡ cài đặt sẽ như thế này:
c:\Firebird30\fbcc>remove_fbcc.cmd
The FBHQbird Monitor 4 service is stopping.
The FBHQbird Monitor 4 service was stopped successfully.
The FBHQbird Trace 4 service is stopping.
The FBHQbird Trace 4 service was stopped successfully.
The FBHQbird Monitor 4 service is not started.
More help is available by typing NET HELPMSG 3521.
[SC] DeleteService SUCCESS
The FBHQbird Trace 4 service is not started.
More help is available by typing NET HELPMSG 3521.
[SC] DeleteService SUCCESS
SUCCESS: The scheduled task "Restart Mon4 Service (Firebird Monitoring)" was successfully deleted.
c:\Firebird30\fbcc>
1.3. Cài đặt trên Linux
Tải file install_fbcc.sh từ “Online Tools For Firebird” (xem 1.1.2 để biết chi tiết):
sudo wget /download/fbcc/install_fbcc.sh
File này chứa trình cài đặt Advanced Monitoring cho Firebird trên Linux.
Trình cài đặt sẽ cài đặt các file cần thiết vào vị trí /opt/fbcc, vì vậy hãy đảm bảo bạn có đủ dung lượng trống ở đó.
1.3.1 Điều kiện tiên quyết: Java 8 và jsvc
Java 8
Bạn cần cài đặt Java 8 trên máy chủ nơi bạn cần chạy giám sát.
Chúng tôi khuyên bạn nên cài đặt OpenJDK 8 Correto (từ Amazon):
wget -O- https://apt.corretto.aws/corretto.key | sudo apt-key add -
sudo add-apt-repository 'deb https://apt.corretto.aws stable main'
sudo apt-get update; sudo apt-get install -y java-1.8.0-amazon-corretto-jdk
Thông tin chi tiết: https://docs.aws.amazon.com/corretto/latest/corretto-8-ug/generic-linux-install.html
jsvc
jsvc là công cụ để khởi chạy ứng dụng java như một dịch vụ, nó được sử dụng bởi agent Firebird Advanced Monitoring.
Cài đặt jsvc trên CentOS
yum install jsvc
trên Ubuntu
apt install jsvc
1.3.3. Đặt keyanswers.txt gần install_fbcc.sh
Lấy keyanswers.txt từ 1.1.2 và đặt nó gần install_fbcc.sh
Xin lưu ý rằng không có lệnh wget, vì keynaswers.txt được tạo động trên cổng thông tin và yêu cầu người dùng đã đăng ký phải đăng nhập và tải xuống. <4>1.3.4. Các bước cài đặt Làm cho tập lệnh cài đặt có thể thực thi:
sudo chmod +x install_fbcc.sh
Chạy cài đặt:
sudo install_fbcc.sh
Đây là ví dụ về các file cần có trước khi cài đặt:
total 18624
drwxr-xr-x 3 root root 4096 May 3 23:32 ./
drwxr-xr-x 20 root root 4096 Feb 14 02:06 ../
drwxr-xr-x 12 root root 4096 May 3 23:19 firebird/
-rwxr-xr-x 1 root root 19050609 Sep 29 2021 install_fbcc.sh*
-rwxrwxrwx 1 root root 110 May 3 23:26 keyanswers.txt*
Sau đó, chạy install_fbcc.sh.
Xin lưu ý rằng tập lệnh mong đợi Firebird vanilla được cài đặt thủ công trong /opt/firebird từ file lưu trữ tar chính thức.
Nếu bạn đã cài đặt Firebird từ kho lưu trữ, chúng tôi khuyên bạn nên gỡ cài đặt nó và cài đặt từ file lưu trữ tar chính thức từ trang web www.firebirdsql.org.
2. Xử lý sự cố
Lời khuyên chung để xử lý sự cố thành công
Kiểm tra các file *.log trong thư mục Bin của quá trình cài đặt Firebird Monitoring.
Các file nhật ký có tên theo tên jar, tức là đối với launcher sẽ là launcher.log.
Các file nhật ký theo mặc định chứa các lỗi và thông điệp quan trọng.
Sự cố: nỗ lực cài đặt mà không có keyasnwers.txt
Nếu bạn không đặt file keyanswers.txt trong cùng thư mục với install_fbcc.cmd (trên Windows) hoặc install_fbcc.sh (trên Linux), các dịch vụ sẽ được cài đặt, nhưng không được cấu hình:
c:\Firebird30\fbcc>install_fbcc.cmd
The Service FBHQbirdMON4 has been installed
Installation stopped: keyanswers.txt file not found near install_fbcc.cmd.
Please download it from cc.ib-aid.com or use manual mode installation.
To try installation again, run remove_fbcc script and then install_fbcc again.
Giải pháp:
chạy file lệnh gỡ cài đặt (uninstall.cmd trên Windows, sử dụng chuột phải và chọn tùy chọn “Run As Administrator”, hoặc uninstall.sh trong /opt/fbcc/uninstall.sh trên Linux). Nó sẽ gỡ cài đặt giám sát với đầu ra như thế này:
c:\Firebird30\fbcc>remove_fbcc.cmd
The FBHQbird Monitor 4 service is not started.
More help is available by typing NET HELPMSG 3521.
The FBHQbird Trace 4 service is not started.
More help is available by typing NET HELPMSG 3521.
The FBHQbird Monitor 4 service is not started.
More help is available by typing NET HELPMSG 3521.
[SC] DeleteService SUCCESS
The FBHQbird Trace 4 service is not started.
More help is available by typing NET HELPMSG 3521.
[SC] DeleteService SUCCESS
SUCCESS: The scheduled task "Restart Mon4 Service (Firebird Monitoring)" was successfully deleted.
C:\fbcc>
Sau đó, đặt keyanswers.txt vào thư mục gần install_fbcc.cmd và cài đặt lại.
Sự cố: gói cài đặt không thể tìm thấy thư mục Firebird
Trong trường hợp gói cài đặt giám sát không tìm thấy thư mục Firebird, nó sẽ đưa ra đầu ra sau:
c:\Firebird30\fbcc>install_fbcc.cmd
The Service FBHQbirdMON4 has been installed
2022-02-12 09:11:23 ERROR MainCreateConf:287 - Not found location, return empty string
2022-02-12 09:11:23 ERROR MainCreateConf:287 - Not found location, return empty string
2022-02-12 09:11:23 ERROR MainCreateConf:287 - Not found location, return empty string
Checking access to Firebird Monitoring Portal...
Connected to Portal: Ok
2022-02-12 09:11:24 ERROR MainCreateConf:592 - Cannot find test database - setting version to 3.0.0 and arch to Classic
Paths checked:
2022-02-12 09:11:24 ERROR MainCreateConf:594 - /../examples/empbuild/employee.fdb
2022-02-12 09:11:24 ERROR MainCreateConf:594 - /../help/help.fdb
2022-02-12 09:11:24 ERROR MainCreateConf:594 - /examples/empbuild/employee.fdb
2022-02-12 09:11:24 ERROR MainCreateConf:594 - /help/help.fdb
Please enter owner user for Firebird databases, or hit Enter to use SYSDBA
Các thông điệp trên “Not found location, return empty” cho biết tập lệnh cài đặt không tìm thấy Firebird trong các đường dẫn sau trên Windows:
"C:/Program Files/Firebird/Firebird_4_0",
"D:/Program Files/Firebird/Firebird_4_0",
"E:/Program Files/Firebird/Firebird_4_0",
"F:/Program Files/Firebird/Firebird_4_0",
"C:/Program Files/Firebird/Firebird_3_0",
"C:/Program Files/Firebird/Firebird_2_5/bin",
"D:/Program Files/Firebird/Firebird_3_0",
"D:/Program Files/Firebird/Firebird_2_5/bin",
"E:/Program Files/Firebird/Firebird_3_0",
"E:/Program Files/Firebird/Firebird_2_5/bin",
"F:/Program Files/Firebird/Firebird_3_0",
"F:/Program Files/Firebird/Firebird_2_5/bin",
"C:/HQbird/Firebird40",
"D:/HQbird/Firebird40",
"E:/HQbird/Firebird40",
"F:/HQbird/Firebird30",
"C:/HQbird/Firebird30",
"C:/HQbird/Firebird25/bin",
"D:/HQbird/Firebird30",
"D:/HQbird/Firebird25/bin",
"E:/HQbird/Firebird30",
"E:/HQbird/Firebird25/bin",
"F:/HQbird/Firebird30",
"F:/HQbird/Firebird25/bin"
và trên Linux
"/opt/firebird/bin"
Giải pháp:
Hoặc cài đặt Firebird vào đường dẫn chuẩn (C:\Program Files\Firebird\Firebird_N_N trên Windows hoặc /opt/firebird) hoặc sử dụng HQbird với Advanced Monitoring hỗ trợ các đường dẫn tùy chỉnh đến Firebird.
Sự cố: Khởi động giám sát mà không có file cấu hình gây ra lỗi trong nhật ký
Starting service...Windows 10
Current folder = E:\fbcc\_OUT
2022-02-09 10:43:20 ERROR Main:350 - Stopping: not found mainconfig.enc or mainconfig.json in ../conf/mainconfig.enc
Giải pháp:
thực hiện cài đặt đúng cách bằng file keyanswers.txt từ Control Center của bạn