Konfigurer avanserte innstillinger for innholdsbufring
Du kan finjustere innholdsbufring for nettverkskonfigurasjonen.
Du kan angi avanserte konfigurasjonsinnstillinger for innholdsbufferen enten ved hjelp av kommandolinjen i Terminal, eller ved å endre verdien til nøklene i filen /Library/Preferences/com.apple.AssetCache.plist. For at enkelte endringer skal tre i kraft, må innholdsbufring stoppes og startes på nytt.
Du kan angi avanserte konfigurasjonsparametere ved hjelp av defaults
-kommandoen, etterfulgt av kommandoen sudo AssetCacheManagerUtil reloadSettings
. Bruk kommandoen AssetCacheManagerUtil settings
til å vise standardinnstillingene (ikke-avanserte).
Hvis du vil ha mer informasjon om AssetCacheManagerUtil
-kommandoen, kan du lese Administrer innholdsbufring fra kommandolinjen og man-siden for AssetCacheManagerUtil(8).
Bruk defaults-kommandoen til å angi konfigurasjonsparametere
Du kan angi både enkle og avanserte nøkler med defaults
-kommandoen.
Hvis du for eksempel vil angi en1 for Interface
-nøkkelen, utfører du denne kommandoen som administrator:
$ sudo -u _assetcache defaults write /Library/Preferences/com.apple.AssetCache.plist Interface -string en1
ListenRanges
er en avansert nøkkel som bruker en serie med ordbøker. Du kan for eksempel utføre denne kommandoen som administrator for å angi to IP-adresseområder for ListenRanges-nøkkelen:
$ 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; } )'
Etter at du bruker defaults-kommandoen, forsikrer du deg om at du kjører følgende kommando for å laste inn innholdsbufferinnstillingene på nytt:
$ sudo AssetCacheManagerUtil reloadSettings
Hvis du vil ha mer informasjon om defaults
-kommandoen, kan du gå til man-siden for defaults(1).
Nøkler og verdier for plist-filen for bufringskonfigurasjon
Viktig: Ikke endre andre innstillinger i filen com.apple.AssetCache.plist enn de som er beskrevet i tabellen nedenfor.
En nøkkel kan ha en verdi som tvinges til å være mellom to verdier. Nøkkelverdien kan være alle tall i området mellom den laveste og den høyeste verdien. Hvis verdien angis til et tall under den nedre grenseverdien, brukes den nedre grenseverdien. Hvis verdien angis til et tall over den øvre grenseverdien, brukes den øvre grenseverdien. PeerDownloadTimeout tvinges for eksempel til en verdi mellom 5 og 300. Hvis verdien angis til 301 eller 1000, settes verdien til 300. Hvis verdien angis til 4 eller -10, settes verdien til 5.
Enkelte endringer trer i kraft etter at du kjører AssetCacheManagerUtil reloadSettings
. Andre krever at du stopper og deretter starter innholdsbufring på nytt. De eneste nøklene som støtter reloadSettings er de som også kan angis i Innholdsbufring-valg (merket i tabellen under). Hvis du vil angi verdier i Innholdsbufring-valg, velger du Apple-menyen > Systemvalg, klikker på Deling og klikker deretter på Innholdsbufring.
Nøkkel | Beskrivelse | Standard | |||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
AgeForLowSpaceAlert | Når innhold tømmes fra innholdsbufferen fordi det er lite diskplass, og innholdet som ble tømt ble lagt til i innholdsbufferen for mindre enn dette antallet dager siden, ser du et varsel om lite plass. | 30 (dager) | |||||||||
AllowCacheDelete | Tillat at innhold tømmes fra bufferen automatisk når datamaskinen trenger diskplass for andre programmer. | Yes | |||||||||
AllowImports | Tillat importforespørsler (opplasting). | Yes | |||||||||
AllowPersonalCaching | Tillat bufring av brukernes iCloud-data. Minst én av AllowPersonalCaching- eller AllowSharedCaching-nøklene må ha «yes». Du kan også angi denne verdien i Innholdsbufring-valg. | Yes | |||||||||
AllowSharedCaching | Kontrollerer bufringen av ikke-iCloud-innhold, for eksempel apper og programvareoppdateringer. Minst én av AllowPersonalCaching- eller AllowSharedCaching-nøklene må ha «yes». | Yes | |||||||||
AllowWirelessPortable | Tillat at bærbare datamaskiner som kun har Wi-Fi-nettverksforbindelse, kjører innholdsbufring. | Yes | |||||||||
CacheLimit | Maksimalt antall byte med diskplass som vil bli brukt til innholdsbufferen. Du kan også angi denne verdien i Innholdsbufring-valg. | 0 (ubegrenset) | |||||||||
DatabaseUpdateInterval | Hvor ofte innholdsbufferen arkiverer endringer til databasen på disken. Hvis intervallet økes, blir risikoen større for å miste bufret innhold etter et strømbrudd. Maksimum er 3600 sekunder (1 time). Et intervall på 0 betyr alltid oppdater databasen umiddelbart, uten forsinkelse, noe som reduserer ytelsen. | 5 (sekunder) | |||||||||
DataPath | Banen til katalogen som ble brukt til å lagre bufret innhold. Hvis du endrer denne innstillingen manuelt, flyttes ikke bufret innhold fra det gamle til det nye stedet. Hvis du vil flytte innhold automatisk, bruker du Innholdsbufring-valg (se Angi et volum for bufring). Du kan også angi denne verdien i Innholdsbufring-valg. | /Library/Application Support/Apple/AssetCache/Data | |||||||||
DownloadMinRate | Minimum antall byte per sekund som klientene må håndtere under nedlasting av innhold fra innholdsbufferen. Innholdsbufferen stopper nedlastinger som overfører data saktere enn denne hastigheten. Tvunget minimum er 1000 byte per sekund. | 8000 (byte per sekund) | |||||||||
DownloadTimeout | Hvor lenge, i sekunder, en nedlasting til en klient kan være uten aktivitet før tjenesten gir opp. Tvunget minimum er 10 sekunder. | 180 (sekunder) | |||||||||
ImportMaxRate | Maksimalt antall byte per sekund for data som innholdsbufferen kan motta data med fra hver klient. Verdien 0 angir et ubegrenset antall byte per sekund. | 0 (byte per sekund) | |||||||||
ImportMinRate | Minimum antall byte per sekund som klientene må håndtere under import (opplasting) av innhold. Innholdsbufferen stopper importer som overfører data saktere enn denne hastigheten. Minimumshastigheten er 100 byte per sekund. | 2000 (byte per sekund) | |||||||||
ImportRateAttenuation | Prosentandelen attenuasjon som legges til opplastingstiden. Tvunget minimum er 0 % attenuasjon. For store verdier overskrider ImportTimeout og fører til feil. | .20 (prosentandel) | |||||||||
ImportTimeout | Hvor lenge, i sekunder, en import (opplasting) fra en klient kan være uten aktivitet før tjenesten gir opp. Minimum er 10 sekunder. | 300 (sekunder) | |||||||||
Interface | BSD-navnet på et nettverksgrensesnitt som skal brukes av innholdsbufferen. | Listen on all interfaces | |||||||||
ListenRanges | En rekke med ordlister som beskriver området med klient-IP-adresser som skal betjenes. Se under for et eksempel ved bruk av ListenRanges-nøkkelen. Du kan også angi denne verdien i Innholdsbufring-valg. | none | |||||||||
ListenRangesOnly | Hvis ListenRangesOnly er satt til sann, gir innholdsbufferen innhold kun til klienter i områdene som er angitt av ListenRanges-nøkkelen. Hvis du vil bruke ListenRangesOnly-nøkkelen, må du også angi ListenRanges-nøkkelen. Du kan også angi denne verdien i Innholdsbufring-valg. | No | |||||||||
ListenWithPeersAndParents | Indikerer om innholdsbufring registreres med ListenRanges-, PeerListenRanges- og Parents-nøklene, eller bare med ListenRanges-nøkkelen. Merk at ListenRanges kan genereres automatisk fra LocalSubnetsOnly, og PeerListenRanges kan genereres automatisk fra PeerLocalSubnetsOnly. | Standardverdien avhenger av loggen til datamaskinen:
| |||||||||
LocalSubnetsOnly | Hvorvidt innholdsbufferen skal tilby innhold kun til klienter på det samme umiddelbare lokale nettverket som innholdsbufferen, i stedet for til klienter på alle lokale nettverk som innholdsbufferen kan nå. Du kan også angi denne verdien i Innholdsbufring-valg. | Yes | |||||||||
LogClientIdentity | Bestemmer hvorvidt innholdsbufferen skal loggføre IP-adressen og portnummeret til klientene som ber om innhold. | No | |||||||||
MaxConcurrentClients | Denne grensen settes for å forhindre at innholdsbufferen går tom for fildeskriptorer. Apple garanterer ikke at en innholdsbufferen kan betjene 3400 klienter parallelt. | 3400 | |||||||||
MaxParentDepth | Det maksimale antallet ganger, for én forespørsel, at en underordnet innholdsbuffer videresender forespørselen til en overordnet innholdsbuffer. Forespørsler som er for dype (videresendingskjeden er for lang) tvinges til opprinnelsen i stedet for en overordnet. | 8 | |||||||||
MaxPeersToQuery | Maksimalt antall peer-enhet-innholdsbuffere som skal spørres om innhold. | 0 (ubegrenset) | |||||||||
MetricsInterval | Hvor ofte, i antall sekunder, du bør legge til en rad med målinger i målingsdatabasen i /Library/Application Support/Apple/AssetCache/Metrics/Metrics.db.
Tvinges til en verdi fra og med 1 til og med 60 sekunder. Du kan vise disse målingene i Buffer-panelet i Aktivitetsmonitor. | 60 (sekunder) | |||||||||
MetricsMaxAge | Målinger som er eldre enn dette, blir fjernet fra databasen for målinger én gang om dagen. Tvunget minimum er 30 dager. | 30 (dager) | |||||||||
OriginDownloadTimeout | Hvor lenge, i sekunder, en nedlasting fra Apples tjenere kan være uten aktivitet før tjenesten gir opp (og muligens prøver å laste ned en gang til). Tvinges til en verdi fra og med 5 til og med 300. | 60 | |||||||||
OriginUploadTimeout | Hvor lenge, i sekunder, en opplasting til en opprinnelig tjener kan være uten aktivitet før tjenesten gir opp. Tvinges til en verdi fra og med 5 til og med 3600. | 600 | |||||||||
ParentDownloadTimeout | Hvor lenge, i sekunder, en nedlasting fra en overordnet innholdsbuffer kan være uten aktivitet før tjenesten gir opp (og muligens prøver å laste ned en gang til). Tvinges til en verdi fra og med 5 til og med 300 sekunder. | 60 | |||||||||
ParentRetryInterval | Hvor lenge, i sekunder, overordnede innholdsbufre skal ignoreres etter at de har samlet opp fem sammenhengende nettverkssvikt eller tjenerfeil. Tvinges til en verdi fra og med 30 til og med 3600 sekunder. | 900 | |||||||||
Parents | En liste over de lokale IP-adressene til andre innholdsbufre fra hvor denne bufferen skal laste ned eller opp innhold i stedet for å laste ned fra eller laste opp til Apple direkte. Ugyldige adresser og adresser for datamaskiner som ikke er innholdsbufre ignoreres. Overordnede buffere som blir utilgjengelige utelates i henhold ParentRetryInterval. Hvis alle overordnede innholdsbuffere blir utilgjengelige, vil innholdsbufferen laste ned fra eller laste opp til Apple direkte inntil en overordnet innholdsbuffer igjen blir tilgjengelig. Du kan også angi denne verdien i Innholdsbufring-valg. | none | |||||||||
ParentSelectionPolicy | Regelen som skal brukes når du velger blant flere enn én konfigurert overordnet innholdsbuffer. Med alle regler blir overordnede buffere som er midlertidig utilgjengelige utelatt. Reglene er:
Du kan også angi denne verdien i Innholdsbufring-valg. | round-robin | |||||||||
ParentUploadTimeout | Hvor lenge, i sekunder, en opplasting til en overordnet innholdsbuffer kan være uten aktivitet før den gir opp. Tvinges til en verdi fra og med 5 til og med 3600 sekunder. | 600 | |||||||||
PeerDownloadTimeout | Hvor lenge, i sekunder, en nedlasting fra en peer-innholdsbuffer kan være uten aktivitet før tjenesten gir opp (og muligens prøver å laste ned en gang til). Tvinges til en verdi fra og med 5 til og med 300. | 30 | |||||||||
PeerFilterRanges | Når PeerFilterRanges er en rekke (med oppføringer som de for ListenRanges), filtrerer og sorterer innholdsbufferen listen over peer-enheter i henhold til områdene i rekken. Innholdsbufferen spør kun peer-enheter som er i PeerFilterRanges. Filtreringen og sorteringen utføres før listen over peer-tjenere i MaxPeersToQuery-oppføringene avkuttes (hvis denne innstillingen finnes). Når PeerFilterRanges er en tom rekke, spør ikke innholdsbufferen noen peer-enheter. Når PeerFilterRanges har den boolske verdien sann, gjør innholdsbufferen det samme som over, men bruker verdien for ListenRanges i stedet for PeerFilterRanges. Når PeerFilterRanges er av en annen type eller verdien mangler, verken filtrerer eller sorterer innholdsbufferen listen over peer-enheter før listen kuttes ved MaxPeersToQuery-oppføringer. PeerFilterRanges påvirker kun listen over andre innholdsbuffere som denne innholdsbufferen spør etter innhold og nedlastinger. Det har ingen effekt på innkommende forespørsler om innhold fra andre innholdsbuffere. Du kan også angi denne verdien i Innholdsbufring-valg. | none | |||||||||
PeerListenRanges | Når PeerListenRanges er en rekke ordlister der hver ordliste representerer et IP-adresseområde, svarer innholdsbufferen kun på peer-bufferforespørsler fra innholdsbuffere med en IP-adresse som ligger innenfor denne områderekken. Når PeerListenRanges er en tom rekke, svarer innholdsbufferen med en feil på bufferforespørsler fra alle andre innholdsbuffere. Når PeerListenRanges har den boolske verdien sann, bruker innholdsbufferen verdien for ListenRanges i stedet for PeerListenRanges for å avgjøre hvilke andre innholdsbufferen som den vil svare på bufferforespørsler fra. Når PeerListenRanges har en annen type eller verdien mangler, svarer innholdsbufferen på bufferforespørsler fra alle andre innholdsbuffere. PeerListenRanges påvirker kun hvilke innholdsbuffere som denne innholdsbufferen svarer på bufferforespørsler fra. Det har ingen effekt på listen over peer-enheter som denne innholdsbufferen spør etter innhold og laster ned innhold fra. Når en innholdsbuffere svarer på en bufferforespørsel med en feil, merker innholdsbufferen som sendte forespørselen, innholdsbufferen som svarte, som uvennlig, og forsøker ikke å sende flere forespørsler før tiden som er angitt for PeerRetryInterval har utløpt. Du kan også angi denne verdien i Innholdsbufring-valg. | none | |||||||||
PeerLocalSubnetsOnly | Hvorvidt innholdsbufferen kun skal opprette peer-forbindelser med andre innholdsbuffere på samme umiddelbare lokalnettverk, i stedet for med innholdsbuffere som bruker samme offentlige IP-adresse som denne datamaskinen. Når PeerLocalSubnetsOnly er sann, sender innholdsbufferen kun forespørsler og svarer på peer-forespørsler fra innholdsbuffere på det samme umiddelbare lokale nettverket. Når PeerLocalSubnetsOnly er true, overstyrer det konfigurasjonen til PeerFilterRanges og PeerListenRanges. Når PeerLocalSubnetsOnly er usann, overlater innholdsbufferen til PeerFilterRanges og PeerListenRanges å konfigurere peering-restriksjonene. Når PeerLocalSubnetsOnly er sann og nettverket endres, oppdateres peering-restriksjonene for det lokale nettverket i henhold til dette. Du kan også angi denne verdien i Innholdsbufring-valg. | Yes | |||||||||
PeerNotifyTimeout | Hvor lenge, i sekunder, det skal ventes på svar fra peer-innholdsbuffere når de pinges ved oppstart. Tvinges til en verdi fra og med 5 til og med 300. | 30 | |||||||||
PeerQueryTimeout | Hvor lenge, i sekunder, det skal ventes på svar fra peer-innholdsbuffere når de blir spurt om innhold i bufferne. Tvinges til en verdi fra og med 1 til og med 60. | 5 | |||||||||
PeerRetryInterval | Hvor lenge, i sekunder, peer-innholdsbuffere skal ignoreres etter at de har samlet opp tre mislykkede varslinger eller forespørsler på rad. Når intervallet for nye forsøk er utløpt, gjenopprettes peer-innholdsbufferen til listen over peer-enheter som skal spørres om innhold. Tvinges til en verdi fra og med 30 til og med 3600. | 900 (sekunder) | |||||||||
PersonalCacheLimit | Begrenser hvor mye diskplass innholdsbufferen vil bruke til bufrede iCloud-data, i byte. PersonalCacheLimit må ikke overstige CacheLimit. | 0 (ubegrenset) | |||||||||
Port | TCP-portnummeret der innholdsbufring godtar forespørsler om opplastinger eller nedlastinger. | 0 (bruk en tilfeldig port) | |||||||||
PruneAffinitiesAge | Brukertilknytninger som er eldre enn dette antallet dager, fjernes automatisk fra tilknytningsbufferen. Brukertilknytninger gir hint til klienter når det gjelder hvor innholdet deres er bufret for at ytelsen skal bli bedre. Reduksjon i brukertilknytninger har ingen innvirkning på bufret innhold. Tvunget minimum er 7 dager. | 30 (dager) | |||||||||
PruneAffinitiesInterval | Hvor ofte, i dager, innholdsbufferen bør skanne etter og fjerne brukertilknytninger som er eldre enn antallet dager som er angitt for PruneAffinitiesAge. Brukertilknytninger, som brukes kun av iCloud, gir hint til klienter når det gjelder hvor innholdet deres er bufret for at ytelsen skal bli bedre. Reduksjon i brukertilknytninger har ingen innvirkning på bufret innhold. Tvunget minimum er én dag. | 7 (dager) | |||||||||
PruneAssetsAge | Innhold som ikke er blitt etterspurt i dette antallet dager fjernes fra innholdsbufferen automatisk. Tvunget minimum er 7 dager. | 120 (dager) | |||||||||
PruneAssetsInterval | Hvor ofte, i dager, innholdsbufferen bør skanne etter og fjerne innhold som er eldre enn antallet dager som er angitt for PruneAssetsAge. Tvunget minimum er én dag. | 7 (dager) | |||||||||
PublicRanges | Områder med offentlige IP-adresser som nettskytjenerne bør bruke for å finne klienter som samsvarer med innholdsbuffere. Du kan også angi denne verdien i Innholdsbufring-valg. | no default | |||||||||
ReservedVolumeSpace | Minimum antall byte med ledig diskplass som skal beholdes for volumet som lagrer det bufrede innholdet. | 2000000000 (2 GB) | |||||||||
TerminationTimeout | Hvor lenge, i sekunder, innholdsbufferen skal prøve å avregistrere når den, stoppes. Avregistrering informerer klientene om at innholdsbufferen ikke lenger er tilgjengelig slik at de ikke lenger prøver å bruke innholdsbufferen (eller til innholdsbufferen startes igjen). Tvinges til en verdi fra og med 1 til og med 60. | 10 (sekunder) | |||||||||
Verbose | Når Verbose=sann, logger innholdsbufferen litt mer informasjon om aktiviteten. Økt loggføring kan redusere ytelsen. Denne innstillingen anbefales ikke for langsiktig bruk. Bruk For eksempel: Du kan også bruke programmet Konsoll til å vise loggene. | No |
Om ListenRanges-nøkkelen
Du kan bruke ListenRanges-nøkkelen til å angi foretrukne innholdsbuffere i avanserte nettverkstopologier der flere innholdsbuffere brukes bak samme offentlige IP-adresse.
For eksempel:
caching1.example.com bruker ListenRanges-nøkkelen til å angi et område på 10.0.0.1 til 10.0.0.254 og 10.1.0.1 til 10.1.0.254, og setter ListenRangesOnly-nøkkelen til No.
caching2.example.com bruker ListenRanges-nøkkelen til å angi et område på 10.1.0.1 til 10.1.0.39 (legg merke til overlappingen med det andre området i caching1), og setter ListenRangesOnly-nøkkelen til No.
Hvis en klient med IP-adressen 10.0.0.10 ber om innhold, sendes den til caching1.
Hvis en klient med IP-adressen 10.1.0.10 ber om innhold, sendes den enten til caching1 eller caching2, valgt tilfeldig.
Hvis en klient med IP-adressen 10.2.0.10 ber om innhold, sendes den enten til caching1 eller caching2, valgt tilfeldig.
Hvis caching1 stenges eller mister strømmen mens caching2 fortsatt er tilgjengelig, sendes alle klienter til caching2.
Eksempel på plist-fil
Følgende er et eksempel på /Library/Preferences/com.apple.AssetCache.plist-filen.
<?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/BigDisk/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>