Cài đặt lại và khôi phục các thành phần

Tài liệu này trình bày cách cài đặt lại và khôi phục một thành phần Edge. Hãy sử dụng quy trình này nếu bạn phải cài đặt lại thành phần Edge trước khi khôi phục bản sao lưu.

Apache ZooKeeper

Khôi phục một nút độc lập

1. Dừng ZooKeeper:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

2. Xoá các thư mục ZooKeeper cũ:

   /opt/apigee/data/apigee-zookeeper
   /opt/apigee/etc/apigee-zookeeper.d

3. Cài đặt lại ZooKeeper:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper install

4. Khôi phục ZooKeeper:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restore 2019.03.17,14.40.41

   Xin lưu ý rằng khi khôi phục một thành phần, bạn không chỉ định đường dẫn thư mục đến tệp sao lưu, cũng như không chỉ định tiền tố "backup-" hoặc hậu tố ".tar.gz". Bạn chỉ cần chỉ định phần ngày/giờ trong tên của tệp sao lưu.

   Bạn có thể bỏ qua tệp sao lưu trong lệnh restore (không bắt buộc) và Edge sẽ sử dụng tệp sao lưu gần đây nhất trong thư mục sao lưu của thành phần.

5. Khởi động lại tất cả các thành phần:

   /opt/apigee/apigee-service/bin/apigee-all restart

Khôi phục một nút trong cụm

Nếu một nút ZooKeeper duy nhất bị lỗi (là một phần của nhóm), bạn có thể tạo một nút mới có cùng tên máy chủ/địa chỉ IP và cài đặt lại ZooKeeper. Khi nút ZooKeeper mới tham gia nhóm ZooKeeper, nút này sẽ nhận được các ảnh chụp nhanh mới nhất từ Leader và bắt đầu phân phát cho các ứng dụng. Bạn không cần khôi phục dữ liệu trong trường hợp này.

1. Cài đặt lại ZooKeeper:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper install

2. Chạy chương trình thiết lập trên nút ZooKeeper bằng cách sử dụng cùng một tệp cấu hình đã dùng khi cài đặt nút ban đầu:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper setup -f configFile

3. Bắt đầu ZooKeeper:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper start

Khôi phục toàn bộ cụm

1. Dừng toàn bộ cụm.
2. Khôi phục tất cả các nút ZooKeeper từ tệp sao lưu như mô tả ở trên cho một nút duy nhất.
3. Khởi động cụm ZooKeeper.
4. Khởi động lại tất cả các thành phần.

Apache Cassandra

Khôi phục một nút độc lập

1. Dừng Cassandra:

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

2. Xoá thư mục Cassandra cũ:

   /opt/apigee/data/apigee-cassandra

3. Cài đặt lại Cassandra:

   /apigee/apigee-service/bin/apigee-service apigee-cassandra install

4. Khôi phục Cassandra:

   /apigee/apigee-service/bin/apigee-service apigee-cassandra restore 2019.03.17,14.40.41

   Xin lưu ý rằng khi khôi phục một thành phần, bạn không chỉ định đường dẫn thư mục đến tệp sao lưu, cũng như không chỉ định tiền tố "backup-" hoặc hậu tố ".tar.gz". Bạn chỉ cần chỉ định phần ngày/giờ trong tên của tệp sao lưu.

   Bạn có thể bỏ qua tệp sao lưu trong lệnh restore (không bắt buộc) và Edge sẽ sử dụng tệp sao lưu gần đây nhất trong thư mục sao lưu của thành phần.

5. Khởi động lại tất cả các thành phần:
   

   /apigee/apigee-service/bin/apigee-all restart

Khôi phục một nút trong cụm

Nếu một nút Cassandra duy nhất thuộc một nhóm bị lỗi, bạn có thể tạo một nút mới có cùng tên máy chủ/địa chỉ IP. Bạn chỉ cần cài đặt lại Cassandra và làm theo một vài bước bổ sung. Bạn không cần khôi phục dữ liệu từ bản sao lưu. Bạn có thể dùng các bản sao có trong các nút khác để khôi phục dữ liệu trên nút bị lỗi. Các bước này thường áp dụng nếu một nút trong cụm Cassandra của bạn gặp sự cố do phần cứng bị trục trặc, v.v.

