Nieprawidłowe pliki konfiguracyjne

Wyświetlasz dokumentację Apigee Edge.
Przejdź do dokumentacji Apigee X. info

Krótki opis problemu

Router Edge jest implementowany za pomocą NGINX. Podczas procesu uaktualniania Edge lub gdy zmieniasz konfigurację routera, mogą pojawić się błędy konfiguracji NGINX. Gdy wystąpią te błędy, Edge oznaczy wszystkie pliki konfiguracyjne NGINX, które spowodowały problem, jako nieprawidłowe w katalogu /opt/nginx/conf.d:

-rw-r--r-- 1 apigee apigee 522 Jul 20 08:41 0-default.conf.bad 
-rw-r--r-- 1 apigee apigee 577 Jul 20 08:42 0-fallback.conf 
-rw-r--r-- 1 apigee apigee 1062 Jul 20 08:18 0-map.conf 
-rw-r--r-- 1 apigee apigee 1887 Jul 20 08:42 custorg_test_default.conf.bad

Komunikaty o błędach

Nie zobaczysz żadnych komunikatów o błędach. Może się jednak zdarzyć, że nie będziesz w stanie wykonać swoich serwerów proxy interfejsu API z powodu nieprawidłowych plików konfiguracyjnych.

Możliwe przyczyny

Zazwyczaj pliki konfiguracyjne NGINX są oznaczane jako nieprawidłowe, ponieważ ustawiono nieprawidłowe wartości właściwości NGINX w pliku /opt/apigee/customer/application/router.properties lub wprowadzono nieprawidłowe zmiany w hoście wirtualnym.

Diagnostyka

1. Usuń sufiks .bad z nazw plików w katalogu /opt/nginx/conf.d, aby kończyły się one na .conf.

2. Uruchom narzędzie configtest NGINX, aby określić przyczynę niepowodzenia:

   /opt/nginx/scripts/apigee-nginx configtest

Rozdzielczość

1. Jeśli test konfiguracji określi przyczynę nieprawidłowych plików konfiguracyjnych, rozwiąż problem, wprowadzając odpowiednie zmiany w konkretnej właściwości w pliku /opt/apigee/customer/application/router.properties lub w hoście wirtualnym.

2. Usuń katalog /opt/nginx/conf.d:

   rm -rf /opt/nginx/conf.d

3. Uruchom ponownie router:

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

4. Nie powinny już być widoczne nieprawidłowe pliki konfiguracyjne w /opt/nginx/conf.d katalogu.

Jeśli problem będzie nadal występował, skontaktuj się z zespołem pomocy Apigee Edge.

Oto przykład, który pokazuje, jak rozwiązać problem na podstawie informacji podanych przez test konfiguracji NGINX.

Przykład 1. Nieprawidłowa wartość ustawiona dla właściwości NGINX

1. Załóżmy, że w pliku /opt/apigee/customer/application/router.properties zaktualizowano właściwość „proxy_busy_buffers_size” do wartości 128K, jak pokazano poniżej:

   conf_load_balancing_load.balancing.driver.proxy.busy.buffer.size=128k 

Spowodowało to oznaczenie plików konfiguracyjnych jako nieprawidłowych w /opt/apigee/nginx/conf.d katalogu.

2. Aby określić przyczynę niepowodzenia, uruchom polecenie configtest NGINX:

   /opt/nginx/scripts/apigee-nginx configtest
   nginx: [emerg] "proxy_busy_buffers_size" must be equal to or greater than the maximum of the value of "proxy_buffer_size" and one of the "proxy_buffers" in /opt/nginx/conf/nginx.conf:47
   nginx: configuration file /opt/nginx/conf/nginx.conf test failed

Wyniki configtest wskazują, że wartość właściwości proxy_busy_buffers_size powinna być równa lub większa niż proxy_buffer_size, ale wydaje się, że jest ustawiona na nieprawidłową wartość.

3. Sprawdź wartości ustawione dla właściwości proxy_buffer_size i proxy_busy_buffers_size w pliku 0-default.conf:

   proxy_buffer_size 512k;
   proxy_busy_buffers_size 128k;

4. Zaktualizuj wartość proxy_busy_buffers_size do 512K w /opt/apigee/customer/application/router.properties pliku:

   conf_load_balancing_load.balancing.driver.proxy.busy.buffer.size=512k

5. Usuń folder /opt/nginx/conf.d:

   rm -rf /opt/nginx/conf.d

6. Uruchom ponownie router:

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

Problem został rozwiązany, a nieprawidłowe pliki konfiguracyjne zostały usunięte.

Przykład 2. Nie udało się uaktualnić NGINX (tylko Private Cloud 18.01)

Załóżmy, że uruchamiasz configtest i otrzymujesz te odpowiedzi:

/apigee-nginx configtest

 nginx: the configuration file /opt/nginx/conf/nginx.conf syntax is ok
 nginx: [emerg] zero size shared memory zone "perclient"
 nginx: configuration file /opt/nginx/conf/nginx.conf test failed

Ten błąd oznacza, że nie udało się uaktualnić NGINX z wersji 1.10.x do 1.12.x. Znany jest błąd związany z uaktualnianiem Edge Private Cloud do wersji 18.01.

Aby prawidłowo zdiagnozować ten problem (tylko w przypadku Private Cloud 18.01), wykonaj te czynności:

rpm -aq | grep apigee-nginx

To polecenie powinno zwrócić zainstalowany pakiet rpm w wersji 1.12.x. Jeśli tak się nie stanie, wykonaj te czynności:

1. Zatrzymaj komponent edge-router.
2. Utwórz kopię zapasową komponentu edge-router.
3. Aby uaktualnić do apigee-nginx 1.2.x, uruchom to polecenie:

sudo yum update apigee-nginx

4. Usuń wszystkie pliki *.bad w katalogu /opt/apigee/nginx/conf.d.
5. Uruchom ponownie komponent edge-router.