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

Tài liệu này hướng dẫn cách cài đặt lại và khôi phục một thành phần của Edge. 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.

Người giữ vườn thú Apache

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 cho bản sao lưu tệp hoặc bạn cũng không chỉ định tệp "backup-" hoặc ".tar.gz" hậu tố. Bạn chỉ cần chỉ định phần ngày/giờ của tên tệp sao lưu.

   Bạn có thể tuỳ ý bỏ qua tệp sao lưu trong lệnh restore và Edge sẽ hãy 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 bị lỗi thuộc nhóm, bạn có thể tạo một nút mới bằng cùng một tên máy chủ/địa chỉ IP rồi cài đặt lại ZooKeeper. Khi nút ZooKeeper mới tham gia Nhóm ZooKeeper sẽ nhận được những bức ảnh chụp nhanh mới nhất từ Trưởng nhóm và bắt đầu phục vụ khách hàng. Trong trường hợp này, bạn không cần khôi phục dữ liệu.

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

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

2. Chạy quá 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 được dùng khi cài đặt nút ban đầu:

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

3. Khởi động ZooKeeper:

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

Khôi phục một cụm hoàn chỉnh

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 cho bản sao lưu tệp hoặc bạn cũng không chỉ định tệp "backup-" hoặc ".tar.gz" hậu tố. Bạn chỉ cần chỉ định phần ngày/giờ của tên tệp sao lưu.

   Bạn có thể tuỳ ý bỏ qua tệp sao lưu trong lệnh restore và Edge sẽ hãy 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 thuộc 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 vài bước bổ sung. Bạn không cần khôi phục dữ liệu từ các bản sao lưu. Bạn có thể dùng các 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 được nếu một nút trong cụm Cassandra của bạn gặp sự cố do sự cố phần cứng, v.v.

Nếu nút bị lỗi không thể truy cập được 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 đó, hiển thị 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 tự động 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 quá 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 không hoạt động 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 gốc của trung tâm dữ liệu.
   1. Trên bất kỳ nút Cassandra đang hoạt động nào 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 được liệt kê 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 gốc (Địa chỉ IP của nút xuất hiện trong danh sách nút gốc ở 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 ví dụ ở trên, danh sách khởi đầu có 2 IP – 10.1.0.1 & 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 rằng tệp thuộc quyền sở hữu và Người dùng Apigee có thể đọc:
   

   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 quy trình 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 trong nội bộ. 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ó để 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 trực tuyến dữ liệu bằng cách chạy các lệnhnodetool sau đây 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 này đã kết nối thành công với 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 đã được thiết lập và đang chạy thành công, hãy chỉnh sửa tệp /opt/apigee/customer/application/cassandra.properties một lần nữa 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 một cụm hoàn chỉnh

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 với tư cách là Thạc sĩ

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. Bắt đầu 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ư bạn không chỉ định ".dump" hậu tố. Bạn chỉ cần chỉ định phần ngày/giờ của tên tệp sao lưu.

   Bạn có thể tuỳ ý bỏ qua tệp sao lưu trong lệnh restore và Edge sẽ hãy 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 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 cách sử dụ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. Bắt đầu 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à nút chờ:

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

2. Xoá các thư mục cũ của Máy chủ Postgres:

   /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 cho bản sao lưu tệp hoặc bạn cũng không chỉ định tệp "backup-" hoặc ".tar.gz" hậu tố. Bạn chỉ cần chỉ định phần ngày/giờ của tên tệp sao lưu.

   Bạn có thể tuỳ ý bỏ qua tệp sao lưu trong lệnh restore và Edge sẽ hãy 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 chờ:

   /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 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 cho bản sao lưu tệp hoặc bạn cũng không chỉ định tệp "backup-" hoặc ".tar.gz" hậu tố. Bạn chỉ cần chỉ định phần ngày/giờ của tên tệp sao lưu.

   Bạn có thể tuỳ ý bỏ qua tệp sao lưu trong lệnh restore và Edge sẽ hãy 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 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 cho bản sao lưu tệp hoặc bạn cũng không chỉ định tệp "backup-" hoặc ".tar.gz" hậu tố. Bạn chỉ cần chỉ định phần ngày/giờ của tên tệp sao lưu.

   Bạn có thể tuỳ ý bỏ qua tệp sao lưu trong lệnh restore và Edge sẽ hãy 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

OpenLDAP

1. Dừng OpenLDAP:

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

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

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

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

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

4. Khôi phục OpenLDAP:

   /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 cho bản sao lưu tệp hoặc bạn cũng không chỉ định tệp "backup-" hoặc ".tar.gz" hậu tố. Bạn chỉ cần chỉ định phần ngày/giờ của tên tệp sao lưu.

   Bạn có thể tuỳ ý bỏ qua tệp sao lưu trong lệnh restore và Edge sẽ hãy 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 OpenLDAP:

   /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 Máy chủ quản lý cũ:

   /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

   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 cho bản sao lưu tệp hoặc bạn cũng không chỉ định tệp "backup-" hoặc ".tar.gz" hậu tố. Bạn chỉ cần chỉ định phần ngày/giờ của tên tệp sao lưu.

   Bạn có thể tuỳ ý bỏ qua tệp sao lưu trong lệnh restore và Edge sẽ hãy 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ý tin nhắn

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 Trình xử lý thư cũ:

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

3. Cài đặt lại Trình xử lý thư:

   /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

   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 cho bản sao lưu tệp hoặc bạn cũng không chỉ định tệp "backup-" hoặc ".tar.gz" hậu tố. Bạn chỉ cần chỉ định phần ngày/giờ của tên tệp sao lưu.

   Bạn có thể tuỳ ý bỏ qua tệp sao lưu trong lệnh restore và Edge sẽ hãy 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ư:

   /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 Bộ định tuyến 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 Bộ định tuyến 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 cho bản sao lưu tệp hoặc bạn cũng không chỉ định tệp "backup-" hoặc ".tar.gz" hậu tố. Bạn chỉ cần chỉ định phần ngày/giờ của tên tệp sao lưu.

   Bạn có thể tuỳ ý bỏ qua tệp sao lưu trong lệnh restore và Edge sẽ hãy 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. Giao diện người dùng 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. Cài đặt lại giao diện người dùng:
   

   /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 cho bản sao lưu tệp hoặc bạn cũng không chỉ định tệp "backup-" hoặc ".tar.gz" hậu tố. Bạn chỉ cần chỉ định phần ngày/giờ của tên tệp sao lưu.

   Bạn có thể tuỳ ý bỏ qua tệp sao lưu trong lệnh restore và Edge sẽ hãy 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:
   

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

Hoàn tất khôi phục trang web

1. Dừng tất cả các nút thành phần. Xin lưu ý rằng thứ tự ngừng các hệ thống phụ là rất quan trọng: trước tiên dừng tất cả các nút Edge rồi 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ự bắt đầu 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 OpenLDAP được thiết lập và đang chạy
   4. Bắt đầu Qpid
   5. Đảm bảo cơ sở dữ liệu PostgreSQL được thiết lập và đang chạy
   6. Khởi động máy chủ quản lý
   7. Khởi động Bộ định tuyến và Bộ xử lý thư
   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 Apigee