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 về việc 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ỉ 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 cụm

Nếu một nút ZooKeeper duy nhất bị lỗi trong một tập hợp, 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 vào nhóm ZooKeeper, nút này sẽ nhận được ảnh chụp nhanh mới nhất từ Trưởng nhóm và bắt đầu phục vụ ứ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 quy trình thiết lập trên nút ZooKeeper bằng cùng một tệp cấu hình được 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.
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ỉ chỉ định phần ngày/giờ trong tên của tệp sao lưu.

   Bạn có thể tuỳ ý bỏ qua tệp sao lưu trong lệnh restore 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 cụm

Nếu một nút Cassandra trong một tập hợp 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 bản sao có sẵn 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 lỗi phần cứng, v.v.

Nếu không thể truy cập vào nút bị lỗi nữa, hãy huỷ nút đó và tách biệt mạng của nút đó để đảm bảo nút đó không thể vô tình tham gia lại cụm Cassandra. Sau đó, hãy tạo 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 nút vẫn có thể truy cập được và bạn muốn sử dụng lại nút đó, 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 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 bất kỳ nút Cassandra nào đang hoạt động trong cùng một 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. Kết quả 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 kết quả. 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 gốc mà các nút trong trung tâm dữ liệu này sử dụng.
2. Trên nút mới đang đượ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 phiên bản trên, danh sách hạt giống có 2 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. Quá trình thiết lập sẽ cố gắng tự 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. [Tuỳ chọn nâng cao] Bạn có thể đẩy nhanh quá trình truyền phát trực tiếp 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 bạn xác thực rằng nút đã hoạt động thành cô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 ở các 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ả thành phần.

Cơ sở dữ liệu PostgreSQL

PosgreSQL chạy độc lập hoặc dưới dạng Master

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

   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ỉ 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

PostgreSQL đ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:
   

   /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 Postgres Server 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 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

   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ể tuỳ ý bỏ qua tệp sao lưu trong lệnh restore 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, 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-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

   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ỉ chỉ định phần ngày/giờ trong tên của tệp sao lưu.

   Bạn có thể tuỳ ý bỏ qua tệp sao lưu trong lệnh restore 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

   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ể tuỳ ý bỏ qua tệp sao lưu trong lệnh restore 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

   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 máy chủ quản lý:

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

2. Xoá các thư mục cũ của Máy chủ quản lý:

   /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 Máy chủ quản lý từ tệp sao lưu:

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

   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ỉ 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ý thư từ tệp sao lưu:

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

   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ể tuỳ ý bỏ qua tệp sao lưu trong lệnh restore 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ộ xử lý thông báo:

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

Bộ định tuyến

1. Bộ định tuyến dừng:

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

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

   /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

   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ỉ chỉ định phần ngày/giờ trong tên của tệp sao lưu.

   Bạn có thể tuỳ ý bỏ qua tệp sao lưu trong lệnh restore 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 mới của Edge

1. Dừng giao diện người dùng mới của Edge:

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

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

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

3. Cài đặt lại giao diện người dùng mới của Edge:

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

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

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

   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ỉ chỉ định phần ngày/giờ trong tên của tệp sao lưu.

   Bạn có thể tuỳ ý bỏ qua tệp sao lưu trong lệnh restore 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 giao diện người dùng New Edge:

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

Hoàn tất quá trình khôi phục trang web

1. Dừng tất cả các nút thành phần. 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. 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 rằng SymasLDAP đang hoạt động
   4. Start qpid
   5. Đảm bảo rằng cơ sở dữ liệu PostgreSQL đang hoạt động
   6. Khởi động máy chủ quản lý
   7. Bắt đầu Bộ định tuyến và Bộ xử lý thông báo
   8. Khởi động máy chủ Qpid
   9. Khởi động máy chủ Postgres
   10. Bắt đầu giao diện người dùng mới của Edge