Using the Command-Line Interface | Intel 1520 instruction

Chapter 5

Using the Command-Line Interface

This chapter describes the command-line utility that you can use to conﬁgure the system’s network addresses and to control, conﬁgure, and monitor the Intel NetStructure Cache Appliance.

This chapter contains the following sections:

◆Starting the command-line interface‚ on page 50

◆Navigating the command-line interface‚ on page 51

◆Using the setup menu‚ on page 52

◆Using the main menu‚ on page 54

◆Using the conﬁg menu‚ on page 61

◆Using the monitor menu‚ on page 99

◆Using the expert menu‚ on page 107

◆Using the save menu‚ on page 108

◆Using the load menu‚ on page 108

49

Image 61

Intel 1520 manual Using the Command-Line Interface

Contents

Intel NetStructure 1520 Cache Appliance Copyright 2000, Intel Corporation. All rights reserved Contents Configuring the Appliance Using the Command-Line Interface Troubleshooting Problems 109 Error Messages 151 Changing network address configuration on the NIC Contents 106 Preface Conventions used in this manual Who should read this manualConvention Purpose Bold Introduction Chapter Why use this caching appliance? What is an Intel NetStructure Cache Appliance?Flexible cache architecture Web proxy cache Intel NetStructure Cache Appliance features Multithreading process support Secure, single-point administrationHigh-speed caching Broad protocol support Snmp Network Management How to use this guidePerformance reporting To find out about … See …Page Getting Started Starting the system for the first time Controls and physical features on your system Command-line interface‚ on Hhmmss Getting Started Accessing the Manager UI Dashboard Using Monitor and Configure mode Monitor mode frame Configure mode frame Accessing the command-line interface Using online helpChanging passwords Verifying that caching worksPage Monitoring Appliance Performance Using the Dashboard Accessing monitor pages Dashboard alert lights Resolving alarmsExposing node detail Alert light Condition Description Changing the selected node Using the Node Using the Protocols Using the GraphsUsing the Cache Using the ARM Using the Mrtg Using the Other Configuring the Appliance Using the Server Basics Accessing configure pages NetStructure Cache section Setting general optionsOption Description Setting virtual IP addressing options Setting Web management optionsUsing virtual IP addressing for node failover What are virtual IP addresses? Adding entries to the Virtual IP address list Setting throttling of network connections Setting browser auto configuration optionsConfiguring load-shedding Enabling Snmp agents Option Definition Configuring Http Configuring Nntp Name and port see Option Definition FTP Configuring FTP Cache activation Freshness Storage For IMS If Modified Since revalidation requests Following table describes the variable conﬁguration options Variable content Using the Routing Using the SecurityLink displays the Change Administrator’s Password Setting Http parent caching options Establishing ICP peers Setting ICP options Field Description Option Description Setting server accelerator options Checking transparency Using the Host DatabaseChecking Wccp Configuring the host database Another invalid hostname message to the user Using the Snapshots Configuring DNS Reaching the Snapshots Using the Command-Line Interface Using the appliance after initial start-up Starting the command-line interfaceStarting the appliance the first time To do this Do this Navigating the command-line interface Changing network addresses configuration Using the setup menu Changing the DNS address and domain name Changing the controller speed and transmission modeChanging the gateway address Configuring date and time settings Configuring time zone settingsViewing current network address settings Using the main menu Starting the appliance Checking the status of the Server and ManagerStopping the appliance Viewing and maintaining versions of the software Installing a new version of the appliance software Application upgrade OS/Application upgrade Patch upgradeRunning a different version of the appliance software Deleting a version of the appliance software Clearing statistics Halting the System Rebooting the System Using the config menu Resetting to factory settingsPreparing a cache disk Setting general controls Configuring Http options Configuring protocol options Configuring Nntp options Conﬁguring Nntp servers Tag Description Following table describes the tags you can use in a rule Tag Description Examples Conﬁguring Nntp access If access is Authenticator is User is Pass is Following table lists the access directive options Configuring FTP options Configuring Secure Socket Layer SSL port Primary Destination Allowed Value Setting filter rules Action Value Secondary Specifier Allowed Value Setting remap rules Target Enabling caching for different protocols Configuring the cache Setting object freshness options Setting disk storage options Following table shows the options Configuring caching rules Request URL method use one of the following Destip=112.12.12.12 scheme=ftp action=never-cache Controlling client access to the appliance Configuring security options Controlling access to the Manager UI Configuring and maintaining ICP peers Configuring routing optionsViewing and modifying ICP rules Following table describes each ﬁeld Mcttl Example Enabling and disabling ICP Viewing current ICP settings Setting the ICP query timeout Setting the ICP port numberEnabling and disabling multicast in ICP Controlling parent proxy caching Action Tag Allowed Value Secondary Specifiers Allowed Value Action Tag Allowed Value Configuring Wccp options Enabling and disabling transparent redirection Configuring the Adaptive Redirection Module ARM Rule Description Configuring ARM bypass rules Rule Format Bypass rules have the following format Configuring load-shedding options Configuring the host database options Option Description Configuring logging options Viewing Node statistics Using the monitor menuStatistic Description Cache Progress Statistic Description Viewing Protocol statisticsNetwork Statistics Description Server Statistics Description Client Statistics Description Operations Originating Statistics Description QueriesFrom this Node From ICP Peers Viewing Cache statistics Viewing Other statistics Statistic Description Using the expert menu Using the load menu Using the save menuUsing the logoff menu Troubleshooting Problems Rebooting your system from the CLI Rebooting your system Upgrading software Page Appendix a Caching Solutions and Performance Day in the life of a cache request Web proxy caching Cache miss Ensuring cached object freshness Http object freshness tests Revalidating objectsExpires header test Last-Modiﬁed / Date header test Deciding whether to serve Http objects Default testRevalidate rules Configuring Http revalidation Configuring Http freshness options Caching Http alternates Configuring Http cachabilityTo cache or not to cache? Directive source Caching directives Transparent proxy caching Interception strategies Serving requests transparently Using a layer 4-aware switch to filter transparency requests Using a WCCP-enabled router for transparency Using policy-based routing to filter transparency requests ARM redirection Using a router to ﬁlter Http requests Appliance adaptive bypass Adaptive interception bypassMore about bypass rules Static and dynamic adaptive bypass Configuring bypass optionsSource bypass Destination bypass Server acceleration How server acceleration works Advantages of server accelerationRetrieving requested documents Whereas the corresponding proxy request would look like this Web server redirects Understanding server acceleration mapping rules User Request Translated Request Examples of rules and translations User Request Origin Server Header Translated Header Http cache hierarchies Understanding cache hierarchies Miss ICP cache hierarchies Bombay Nntp cache hierarchies News article caching Appliance as a caching proxy news server Appliance as a news serverSupporting several parent news servers Clustering Blocking particular groupsSeveral news servers supplying the same groups Several servers supplying different groups Transparency Maintaining the cache updates and feedsPosting Pull the overview information for speciﬁed groups Pull the articles for speciﬁed groups Configuring Access controlDynamically subscribe to speciﬁed groups Take a partial feed push for speciﬁed groups Obeying Nntp control messages Self-tuning DataFlow coreClient bandwidth throttling Carrier-class architecture Raw-disk object store Fine-grained parallelismAlias-free caching Fast space reclamation Advanced protocol features AlarmsHigh-availability Fast kernel packet engine Monitor Dashboard Virtual IP failover Expansion capabilities Node fault toleranceLoad shedding Centralized administration Client ACL Page Appendix B Error Messages Title Code Description Html messages sent to clients Appendix B Error Messages 153 Message Description Standard Http response messages Appendix B Error Messages 155 Page Glossary DNS ISP POP Wccp Page Index News server features