Nếu không truy cập được vào nút bị lỗi nữa, hãy huỷ nút đó và cô lập mạng của nút để đảm bảo nút không vô tình tham gia lại cụm Cassandra. Sau đó, hãy đưa một nút mới có cùng địa chỉ IP với nút ban đầu và chạy các bước khởi động Apigee thông thường trên nút đó.

Nếu vẫn có thể truy cập vào nút này và bạn muốn sử dụng lại, hãy thực hiện các bước sau:

1. Dừng quy trình Cassandra trên nút:
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
2. Gỡ cài đặt phần mềm Cassandra khỏi nút:
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
3. Xoá thư mục dữ liệu khỏi nút:
   rm -rf /opt/apigee/data/apigee-cassandra

Sau khi hoàn tất các bước trên, bạn sẽ có một nút có cùng địa chỉ IP với nút bị lỗi và sẵn sàng cho quá trình cài đặt phần mềm Apigee. Thực hiện các bước sau đây:

1. Xác định các nút khởi động của trung tâm dữ liệu.
   1. Trên mọi nút Cassandra đang hoạt động trong cùng trung tâm dữ liệu với nút đang được khôi phục, hãy chạy lệnh sau:

      apigee-service apigee-cassandra configure -search conf_cassandra_seeds

   2. Nội dung đầu ra sẽ có dạng như sau:

      Found key conf_cassandra_seeds, with value, "127.0.0.1", in /opt/apigee/apigee-cassandra/token/default.properties
      Found key conf_cassandra_seeds, with value, 127.0.0.1, in /opt/apigee/apigee-cassandra/token/application/cassandra.properties
      Found key conf_cassandra_seeds, with value, "10.1.0.1,10.1.0.2", in /opt/apigee/token/application/cassandra.properties
      apigee-configutil: apigee-cassandra: # OK

   3. Tham khảo dòng cuối cùng trong đầu ra. Các địa chỉ IP được phân tách bằng dấu phẩy trong danh sách là các nút ban đầu mà các nút trong trung tâm dữ liệu này sử dụng.
2. Trên nút mới được khôi phục, hãy tạo hoặc chỉnh sửa tệp sau:
   

   vi /opt/apigee/customer/application/cassandra.properties
   

3. Add the following line:
   

   conf_jvm_options_custom_settings=-Dcassandra.replace_address=<ip-address-of-dead-node>

4. Nếu nút này là một trong các nút ban đầu (Địa chỉ IP của nút xuất hiện trong danh sách nút ban đầu ở bước 1), hãy thêm một dòng khác vào tệp:
   

   conf_cassandra_seeds="<comma-separated-seed-list-except-this-node’s-ip>"

   1. Ví dụ: trong trường hợp trên, danh sách ban đầu có 2 địa chỉ IP – 10.1.0.1 và 10.1.0.2. Nếu nút đang được khôi phục là 10.1.0.1, hãy thêm một dòng như sau:
      

      conf_cassandra_seeds="10.1.0.2"

5. Lưu tệp và đảm bảo người dùng Apigee sở hữu và có thể đọc tệp đó:
   

   chown apigee:apigee /opt/apigee/customer/application/cassandra.properties

6. Cài đặt phần mềm Cassandra:
   

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install

7. Chạy chế độ thiết lập Cassandra:
   

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f <configFile>

8. Quy trình thiết lập sẽ cố gắng khởi động dịch vụ Cassandra. Quá trình này có thể mất nhiều thời gian, tuỳ thuộc vào lượng dữ liệu cần truyền trực tuyến từ các nút khác, thông lượng mạng của bạn, v.v.
9. [Lựa chọn nâng cao] Bạn có thể đẩy nhanh quá trình truyền phát dữ liệu bằng cách chạy các lệnh nodetool sau trên nút:
   

   nodetool setstreamthroughput <value>
   nodetool setcompactionthroughput <value>

