Rozšírené nastavenia ukladania obsahu do medzipamäte na Macu
Pomocou rozšírených konfiguračných parametrov môžete vyladiť ukladanie obsahu do medzipamäte pre svoju sieťovú konfiguráciu.
Rozšírené možnosti konfigurácie obsahovej medzipamäte môžete nastaviť buď použitím príkazového riadka v Termináli, alebo úpravou hodnôt kľúčov v súbore /Library/Preferences/com.apple.AssetCache.plist. Aby sa niektoré zmeny prejavili, ukladania obsahu do medzipamäte sa musí zastaviť a reštartovať.
Nastavenie rozšírených nastavení
Môžete konfigurovať niektoré rozšírené nastavenia pre službu ukladania obsahu do medzipamäte tak, že prejdete do Systémových nastavení (macOS 13 alebo novší aj macOS 12.0.1 alebo starší) > Zdieľanie > Ukladanie obsahu do medzipamäte. Následne podržte kláves Option a vyberte Rozšírené možnosti.
Pomocou apky Terminál na Macu môžete konfigurovať ešte viac rozšírených nastavení pomocou príkazu defaults, za ktorým nasleduje príkaz sudo AssetCacheManagerUtil reloadSettings. Štandardné (nie rozšírené) nastavenia zobrazíte pomocou príkazu AssetCacheManagerUtil settings.
Pomocou príkazu defaults môžete nastaviť jednoduché aj zložené kľúče.
Ak chcete napríklad číslo portu (50000) stabilne nakódovať na nedynamické číslo portu, toto číslo portu musí byť akékoľvek číslo medzi 49192 až 65535 a potom ako správca vykonajte tento príkaz:
$ sudo -u _assetcache defaults write /Library/Preferences/com.apple.AssetCache.plist Port -int 50000ListenRanges je zložený kľúč, ktorý zahŕňa súbor slovníkov. Ak napríklad chcete nastaviť dve IP adresy pre kľúč ListenRanges, spustite nasledujúci príkaz ako správca:
$ sudo -u _assetcache defaults write /Library/Preferences/com.apple.AssetCache.plist ListenRanges '( { first = 10.0.0.1; last = 10.0.0.254; }, { first = 10.1.0.1; last = 10.1.0.254; } )'Po použití príkazu defaults nezabudnite spustiť nasledujúci príkaz, aby sa znova načítali nastavenia obsahovej medzipamäte:
$ sudo AssetCacheManagerUtil reloadSettingsKľúče a hodnoty súboru plist na konfiguráciu medzipamäte
Dôležité: V súbore com.apple.AssetCache.plist nemeňte žiadne iné nastavenia okrem tých, ktoré sú popísané v tabuľke nižšie.
Kľúč môže mať hodnotu, ktorá je ohraničená dvomi hodnotami. Hodnota kľúča môže byť akékoľvek číslo patriace do rozsahu medzi najnižšou a najvyššou hodnotou. Ak nastavíte hodnotu nižšiu, ako je dolná hranica, použije sa hodnota dolnej hranice. Ak nastavíte hodnotu vyššiu, ako je horná hranica, použije sa hodnota hornej hranice. Napríklad hodnota kľúča PeerDownloadTimeout je ohraničená hodnotami 5 a 300. Ak ju nastavíte na 301 alebo 1 000, hodnota sa nastaví na 300. Ak ju nastavíte na 4 alebo -10, hodnota sa nastaví na 5.
Niektoré zmeny sa prejavia po spustení príkazu AssetCacheManagerUtil reloadSettings, iné až po tom, čo zastavíte a reštartujete ukladanie obsahu do medzipamäte. Jediné kľúče, ktoré podporujú príkaz reloadSettings, sú tie, ktoré tiež možno nastaviť v nastaveniach ukladania obsahu do medzipamäte (je to uvedené v tabuľke nižšie). Nastavenie hodnôt v nastaveniach Ukladanie obsahu do medzipamäte:
macOS 13 alebo novší: Vyberte menu Apple > Systémové nastavenia > Všeobecné > Zdieľanie > Ukladanie obsahu do medzipamäte.
macOS 12.0.1 alebo starší: Vyberte menu Apple > Systémové nastavenia > Zdieľanie > Ukladanie obsahu do medzipamäte.
Kľúč | Popis | Predvolená hodnota | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
AgeForLowSpaceAlert | Upozorní vás na nedostatok miesta, ak sa z medzipamäte odstráni nejaký obsah v dôsledku nedostatku miesta v úložisku, pričom odstránený obsah bol do medzipamäte pridaný pred menej dňami, než je nastavená hodnota tohto kľúča. | 30 (dní) | |||||||||
AllowCacheDelete | Povolí automatické odstránenie obsahu z medzipamäte v prípade, že počítač potrebuje priestor v úložisku pre iné aplikácie. Ak chcete, aby bolo ukladanie obsahu do medzipamäte čo najefektívnejšie, toto nastavenie vypnite. | Áno | |||||||||
AllowImports | Povolí import (odoslanie) žiadostí. | Áno | |||||||||
AllowPersonalCaching | Povolí ukladať do medzipamäte užívateľské dáta z iCloudu. Aspoň jeden z kľúčov Túto hodnotu môžete nastaviť aj v nastaveniach Ukladanie obsahu do medzipamäte. | Áno | |||||||||
AllowSharedCaching | Kontroluje ukladanie obsahu nepochádzajúce z iCloudu, napríklad aplikácií a aktualizácií softvéru. Aspoň jeden z kľúčov | Áno | |||||||||
AllowWirelessPortable | Povolí notebookom Mac, ktoré majú len pripojenie k Wi‑Fi sieťam, spustiť ukladanie obsahu do medzipamäte. | Áno | |||||||||
CacheLimit | Určuje maximálny priestor v úložisku (v bajtoch) používaný pre obsahovú medzipamäť. Túto hodnotu môžete nastaviť aj v nastaveniach Ukladanie obsahu do medzipamäte. | 0 (neobmedzené) | |||||||||
DatabaseUpdateInterval | Určuje, ako často ukladá obsahová medzipamäť zmeny do svojej databázy v úložisku. Zvýšením tohto intervalu sa zvyšuje riziko straty uloženého obsahu pri výpadku napájania. Maximum je 3 600 sekúnd (1 hodina). Interval s hodnotou 0 znamená, že databáza sa bude vždy aktualizovať okamžite, bez omeškania, čo môže znížiť výkon. | 5 (sekúnd) | |||||||||
DataPath | Určuje cestu k adresáru, ktorý sa používa na uchovanie obsahu v medzipamäti. Ak manuálne zmeníte toto nastavenie, neznamená to, že obsah uložený v medzipamäti sa automaticky presunie zo starého do nového umiestnenia. Ak chcete obsah presunúť automaticky, použite nastavenia Ukladanie obsahu do medzipamäte. Túto hodnotu môžete nastaviť aj v nastaveniach Ukladanie obsahu do medzipamäte. | /Library/Application Support/Apple/AssetCache/Data | |||||||||
DisplayAlerts | Zobrazí hlásenia s upozorneniami týkajúcimi sa ukladania obsahu do medzipamäte. Ak chcete, aby bolo ukladanie obsahu do medzipamäte čo najefektívnejšie, toto nastavenie zapnite. | Nie | |||||||||
DownloadMinRate | Určuje minimálny počet bajtov za sekundu, ktorý musí klient zvládnuť preniesť pri sťahovaní obsahu z obsahovej medzipamäte. Obsahová medzipamäť zastaví sťahovania, pri ktorých sa dáta prenášajú pomalšie, ako je táto rýchlosť. Ohraničené minimum je 1 000 bajtov za sekundu. | 8 000 (bajtov za sekundu) | |||||||||
DownloadTimeout | Určuje, ako dlho (v sekundách) môže sťahovanie ku klientovi zostať nečinné, kým sa odosielanie nepreruší. Ohraničené minimum je 10 sekúnd. | 180 (sekúnd) | |||||||||
ImportMaxRate | Určuje maximálny počet bajtov za sekundu, ktorý obsahová medzipamäť prijíma od každého klienta. Hodnota 0 znamená neobmedzený počet bajtov za sekundu. | 0 (bajtov za sekundu) | |||||||||
ImportMinRate | Určuje minimálny počet bajtov za sekundu, ktorý musí klient zvládnuť preniesť pri importovaní (odosielaní) obsahu. Obsahová medzipamäť zastaví importy, pri ktorých sa dáta prenášajú pomalšie, ako je táto rýchlosť. Minimálna rýchlosť je 100 bajtov za sekundu. | 2 000 (bajtov za sekundu) | |||||||||
ImportRateAttenuation | Určuje percento oslabenia pridané k času odosielania. Ohraničené minimum je 0 % oslabenie. Príliš veľké hodnoty prekročia hodnotu kľúča ImportTimeout a spôsobia zlyhanie. | .20 (percentá) | |||||||||
ImportTimeout | Určuje, ako dlho (v sekundách) môže import (odosielanie) od klienta zostať nečinný, kým sa odosielanie nepreruší. Minimum je 10 sekúnd. | 300 (sekúnd) | |||||||||
Interface | Určuje názov BSD sieťového rozhrania, ktoré bude používať obsahová medzipamäť. Napríklad en0. Vždy vykonáva listen na loopback rozhraní (localhost). | Listen vo vybraných rozhraniach | |||||||||
KeepAwake | Udržuje počítač v prebudenom stave, keď je ukladanie obsahu do medzipamäte zapnuté. Za účelom najlepšej dostupnosti ukladania obsahu do medzipamäte zapnite toto nastavenie. Na paneli Šetrič energie v Systémových nastaveniach zaškrtnite políčko Zabrániť automatickému zaspávaniu počítača po vypnutí displeja. | Nie | |||||||||
ListenRanges | Súbor slovníkov popisujúci rozsah klientskych IP adries, ktoré sa majú obslúžiť. Nižšie si pozrite príklad použitia kľúča Subkľúč typu už nie je potrebný, a ak sa vyskytuje, bude sa ignorovať. Túto hodnotu môžete nastaviť aj v nastaveniach Ukladanie obsahu do medzipamäte. | žiadne | |||||||||
ListenRangesOnly | Ak je kľúč Ak chcete použiť kľúč Túto hodnotu môžete nastaviť aj v nastaveniach Ukladanie obsahu do medzipamäte. | Nie | |||||||||
ListenWithPeersAndParents | Označuje, či sa ukladanie do medzipamäte zaregistruje zjednotením kľúčov Upozorňujeme, že kľúč | Predvolená hodnota závisí od histórie počítača:
| |||||||||
LocalSubnetsOnly | Označuje, či má obsahová medzipamäť poskytovať obsah klientom v rovnakej bezprostrednej lokálnej sieti, v akej sa nachádza ona, a nie klientom vo všetkých lokálnych sieťach, ktoré sú v dosahu obsahovej medzipamäte. Túto hodnotu môžete nastaviť aj v nastaveniach Ukladanie obsahu do medzipamäte. | Áno | |||||||||
LogClientIdentity | Určuje, či má obsahová medzipamäť zaznamenať IP adresu a číslo portu klientov, ktorí žiadajú obsah. | Nie | |||||||||
MaxConcurrentClients | Určuje maximálny počet klientov, ktorý podporuje obsahová medzipamäť. Spoločnosť Apple nezaručuje, že obsahová medzipamäť môže dosiahnuť 3 400 súbežných klientov. | 3 400 | |||||||||
MaxParentDepth | Určuje, koľkokrát maximálne (pre jednu žiadosť) môže podradená obsahová medzipamäť presmerovať žiadosť nadradenej obsahovej medzipamäti. Žiadosti, ktoré sú príliš hlboké (reťazec presmerovania je príliš dlhý), sú nasmerované k zdroju a nie k nadradenej medzipamäti. | 8 | |||||||||
MaxPeersToQuery | Určuje maximálny počet partnerských obsahových medzipamätí, ktoré možno žiadať o obsah. | 0 (neobmedzené) | |||||||||
MetricsInterval | Určuje, ako často (v sekundách) sa má pridávať riadok metrík do databázy metrík v súbore /Library/Application Support/Apple/AssetCache/Metrics/Metrics.db.
Hodnota musí byť v rozsahu od 1 do 60 sekúnd (vrátane). Tieto metriky môžete vidieť na paneli Medzipamäť v aplikácii Monitor aktivity. | 60 (sekúnd) | |||||||||
MetricsMaxAge | Metriky staršie ako táto hodnota sa raz denne odstránia z databázy metrík. Ohraničené minimum je 30 dní. | 30 (dní) | |||||||||
OriginDownloadTimeout | Určuje, ako dlho (v sekundách) môže obsah sťahovaný zo serverov Apple zostať nečinný, kým sa sťahovanie nepreruší (a kým sa pravdepodobne nebude pokus o stiahnutie opakovať). Hodnota musí byť v rozsahu od 5 do 300 sekúnd vrátane. | 60 | |||||||||
OriginUploadTimeout | Určuje, ako dlho (v sekundách) môže obsah odosielaný na pôvodný server zostať nečinný, kým sa odosielanie nepreruší. Hodnota musí byť v rozsahu od 5 do 3600 sekúnd vrátane. | 600 | |||||||||
ParentDownloadTimeout | Určuje, ako dlho (v sekundách) môže obsah sťahovaný z nadradenej obsahovej medzipamäte zostať nečinný, kým sa sťahovanie nepreruší (a kým sa pravdepodobne nebude pokus o stiahnutie opakovať). Hodnota musí byť v rozsahu od 5 do 300 sekúnd vrátane. | 60 | |||||||||
ParentRetryInterval | Určuje, ako dlho (v sekundách) sa majú ignorovať nadradené obsahové medzipamäte po tom, čo päťkrát po sebe zaznamenali zlyhanie siete alebo chyby servera. Hodnota musí byť v rozsahu od 30 do 3 600 sekúnd vrátane. | 900 | |||||||||
Parents | Zoznam lokálnych IP adries iných obsahových medzipamätí, ktoré by mala táto obsahová medzipamäť používať na sťahovanie alebo odosielanie obsahu namiesto sťahovania alebo odosielania priamo od/do Apple. Neplatné adresy a adresy počítačov, ktoré nie sú obsahovými medzipamäťami, budú ignorované. Nadradené medzipamäte, ktoré nebudú k dispozícii, sa preskočia podľa kľúča Ak budú nedostupné všetky nadradené obsahové medzipamäte, obsahová medzipamäť bude sťahovať obsah priamo z Apple a odosielať ho tam, až kým niektorá nadradená medzipamäť nebude znova dostupná. Túto hodnotu môžete nastaviť aj v nastaveniach Ukladanie obsahu do medzipamäte. | žiadne | |||||||||
ParentSelectionPolicy | Pravidlá, ktoré sa použijú pri výbere z viacerých nakonfigurovaných nadradených obsahových medzipamätí. V prípade každého pravidla sa preskočia tie nadradené medzipamäte, ktoré sú dočasne nedostupné. K dispozícii sú tieto pravidlá:
Túto hodnotu môžete nastaviť aj v nastaveniach Ukladanie obsahu do medzipamäte. | round-robin | |||||||||
ParentUploadTimeout | Určuje, ako dlho (v sekundách) môže obsah odosielaný do nadradenej obsahovej medzipamäte zostať nečinný, kým sa odosielanie nepreruší. Hodnota musí byť v rozsahu od 5 do 3 600 sekúnd vrátane. | 600 | |||||||||
PeerDownloadTimeout | Určuje, ako dlho (v sekundách) môže obsah sťahovaný z partnerskej obsahovej medzipamäte zostať nečinný, kým sa sťahovanie nepreruší (a kým sa pravdepodobne nebude pokus o stiahnutie opakovať). Hodnota musí byť v rozsahu od 5 do 300 sekúnd vrátane. | 30 | |||||||||
PeerFilterRanges | Keď kľúč Obsahová medzipamäť bude odosielať žiadosti len partnerským medzipamätiam definovaným v kľúči Ak je kľúč Keď má kľúč Keď má kľúč Kľúč Subkľúč typu už nie je potrebný, a ak sa vyskytuje, bude sa ignorovať. Túto hodnotu môžete nastaviť aj v nastaveniach Ukladanie obsahu do medzipamäte. | žiadne | |||||||||
PeerListenRanges | Keď kľúč Ak je kľúč Keď je kľúč Keď má kľúč Hodnota kľúča Keď obsahová medzipamäť odpovie na žiadosť inej medzipamäte chybou, žiadajúca obsahová medzipamäť označí odpovedajúcu medzipamäť za nepriateľskú a nebude sa jej pokúšať odoslať ďalšiu žiadosť dovtedy, kým neuplynie čas nastavený v kľúči Subkľúč typu už nie je potrebný, a ak sa vyskytuje, bude sa ignorovať. Túto hodnotu môžete nastaviť aj v nastaveniach Ukladanie obsahu do medzipamäte. | žiadne | |||||||||
PeerLocalSubnetsOnly | Označuje, či má obsahová medzipamäť vytvoriť partnerstvo len s obsahovými medzipamäťami v rovnakej bezprostrednej lokálnej, v akej sa nachádza ona, a nie vytvárať partnerstvá s medzipamäťami s rovnakou verejnou IP adresou ako tento počítač. Ak je kľúč Keď má kľúč Keď má kľúč Keď má kľúč Túto hodnotu môžete nastaviť aj v nastaveniach Ukladanie obsahu do medzipamäte. | Áno | |||||||||
PeerNotifyTimeout | Určuje, ako dlho (v sekundách) sa má čakať na odpoveď od partnerských obsahových medzipamätí po tom, čo sa im pri spustení odošle ping. Hodnota musí byť v rozsahu od 5 do 300 sekúnd vrátane. | 30 | |||||||||
PeerQueryTimeout | Určuje, ako dlho (v sekundách) sa má čakať na odpoveď od partnerských obsahových medzipamätí, keď sa im odošle dopyt na ich obsah. Hodnota musí byť v rozsahu od 1 do 60 sekúnd vrátane. | 5 | |||||||||
PeerRetryInterval | Určuje, ako dlho (v sekundách) sa majú ignorovať partnerské obsahové medzipamäte po tom, čo trikrát po sebe zaznamenali zlyhania týkajúce sa oznámenia alebo žiadosti. Po uplynutí intervalu pre opätovný pokus sa partnerské obsahové medzipamäte vrátia späť na zoznam medzipamätí, ktorým možno posielať žiadosti o obsah. Hodnota musí byť v rozsahu od 30 do 3 600 sekúnd vrátane. | 900 (sekúnd) | |||||||||
PersonalCacheLimit | Obmedzuje, akú veľkú časť úložiska použije obsahová medzipamäť na uchovanie dát z iCloudu (v bajtoch). Hodnota kľúča | 0 (neobmedzené) | |||||||||
Port | Určuje číslo portu TCP, cez ktorý obsahová medzipamäť prijíma žiadosti o odoslanie alebo stiahnutie. | 0 (použije sa náhodný port) | |||||||||
PruneAffinitiesAge | Užívateľské afinity staršie ako tento počet dní budú automaticky odstránené z medzipamäte afinít. Užívateľské afinity poskytujú nápovedy pre klientov ohľadom toho, kde je uložený ich obsah, s cieľom zlepšiť výkonnosť. Obmedzenie užívateľských afinít nemá žiaden vplyv na obsah uložený v medzipamäti. Ohraničené minimum je sedem dní. | 30 (dní) | |||||||||
PruneAffinitiesInterval | Určuje, ako často (v dňoch) má obsahová medzipamäť vyhľadávať a odstraňovať užívateľské afinity staršie ako počet dní definovaný v kľúči | 7 (dní) | |||||||||
PruneAssetsAge | Obsah, ktorý nebol vyžiadaný takýto počet dní, bude automaticky odstránený z obsahovej medzipamäte. Ohraničené minimum je sedem dní. | 120 (dní) | |||||||||
PruneAssetsInterval | Určuje, ako často (v dňoch) má obsahová medzipamäť vyhľadávať a odstraňovať obsah starší ako počet dní definovaný v kľúči | 7 (dní) | |||||||||
PublicRanges | Určuje rozsahy verejných IP adries, ktoré by mali cloudové servery použiť na priradenie klientov k obsahovým medzipamätiam. Túto hodnotu môžete nastaviť aj v nastaveniach Ukladanie obsahu do medzipamäte. | žiadna predvolená hodnota | |||||||||
ReservedVolumeSpace | Určuje minimálny počet bajtov voľného priestoru úložiska, ktorý sa má udržiavať pre oddiel ukladajúci obsah do medzipamäte. | 2 000 000 000 (2 GB) | |||||||||
TerminationTimeout | Určuje, ako dlho (v sekundách) sa má obsahová medzipamäť pokúšať odregistrovať v prípade, že je zastavená. Odregistrovanie medzipamäte informuje klientov o tom, že príslušná medzipamäť už viac nie je dostupná, takže sa ju už viac nebudú pokúšať používať (alebo dovtedy, kým nebude opäť spustená). Hodnota musí byť v rozsahu od 1 do 60 sekúnd vrátane. | 10 (sekúnd) | |||||||||
Verbose | Ak má kľúč Záznamy obsahovej medzipamäte zobrazíte pomocou príkazu Napríklad: Na zobrazenie záznamov môžete použiť aj aplikáciu Konzola. | Nie | |||||||||
Príklad kľúča ListenRanges
Kľúč ListenRanges môžete použiť na určenie preferovaných obsahových medzipamätí v pokročilých topológiách siete, kde sa používa viacero obsahových medzipamätí s rovnakou verejnou IP adresou.
Napríklad:
Medzipamäť caching1.melardclothing.com používa kľúč
ListenRangesna definovanie rozsahu 10.0.0.1 až 10.0.0.254 a 10.1.0.1 až 10.1.0.254 a nastavuje kľúčListenRangesOnlyna možnosť Nie.Medzipamäť caching2.melardclothing.com používa kľúč
ListenRangesna definovanie rozsahu 10.1.0.1 až 10.1.0.39 (všimnite si prekrytie s druhým rozsahom caching1) a nastavuje kľúčListenRangesOnlyna možnosť Nie.Ak klient s IP adresou 10.0.0.10 odošle žiadosť o obsah, bude nasmerovaný do medzipamäte caching1.
Ak klient s IP adresou 10.1.0.10 odošle žiadosť o obsah, bude na základe náhodného výberu nasmerovaný buď do medzipamäte caching1, alebo do medzipamäte caching2.
Ak klient s IP adresou 10.2.0.10 odošle žiadosť o obsah, bude na základe náhodného výberu nasmerovaný buď do medzipamäte caching1, alebo do medzipamäte caching2.
Ak bude medzipamäť caching1 vypnutá alebo bez napájania, ale medzipamäť caching2 bude stále dostupná, všetci klienti budú nasmerovaní do medzipamäte caching2.
Príklad súboru plist
Toto je príklad súboru /Library/Preferences/com.apple.AssetCache.plist.
<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"><plist version="1.0"><dict> <key>CacheLimit</key> <!-- Set a CacheLimit of 200 GB --> <integer>200000000000</integer> <key>DataPath</key> <string>/Volumes/BigVolume/Library/Application Support/Apple/AssetCache/Data</string> <key>Interface</key> <string>en1</string> <key>ListenRanges</key> <array> <dict> <key>type</key> <string>IPv4</string> <key>first</key> <string>10.1.2.1</string> <key>last</key> <string>10.1.2.254</string> </dict> <dict> <key>type</key> <string>IPv6</string> <key>first</key> <string>2001:500:88:200::1</string> <key>last</key> <string>2001:500:88:200::99</string> </dict> </array> <key>LogClientIdentity</key> <string>true</string> <key>Port</key> <integer>12345</integer> <key>ReservedVolumeSpace</key> <!-- Set the ReservedVolumeSpace to 1 GB --> <integer>1000000000</integer></dict></plist>