Lista zmiennych środowiskowych

Zmienne środowiskowe umożliwiają sterowanie zachowaniem agenta w czasie wykonywania.

Zmienne środowiskowe można wbudować w agenta za pomocą strony Zmienne środowiskowe. W systemach Windows zmienne środowiskowe są zdefiniowane w pliku KXXENV agenta. W systemach UNIX i Linux te zmienne można ustawić w pliku CANDLEHOME/config/XX.ini agenta. gdzie XX jest dwuznakowym kodem produktu. W celu aktywacji nowych ustawień agenta należy zrestartować.

Uwaga: Zmienne środowiskowe nie są poprawnie ustawiane w systemie zdalnym z powłoką csh (C Shell). Aby skorzystać ze zmiennych środowiskowych, należy użyć innej powłoki.

Tabela 1. Zmienne środowiskowe. Tabela zawierająca zmienne środowiskowe, ich wartości domyślne, zakresy poprawnych wartości oraz opis
Zmienna środowiskowa	Wartość domyślna	Poprawne wartości	Opis
`CDP_GRUPA_ATRYBUTÓW_REFRESH_INTERVAL`	Nie dotyczy	Dowolna nieujemna liczba całkowita	Przedział czasu w sekundach między kolejnymi aktualizacjami określonej grupy atrybutów w tle. Ta zmienna działa tak samo, jak `CDP_DP_REFRESH_INTERVAL`, ale docelowa jest tylko określona grupa atrybutów. Nazwa grupy atrybutów w nazwie zmiennej musi być zapisana wielkimi literami, nawet jeśli faktyczna nazwa grupy atrybutów jest zapisana inaczej.
`CDP_DP_ CACHE_TTL`	`55`	Każda liczba całkowita większa lub równa 1.	Liczba sekund, przez jaką dane zgromadzone dla grupy atrybutów są buforowane. Różne żądania dotyczące tych samych danych w tym samym czasie otrzymują kopię danych z pamięci podręcznej. Ta wartość ma zastosowanie do wszystkich grup atrybutów w agencie.
`CDP_GRUPA_ATRYBUTÓW _CACHE_TTL`	Wartość atrybutu `CDP_DP_ CACHE_TTL`.	Każda liczba całkowita większa lub równa 1.	Liczba sekund, przez jaką dane zgromadzone dla podanej grupy atrybutów są buforowane. Różne żądania dotyczące tych samych danych w tym samym czasie otrzymują kopię danych z pamięci podręcznej. Ta wartość nadpisuje wartość `CDP_DP_CACHE_TTL` dla określonej grupy. Nazwa grupy atrybutów w nazwie zmiennej musi być zapisana wielkimi literami, nawet jeśli faktyczna nazwa grupy atrybutów jest zapisana inaczej.
`CDP_DP_IMPATIENT_COLLECTOR_TIMEOUT`	`5`, jeśli są zdefiniowane podwęzły, w przeciwnym razie ta wartość nie jest ustawiona	Dowolna dodatnia liczba całkowita	Liczba sekund oczekiwania na zgromadzenie danych, po której nastąpi przekroczenie limitu czasu i zwrócone zostaną dane z pamięci podręcznej, nawet jeśli są one nieaktualne. Dane z pamięci podręcznej są nieaktualne, jeśli są starsze niż liczba sekund określona w zmiennej `CDP_DP_CACHE_TTL`. Jeśli ta zmienna nie jest ustawiona, agent będzie oczekiwał na zakończenie operacji gromadzenia danych. Oczekiwanie może niekiedy spowodować przekroczenie limitu czasu w produkcie Tivoli Enterprise Portal i rezygnację z oczekiwania. Jeśli nie jest skonfigurowana żadna pula wątków, ta zmienna jest ignorowana, a gromadzenie danych odbywa się synchronicznie.
`CDP_DP_REFRESH_INTERVAL`	`60`, jeśli są zdefiniowane podwęzły, w przeciwnym razie ta wartość nie jest ustawiona	Dowolna nieujemna liczba całkowita	Przedział czasu w sekundach między kolejnymi aktualizacjami grup atrybutów w tle. Jeśli ta zmienna nie jest ustawiona lub jest ustawiona na 0, aktualizacje w tle są wyłączone. Jeśli pula wątków jest skonfigurowana (patrz zmienna `CDP_DP_THREAD_POOL_SIZE`), grupy atrybutów mogą być odświeżane jednocześnie. Jeśli nie ma puli wątków, aktualizacje odbywają się szeregowo, co jest czasochłonne. Taka sytuacja jest logicznie równoważna puli wątków o wielkości 1.
`CDP_DP_THREAD_POOL_SIZE`	`15`, jeśli są zdefiniowane podwęzły, w przeciwnym razie ta wartość nie jest ustawiona	Dowolna nieujemna liczba całkowita	Liczba wątków tworzonych w celu gromadzenia danych w tle, z odstępem określonym przez zmienną `CDP_DP_REFRESH_INTERVAL`. Jeśli ta zmienna nie jest ustawiona lub jest ustawiona na 0, nie ma puli wątków. Jeśli zmienna `CDP_DP_THREAD_POOL_SIZE` jest ustawiona na wartość większą niż 1, a zmienna `CDP_DP_REFRESH_INTERVAL` nie jest ustawiona na wartość 0, wartość zmiennej `CDP_DP_THREAD_POOL_SIZE` będzie ignorowana, a gromadzenie danych będzie wykonywane na żądanie. Grupa atrybutów Status puli wątków udostępnia informacje o działaniu puli wątków. Status puli wątków pozwala dostosować wielkość puli wątków oraz częstotliwość odświeżania w celu osiągnięcia najlepszych wyników. Domyślnie zapytanie dotyczące tej grupy atrybutów nie jest wyświetlane w drzewie Nawigatora agenta. Można nie pamiętać o dołączeniu zapytania do niestandardowego obszaru roboczego dla agenta. Jednak można łatwo wyświetlić je, przypisując zapytanie dotyczące statusu puli wątków do widoku obszaru roboczego na poziomie agenta podstawowego.
`CDP_JDBC_MAX_ROWS`	`1000`	Dowolna dodatnia liczba całkowita	Maksymalna liczba wierszy danych zwracanych przez dostawcę danych JDBC. Zestaw wynikowy zawierający więcej wierszy jest przetwarzany tylko do podanej wartości maksymalnej. Można przygotować zapytania zapobiegające zwracaniu zbyt dużej ilości danych z programu IBM® Tivoli Monitoring.
`CDP_NT_EVENT_LOG_GET_ALL_ENTRIES_FIRST_TIME`	`NO`	YES (tak), NO (nie)	Jeśli ustawiona jest wartość TAK, agent wysyła zdarzenie dla każdego zdarzenia w dzienniku zdarzeń Windows. Jeśli ustawiona jest wartość NO, wysyłane są tylko nowe zdarzenia z dziennika zdarzeń Windows.
`CDP_NT_EVENT_LOG_CACHE_TIMEOUT`	`3600`	Każda liczba całkowita większa lub równa 300.	Liczba sekund, przez jaką zdarzenia z dziennika zdarzeń Windows są buforowane przez agenta. Wszystkie buforowane zdarzenia są zwracane wówczas, gdy zostanie wygenerowane zapytanie dotyczące grupy atrybutów dziennika zdarzeń. Uwaga: Ta zmienna nie jest już używana. Użyj zmiennej `CDP_PURE_EVENT_CACHE_SIZE`.
`CDP_PURE_EVENT_CACHE_SIZE`	`100`	Każda dodatnia liczba całkowita większa lub równa 1.	Maksymalna liczba zdarzeń, jaka może być buforowana, gdy dla źródła danych pliku dziennika skonfigurowano przetwarzanie nowych rekordów, dla grupy atrybutów Dziennik zdarzeń Windows oraz monitorów i powiadomień JMX. Każdy nowy rekord w dzienniku powoduje wysłanie zdarzenia. Ta zmienna środowiskowa definiuje liczbę zdarzeń buforowanych przez agenta. Buforowane wartości są zwracane wówczas, gdy zostanie wygenerowane zapytanie dotyczące grupy atrybutów.
`CDP_DP_ACTION_TIMEOUT`	`20` sekund	Każda dodatnia liczba całkowita większa lub równa 1.	Liczba sekund oczekiwania na zakończenie obsługiwania przez agenta wykonywanego działania.
`CDP_DP_SCRIPT_TIMEOUT`	`30` sekund	Każda dodatnia liczba całkowita większa lub równa 10.	Liczba sekund oczekiwania na zakończenie działania programu uruchamianego przez grupę atrybutów wykorzystującą skrypt.
`CDP_DP_PING_TIMEOUT`	`30` sekund	Każda dodatnia liczba całkowita większa lub równa 10.	Liczba sekund oczekiwania na zakończenie działania programu uruchamianego przez kod powrotu komendy. Uwaga: Ta zmienna nie jest powiązana z dostawcą danych ICMP ping.
`CDP_SNMP_MAX_RETRIES`	`2`	Dowolna dodatnia liczba całkowita	Liczba prób ponownego wysłania żądania SNMP. Całkowita liczba żądań wysłanych do agenta SNMP jest równa tej wartości i powiększona o jeden, jeśli nie odebrano żadnych odpowiedzi.
`CDP_SNMP_RESPONSE _TIMEOUT`	`2` sekundy	Dowolna dodatnia liczba całkowita	Liczba sekund oczekiwania na upływ limitu czasu każdego żądania SNMP. Każdy wiersz w grupie atrybutów jest osobnym żądaniem. Ta wartość limitu czasu jest liczbą sekund oczekiwania na odpowiedź przed ponowieniem próby. Łączny limit czasu dla jednego wiersza danych wynosi (`CDP_SNMP_MAX_RETRIES` + 1) * `CDP_SNMP_RESPONSE_TIMEOUT`. Domyślna całkowita wartość przekroczenia limitu czasu to (2+1) * 2 = 6 sekund.
`CDP_DP_HOSTNAME`	Nazwa pierwszego zainstalowanego interfejsu sieciowego	Adres IP lub nazwa hosta	Ustawia preferowaną nazwę hosta (interfejsu sieciowego) w systemie z wieloma kartami sieciowymi. Tę zmienną środowiskową należy użyć, gdy agent tworzy powiązanie z niepożądanym adresem sieciowym w celu nasłuchiwania. Używana jest przez dostawcę danych SNMP. Dla źródeł danych gniazda ta zmienna ma zastosowanie, jeśli także ustawiono zmienną `CDP_DP_ALLOW_REMOTE`.
`CDP_SNMP_ALLOW_DECREASING_OIDS`	`NO`	YES (tak), NO (nie)	Ustawienie wartości YES spowoduje, że dostawca danych SNMP nie będzie sprawdzać, czy zwracane kolejne identyfikatory OID mają zwiększającą się wartość. Wartość YES należy stosować z ostrożnością, ponieważ w agencie monitorowania mogą wystąpić problemy.
`KUMP_DP_COPY_MODE_ SAMPLE_INTERVAL`	`60`	Czas oczekiwania w sekundach	Dla dostawcy danych z pliku dziennika określa czas oczekiwania przed ponownym odczytem zawartości pliku, gdy dla agenta zdefiniowano opcję Przetwórz wszystkie rekordy podczas próbkowania pliku. Ten czas jest wyrażony w sekundach.
`KUMP_MAXPROCESS`	`100%`	5-100%	Dla dostawcy danych z pliku dziennika określa maksymalne wykorzystanie procesora na potrzeby przetwarzania danych pliku. Dozwolona wartość należy do zakresu od 5 do 100 procent. Wartością domyślną jest 100 procent.
`KUMP_DP_SAMPLE_FACTOR`	`5`	Dowolna nieujemna liczba całkowita	Dla dostawcy danych z pliku dziennika ustawia współczynnik próbkowania, gdy w programie Agent Builder jest wybrana opcja Przetwórz wszystkie rekordy podczas próbkowania pliku. Ten czas jest potrzebny, aby zapisać wzorce obejmujące wiele rekordów przed zarejestrowaniem operacji skanowania dla wzorca.
`KUMP_DP_EVENT`	`5`	Dowolna nieujemna liczba całkowita	Dla dostawcy danych z pliku dziennika ustawia częstotliwość próbkowania danych zdarzenia w sekundach.
`KUMP_DP_FILE_EXIST_WAIT`	`YES`	YES (tak), NO (nie)	Dla dostawcy danych z pliku dziennika określa, że wątek monitorowania pliku będzie kontynuować swoje działanie, jeśli wykryje brak pliku lub jeśli plik ten będzie pusty. Wątek będzie oczekiwać na utworzenie pliku, sprawdzając go co kilka sekund. Gdy plik stanie się dostępny, monitorowanie zostanie uruchomione.
`KUMP_DP_FILE_SWITCH_CHECK_INTERVAL`	`600`	Dowolna nieujemna liczba całkowita	Częstotliwość w sekundach, z jaką dostawca danych z pliku dziennika przeszukuje różne pliki do przełączenia, gdy włączona jest obsługa dynamicznych nazw plików.
`KUMP_DP_FILE_ROW_PAUSE_INCREMENT`	Brak	Dowolna nieujemna liczba całkowita	Dla dostawcy danych z pliku dziennika określa, ile rekordów plików jest odczytywanych, zanim zostanie wstrzymane działanie wątku monitorowania pliku. Wstrzymanie działania umożliwia przetworzenie poprzednich aktualizacji. Zmiennej tej należy użyć tylko wtedy, gdy w monitorowanym pliku zapisywana jest duża ilość nowych rekordów w grupach i gdy istnieje obawa, że niektóre aktualizacje mogłyby zostać utracone.
`CDP_COLLECTION_TIMEOUT`	`60` sekund	Dowolna dodatnia liczba całkowita	Liczba sekund, przez jaką agent oczekuje na odpowiedź z modułu gromadzącego dane uruchomionego w innym procesie. Przykłady to moduły gromadzące dane JMX, JDBC, HTTP i SOAP.
`CDP_SSH_TEMP_DIRECTORY`	`.` (kropka)	Dowolny poprawny łańcuch ścieżki w zdalnym systemie	Dla dostawcy danych używającego protokołu SSH określa lokalizację w zdalnym systemie. Pliki skryptów, które są dostarczane z agentem, są przesyłane do tej lokalizacji. Lokalizacja względna jest określana w odniesieniu do katalogu osobistego użytkownika. Wartość domyślna `.` (kropka) oznacza katalog osobisty użytkownika.
`CDP_SSH_DEL_COMMAND`	`rm -Rf`	Dowolny poprawny łańcuch komendy usuwania w zdalnym systemie	Dla dostawcy danych używającego protokołu SSH określa komendę uruchamianą w celu usunięcia wysłanych plików skryptowych dostarczonych z agentem.
`CDP_SNMP_SEND_DELAY_ FACTOR`	`0` milisekund	Dowolna dodatnia liczba całkowita	Początkowa komenda wysyłania SNMP jest opóźniona o podaną liczbę milisekund. Ta wartość jest włączona tylko wtedy, jeśli włączona jest także pula wątków. Opóźnienie nie dotyczy wszystkich operacji wysyłania, a tylko pierwszych operacji wysyłania wykonanych przez grupę atrybutów. Zmienna ta jest przydatna w sytuacjach, gdy monitorowane urządzenie może czasami nie odpowiadać poprawnie, jeśli otrzymuje wiele żądań w tym samym czasie.
`CDP_ICMP_PING_REFRESH_INTERVAL`	`60` sekund	Każda liczba całkowita większa lub równa 1	Określa odstęp między komendami ping wysyłanymi do urządzeń umieszczonych na liście w pliku. Jeśli wysyłanie pakietów ping zajmuje zbyt wiele czasu, przed kolejnym rozpoczęciem ich wysłania następuje opóźnienie o wartości przynajmniej `CDP_PING_MIN_INTERVAL_DELAY` sekund. Dane są odświeżane z maksymalnie taką częstotliwością. Mogą być odświeżane rzadziej, w zależności od liczby pozycji w pliku z listą urządzeń oraz od czasu, jaki zajmuje odebranie odpowiedzi.
`CDP_ICMP_PING_MIN_INTERVAL_DELAY`	`30` sekund	Każda liczba całkowita większa lub równa 1 i mniejsza od okresu odświeżania dla `CDP` Ping	Po wysłaniu pakietów ping do urządzeń wpisanych w pliku listy urządzeń następny okres odświeżania komend ping nie rozpocznie się przed upływem liczby sekund zdefiniowanej w tej zmiennej.
`CDP_ICMP_PING_BURST`	`10`	Każda liczba całkowita większa lub równa 0	Liczba pakietów ping, które są wysyłane przed wstrzymaniem wysyłania na czas podany w zmiennej `CDP_ICMP_PING_BURST_DELAY`. Podanie wartości 0 wyłącza tę funkcję.
`CDP_ICMP_PING_BURST_DELAY`	`10`	Każda liczba całkowita większa lub równa 0	Czas w milisekundach oczekiwania po wysłaniu liczby pakietów ping zdefiniowanej w zmiennej `CDP_ICMP_PING_BURST`. Podanie wartości 0 wyłącza tę funkcję.
`CDP_ICMP_PING_TIMEOUT`	`2000` milisekund	Każda liczba całkowita większa lub równa 1	Liczba milisekund oczekiwania na odpowiedź na pakiet ping. To ustawienie dotyczy każdej wykonanej próby ping. Dla każdego hosta są wykonywane trzy próby ping. Jeśli po wykonaniu trzech prób nie zostanie odebrana żadna odpowiedź, łączny czas oczekiwania na odpowiedź będzie wynosić `CDP_ICMP_PING_TIMEOUT` pomnożone przez 3. Domyślnie wartość ta wynosi 6000 ms. Zmiana wartości parametru `CDP_ICMP_PING_TIMEOUT` powoduje, że domyślne wyliczanie wartości `TIMEOUT` dla atrybutu bieżącego czasu odpowiedzi nie ma już zastosowania. Należy zmienić wartość wyliczania `TIMEOUT` na nową wartość `CDP_ICMP_PING_TIMEOUT` pomnożoną przez 3.
`CDP_JDBC_CONNECTIONLESS`	`false`	true, false	Po ustawieniu wartości true połączenia JDBC są zamykane po każdorazowej próbie pobrania danych. Oznacza to, że wszystkie grupy atrybutów przy każdorazowym pobieraniu danych próbują utworzyć własne połączenie. Po włączeniu tej zmiennej połączenia nie będą wykorzystywane ponownie. Po ustawieniu wartości false z bazą danych będzie nawiązane jedno połączenie, które będzie współużytkowane przez grupy atrybutów.
`CDP_SSH_EXCLUDED_ ENVIRONMENT_VARIABLES`	Brak	Lista rozdzielanych przecinkami nazw zmiennych środowisk.	Dla dostawcy danych używającego skryptów SSH określa zestaw zmiennych środowiskowych, które nie mogą być ustawiane w środowisku zdalnego systemu.
`CDP_DP_EVENT_LOG_MAX_BACKLOG_TIME`	`0` sekund	0, 1 lub dowolna wartość całkowita większa od 1	Jeśli ta zmienna zostanie ustawiona na wartość 0, a zmienna `CDP_DP_EVENT_LOG_MAX_ BACKLOG_EVENTS` nie ma ustawionej jako wartości liczby całkowitej większej lub równej 1, nie są przetwarzane zdarzenia wygenerowane w czasie, gdy agent był wyłączony. Wartością domyślną jest 0. Jeśli ta zmienna zostanie ustawiona na wartość 1, a zmienna `CDP_DP_EVENT_LOG_MAX_ BACKLOG_EVENTS` nie ma ustawionej jako wartości liczby całkowitej większej od 1, przetwarzane są wszystkie zdarzenia wygenerowane w czasie, gdy agent był wyłączony. Jeśli ta zmienna ma wartość większą niż 1, a zmienna `CDP_DP_EVENT_LOG_MAX_ BACKLOG_EVENTS` nie jest ustawiona na wartość większą niż 1, przetwarzane są zdarzenia wygenerowane w ciągu tej liczby sekund bieżącego czasu komputera. Jeśli na przykład wartość przy uruchamianiu została ustawiona na 300, agent przetworzy wszystkie zdarzenia wygenerowane w ciągu 300 sekund bieżącego czasu. Jeśli zostanie podana wartość większa od 1 dla obu zmiennych `CDP_DP_EVENT_LOG_MAX_BACKLOG _TIME` i `CDP_DP_EVENT_LOG_MAX _BACKLOG_EVENTS`, zostaną przetworzone zdarzenia z określonego czasu lub zostanie przetworzona określona liczba zdarzeń. Wybór zmiennej zależy od tego, która zostanie dopasowana jako pierwsza.
`CDP_DP_EVENT_LOG_ dziennik_zdarzeń_Windows_ MAX_BACKLOG_TIME`	`0` sekund (brak przetwarzania chybionych zdarzeń, gdy agent jest wyłączony)	0, 1 lub dowolna wartość całkowita większa od 1	Jeśli zostanie ustawiona wartość
`CDP_DP_EVENT_LOG_ MAX_BACKLOG_EVENTS`	`0` zdarzeń	0, 1 lub dowolna wartość całkowita większa od 1	Jeśli zostanie ustawiona wartość 0, a zmienna `CDP_DP_EVENT_LOG_MAX_BACKLOG _TIME` nie ma ustawionej jako wartości liczby całkowitej większej lub równej 1, nie są przetwarzane zdarzenia wygenerowane w czasie, gdy agent był wyłączony. Wartością domyślną jest 0. Jeśli zostanie ustawiona wartość 1, a zmienna `CDP_DP_EVENT_LOG_MAX_BACKLOG _TIME` nie ma ustawionej jako wartości liczby całkowitej większej od 1, przetwarzane są wszystkie zdarzenia wygenerowane w czasie, gdy agent był wyłączony. Jeśli zostanie ustawiona wartość większa od 1, a zmienna `CDP_DP_EVENT_LOG_MAX_BACKLOG _TIME` nie ma ustawionej wartości większej od 1, przetwarzana jest co najwyżej taka liczba zdarzeń wygenerowanych w czasie, gdy agent był wyłączony. Na przykład, jeśli wartość przy uruchamianiu została ustawiona na 200, agent przetworzy przy uruchamianiu 200 zdarzeń wygenerowanych bezpośrednio przed uruchomieniem. Jeśli zostanie podana wartość większa od 1 dla obu zmiennych `CDP_DP_EVENT_LOG_MAX_BACKLOG _EVENTS` i `CDP_DP_EVENT_LOG_MAX_BACKLOG _TIME`, zostanie przetworzona taka liczba zdarzeń lub zostaną przetworzone zdarzenia z tego odstępu czasu. Wybór zmiennej zależy od tego, która zostanie dopasowana jako pierwsza.
`CDP_DP_EVENT_LOG_ dziennik_zdarzeń_Windows_ MAX_BACKLOG_EVENTS`	`0` zdarzeń (brak przetwarzania chybionych zdarzeń, gdy agent jest wyłączony)	0 lub dowolna liczba całkowita większa lub równa 1	Jeśli zostanie ustawiona wartość
`CDP_HTTP_READ_TIMEOUT`	`10`	Dowolna dodatnia liczba całkowita	Liczba sekund oczekiwania na odpowiedź na żądanie HTTP.
`CDP_JAT_THREAD_POOL_SIZE`	`15`	Dowolna dodatnia liczba całkowita	Liczba wątków używanych przez dostawców Java™ do obsługi żądań gromadzenia danych. Z tej puli wątków mogą korzystać dostawcy JMX, JDBC, HTTP i SOAP.
`CDP_HTML_OBJECTS_THREAD_ POOL_SIZE`	`10`	Dowolna dodatnia liczba całkowita	Liczba wątków używanych do pobierania obiektów strony znalezionych w adresach URL monitorowanych przez dostawcę danych HTTP.
`CDP_HTTP_SOAP_MAX_ROWS`	`500`	Dowolna dodatnia liczba całkowita	Maksymalna liczba wierszy, która będzie zwrócona przez dostawcę HTTP SOAP.
`CDP_DP_ALLOW_REMOTE`	`NO`	`NO (nie), YES (tak)`	Jeśli zostanie ustawiona wartość Yes, agent zezwoli na zdalne połączenia z gniazdem. Jeśli zostanie ustawiona wartość No, agent zezwoli tylko na połączenia z gniazdem z hosta lokalnego. Wartością domyślną jest No.
`CDP_DP_INITIAL_ COLLECTION_DELAY`	różne	Dowolna dodatnia liczba całkowita	Liczba sekund od uruchomienia agenta, po upływie których pula wątków rozpoczyna wykonywanie zaplanowanych operacji gromadzenia danych.