10. Sau khi nút Cassandra hoạt động trở lại, hãy sử dụng các lệnh tiêu chuẩn như bên dưới để xác minh rằng nút đã tham gia thành công vào vòng:
    

    /opt/apigee/apigee-cassandra/bin/nodetool ring
    /opt/apigee/apigee-cassandra/bin/nodetool status

11. Sau khi xác thực rằng nút đang hoạt động bình thường, hãy chỉnh sửa lại tệp /opt/apigee/customer/application/cassandra.properties và xoá các dòng bạn đã thêm trước đó trong quy trình này ở bước 3 và 4.
12. Khởi động lại dịch vụ Cassandra trên nút:
    

    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart

Khôi phục toàn bộ cụm

1. Dừng toàn bộ cụm.
2. Khôi phục tất cả các nút Cassandra từ tệp sao lưu.
3. Khởi động cụm Cassandra.
4. Khởi động lại tất cả các thành phần.

Cơ sở dữ liệu PostgreSQL

PosgreSQL chạy độc lập hoặc dưới dạng Máy chủ chính

1. Dừng Máy chủ quản lý, Máy chủ Qpid và Máy chủ Postgres trên tất cả các nút:

   /apigee/apigee-service/bin/apigee-service edge-management-server stop
   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop

2. Cài đặt lại cơ sở dữ liệu PostgreSQL:

   /apigee/apigee-service/bin/apigee-service apigee-postgresql install 

3. Khởi động PostgreSQL:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start

4. Khôi phục cơ sở dữ liệu PostgreSQL từ tệp sao lưu:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restore 2019.03.17,14.40.41

   Xin lưu ý rằng khi khôi phục thành phần PostgreSQL, bạn không chỉ định đường dẫn thư mục đến tệp sao lưu, cũng như không chỉ định hậu tố ".dump". Bạn chỉ cần chỉ định phần ngày/giờ trong tên của tệp sao lưu.

   Bạn có thể bỏ qua tệp sao lưu trong lệnh restore (không bắt buộc) và Edge sẽ sử dụng tệp sao lưu gần đây nhất trong thư mục sao lưu của thành phần.

5. Khởi động Máy chủ quản lý, Máy chủ Qpid và Máy chủ Postgres trên tất cả các nút:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server start
   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start

PosgreSQL đang chạy ở chế độ chờ

1. Cài đặt lại cơ sở dữ liệu PostgreSQL:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql install

2. Định cấu hình lại cơ sở dữ liệu PostgreSQL bằng chính tệp cấu hình mà bạn đã dùng để cài đặt cơ sở dữ liệu đó:
   

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup -f configFile

3. Khởi động PostgreSQL:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start 

Máy chủ Postgres

1. Dừng Máy chủ Postgres trên tất cả các nút chính và dự phòng:

   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop

2. Xoá các thư mục Postgres Server cũ:

   /opt/apigee/data/edge-postgres-server /opt/apigee/etc/edge-postgres-server.d

3. Cài đặt lại Máy chủ Postgres:

   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server install

4. Khôi phục Máy chủ Postgres từ tệp sao lưu:

   /opt/apigee/apigee-service/bin/apigee-service edge-postgre-server restore 2019.03.17,14.40.41

   Xin lưu ý rằng khi khôi phục một thành phần, bạn không chỉ định đường dẫn thư mục đến tệp sao lưu, cũng như không chỉ định tiền tố "backup-" hoặc hậu tố ".tar.gz". Bạn chỉ cần chỉ định phần ngày/giờ trong tên của tệp sao lưu.

   Bạn có thể bỏ qua tệp sao lưu trong lệnh restore (không bắt buộc) và Edge sẽ sử dụng tệp sao lưu gần đây nhất trong thư mục sao lưu của thành phần.

5. Khởi động Máy chủ Postgres trên tất cả các nút chính và nút dự phòng:

   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start

Máy chủ Qpid và Qpidd

1. Dừng Qpidd, Qpid Server và Postgres Server trên tất cả các nút:
   

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd stop

2. Xoá các thư mục Qpid Server và Qpidd cũ:

   /opt/apigee/data/edge-qpid-server
   /opt/apigee/etc/edge-qpid-server.d
   /opt/apigee/data/apigee-qpidd
   /opt/apigee/etc/apigee-qpidd.d 

3. Cài đặt lại Qpidd:

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd install 

4. Khôi phục Qpidd:

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd restore 2019.03.17,14.40.41

   Xin lưu ý rằng khi khôi phục một thành phần, bạn không chỉ định đường dẫn thư mục đến tệp sao lưu, cũng như không chỉ định tiền tố "backup-" hoặc hậu tố ".tar.gz". Bạn chỉ cần chỉ định phần ngày/giờ trong tên của tệp sao lưu.

   Bạn có thể bỏ qua tệp sao lưu trong lệnh restore (không bắt buộc) và Edge sẽ sử dụng tệp sao lưu gần đây nhất trong thư mục sao lưu của thành phần.

5. Bắt đầu Qpidd:

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd start 

6. Cài đặt lại Máy chủ Qpid:

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server install

7. Khôi phục máy chủ Qpid:

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restore 2019.03.17,14.40.41

   Xin lưu ý rằng khi khôi phục một thành phần, bạn không chỉ định đường dẫn thư mục đến tệp sao lưu, cũng như không chỉ định tiền tố "backup-" hoặc hậu tố ".tar.gz". Bạn chỉ cần chỉ định phần ngày/giờ trong tên của tệp sao lưu.

   Bạn có thể bỏ qua tệp sao lưu trong lệnh restore (không bắt buộc) và Edge sẽ sử dụng tệp sao lưu gần đây nhất trong thư mục sao lưu của thành phần.

8. Khởi động lại Máy chủ Qpid, Qpidd và Máy chủ Postgres trên tất cả các nút:

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd restart
   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart

SymasLDAP

1. Dừng SymasLDAP:

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap stop

2. Cài đặt lại SymasLDAP:

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap install

3. Xoá các thư mục SymasLDAP cũ:

   /opt/apigee/data/apigee-openldap /opt/apigee/etc/apigee-openldap.d

4. Khôi phục SymasLDAP:

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap restore 2019.03.17,14.40.41

   Xin lưu ý rằng khi khôi phục một thành phần, bạn không chỉ định đường dẫn thư mục đến tệp sao lưu, cũng như không chỉ định tiền tố "backup-" hoặc hậu tố ".tar.gz". Bạn chỉ cần chỉ định phần ngày/giờ trong tên của tệp sao lưu.

   Bạn có thể bỏ qua tệp sao lưu trong lệnh restore (không bắt buộc) và Edge sẽ sử dụng tệp sao lưu gần đây nhất trong thư mục sao lưu của thành phần.

5. Khởi động lại SymasLDAP:

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap start

6. Khởi động lại tất cả Máy chủ quản lý:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

Máy chủ quản lý

1. Dừng Management Server:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop

2. Xoá các thư mục cũ của Management Server:

   /opt/apigee/data/edge-management-server /opt/apigee/etc/edge-management-server.d

3. Cài đặt lại Máy chủ quản lý:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server install

4. Khôi phục Management Server từ tệp sao lưu:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server restore 2019.03.17,14.40.41

   Xin lưu ý rằng khi khôi phục một thành phần, bạn không chỉ định đường dẫn thư mục đến tệp sao lưu, cũng như không chỉ định tiền tố "backup-" hoặc hậu tố ".tar.gz". Bạn chỉ cần chỉ định phần ngày/giờ trong tên của tệp sao lưu.

   Bạn có thể bỏ qua tệp sao lưu trong lệnh restore (không bắt buộc) và Edge sẽ sử dụng tệp sao lưu gần đây nhất trong thư mục sao lưu của thành phần.

5. Khởi động lại Máy chủ quản lý:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server start

Trình xử lý thông báo

1. Dừng trình xử lý tin nhắn:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop

2. Xoá các thư mục Message Processor cũ:

   /opt/apigee/data/edge-message-processor
   /opt/apigee/etc/edge-message-processor.d

3. Cài đặt lại Trình xử lý tin nhắn:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor install

4. Khôi phục Trình xử lý tin nhắn từ tệp sao lưu:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restore 2019.03.17,14.40.41

   Xin lưu ý rằng khi khôi phục một thành phần, bạn không chỉ định đường dẫn thư mục đến tệp sao lưu, cũng như không chỉ định tiền tố "backup-" hoặc hậu tố ".tar.gz". Bạn chỉ cần chỉ định phần ngày/giờ trong tên của tệp sao lưu.

   Bạn có thể bỏ qua tệp sao lưu trong lệnh restore (không bắt buộc) và Edge sẽ sử dụng tệp sao lưu gần đây nhất trong thư mục sao lưu của thành phần.

5. Khởi động lại Trình xử lý tin nhắn:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor start

Bộ định tuyến

1. Dừng bộ định tuyến:

   /opt/apigee/apigee-service/bin/apigee-service edge-router stop

2. Xoá các thư mục cũ của Bộ định tuyến:

   /opt/apigee/data/edge-router
   /opt/apigee/etc/edge-router.d

3. Cài đặt lại bộ định tuyến:
   

   /opt/apigee/apigee-service/bin/apigee-service edge-router install

4. Khôi phục Router từ tệp sao lưu:

   /opt/apigee/apigee-service/bin/apigee-service edge-router restore 2019.03.17,14.40.41

   Xin lưu ý rằng khi khôi phục một thành phần, bạn không chỉ định đường dẫn thư mục đến tệp sao lưu, cũng như không chỉ định tiền tố "backup-" hoặc hậu tố ".tar.gz". Bạn chỉ cần chỉ định phần ngày/giờ trong tên của tệp sao lưu.

   Bạn có thể bỏ qua tệp sao lưu trong lệnh restore (không bắt buộc) và Edge sẽ sử dụng tệp sao lưu gần đây nhất trong thư mục sao lưu của thành phần.

5. Khởi động lại bộ định tuyến:
   

   /opt/apigee/apigee-service/bin/apigee-service edge-router start

Giao diện người dùng Edge

1. Dừng giao diện người dùng:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui stop

2. Xoá các thư mục giao diện người dùng cũ:

   /opt/apigee/data/edge-ui
   /opt/apigee/etc/edge-ui.d

3. Giao diện người dùng cài đặt lại:
   

   /opt/apigee/apigee-service/bin/apigee-service edge-ui install

4. Khôi phục giao diện người dùng từ tệp sao lưu:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui restore 2019.03.17,14.40.41

   Xin lưu ý rằng khi khôi phục một thành phần, bạn không chỉ định đường dẫn thư mục đến tệp sao lưu, cũng như không chỉ định tiền tố "backup-" hoặc hậu tố ".tar.gz". Bạn chỉ cần chỉ định phần ngày/giờ trong tên của tệp sao lưu.

   Bạn có thể bỏ qua tệp sao lưu trong lệnh restore (không bắt buộc) và Edge sẽ sử dụng tệp sao lưu gần đây nhất trong thư mục sao lưu của thành phần.

5. Giao diện người dùng khởi động lại:
   

   /opt/apigee/apigee-service/bin/apigee-service edge-ui start

Khôi phục toàn bộ trang web

1. Dừng tất cả các nút thành phần. Xin lưu ý rằng thứ tự dừng các hệ thống con là rất quan trọng: trước tiên, hãy dừng tất cả các nút Edge, sau đó dừng tất cả các nút kho dữ liệu.
2. Khôi phục tất cả các thành phần như mô tả ở trên.
3. Bây giờ, hãy khởi động tất cả các thành phần theo thứ tự sau. Xin lưu ý rằng thứ tự khởi động các hệ thống con là rất quan trọng:
   1. Khởi động cụm ZooKeeper
   2. Khởi động cụm Cassandra
   3. Đảm bảo SymasLDAP đang hoạt động
   4. Start qpid
   5. Đảm bảo cơ sở dữ liệu PostgreSQL đang hoạt động
   6. Khởi động máy chủ quản lý
   7. Khởi động Bộ định tuyến và Bộ xử lý tin nhắn
   8. Khởi động máy chủ Qpid
   9. Khởi động máy chủ Postgres
   10. Khởi động giao diện người dùng Apigee