[Joke-RFC] RFC2325 SMIv2 によるドリップ式加熱飲料用ハードウェアのマネージドオブジェクトの定義

# はじめに

* この文書は [RFC2325](https://www.rfc-editor.org/rfc/rfc2325.txt) を勉強と好奇心のため適当に訳したものです。
* 翻訳の正確さは全く保証しません。
* 誤字誤訳等の指摘はいつでも大歓迎です。

# Definitions of Managed Objects for Drip-Type Heated Beverage Hardware Devices using SMIv2

SMIv2 によるドリップ式加熱飲料用ハードウェアのマネージドオブジェクトの定義

* Network Working Group
* Request for Comments: 2325
* Category: Informational

- M. Slavitch
- Loran Technologies Inc.
- 1 April 1998

## Status of this Memo（このメモの位置づけ）

> This memo provides information for the Internet community.
> It does not specify an Internet standard of any kind.
> Distribution of this memo is unlimited.

このメモは、インターネットコミュニティのための情報を提供するものである。
このメモは、いかなる種類のインターネット標準も規定するものではない。
このメモの配布は無制限である。

## Copyright Notice

```
   Copyright (C) The Internet Society (1998).  All Rights Reserved.
```

## Table of Contents

```
   1. Introduction ...............................................    1
   2. The SNMPv2 Network Management Framework ....................    1
   2.1 Object Definitions ........................................    2
   3. Overview ...................................................    2
   3.1 Relationship to Interface MIB .............................    2
   4. Definitions ................................................    3
   5. Acknowledgements ...........................................    6
   6. References .................................................    6
   7. Security Considerations ....................................    6
   8. Author's Address ...........................................    7
   9. Full Copyright Statement ...................................    8
```

## 1.  Introduction（導入）

> This memo defines an extension to the Management Information Base (MIB) for use with network management protocols in the Internet community.
> In particular, it defines objects for the management of coffee-brewing and maintenance devices.

このメモでは、インターネットコミュニティのネットワーク管理プロトコルで使用するための、管理情報ベース（MIB）の拡張を定義している。
特に、コーヒー抽出装置やメンテナンス装置の管理のためのオブジェクトを定義している。

## 2.  The SNMPv2 Network Management Framework（SNMPv2 ネットワーク管理フレームワーク）

> The SNMPv2 Network Management Framework consists of four major components.
> They are:
>
> *    RFC 1442 [1] which defines the SMI, the mechanisms used for describing and naming objects for the purpose of management.
> *    STD 17, RFC 1213 [2] defines MIB-II, the core set of managed objects for the Internet suite of protocols.
> *    RFC 1445 [3] which defines the administrative and other architectural aspects of the framework.
> *    RFC 1448 [4] which defines the protocol used for network access to managed objects.
>
> The Framework permits new objects to be defined for the purpose of experimentation and evaluation.

SNMPv2 ネットワーク管理フレームワークは、4つの主要なコンポーネントで構成されている。
以下の通り：

* RFC 1442 [1] は SMI を定義しており、管理を目的としたオブジェクトの記述と命名に使用されるメカニズムである。
* STD 17, RFC 1213 [2] は、インターネットの一連のプロトコルのためのマネージドオブジェクトのコアセットである MIB-II を定義している。
* RFC 1445 [3] は、管理および他のアーキテクチャの側面を定義している。
* RFC 1448 [4] は、マネージドオブジェクトへのネットワークアクセスに使用されるプロトコルを定義している。

フレームワークは、実験と評価の目的で新しいオブジェクトを定義することを許可している。

### 2.1.  Object Definitions（オブジェクトの定義）

> Managed objects are accessed via a virtual information store, termed the Management Information Base or MIB.
> Objects in the MIB are defined using the subset of Abstract Syntax Notation One (ASN.1) defined in the SMI.
> In particular, each object object type is named by an OBJECT IDENTIFIER, an administratively assigned name.
> The object type together with an object instance serves to uniquely identify a specific instantiation of the object.
> For human convenience, we often use a textual string, termed the descriptor, to refer to the object type.

マネージドオブジェクトは、管理情報ベース (Management Information Base) または MIB と呼ばれる仮想情報ストアを介してアクセスされる。
MIB 内のオブジェクトは、SMI で定義された ASN.1 (Abstract Syntax Notation One; ASN.1) のサブセットを使用して定義される。
特に、各オブジェクトのオブジェクトタイプは、管理上割り当てられた名前である OBJECT IDENTIFIER で命名される。
オブジェクトタイプは、オブジェクトインスタンスとともに、そのオブジェクトの特定のインスタンスを一意に識別する役割を果たす。
人間の利便性のために、我々はしばしば、記述子と呼ばれるテキスト文字列を使用して、オブジェクトタイプを参照する。

## 3.  Overview（概観）

> The COFFEE POT MIB applies to managed devices that brew, store, and deliver heated coffee beverages.
> The COFFEE POT MIB is mandatory for all systems that have such a hardware port supporting services managed through some other MIB.
>
> The MIB contains objects that relate to physical connections, configuration, storage levels, availability, quality of service, and availability.

COFFEE POT MIB は、加熱されたコーヒー飲料を抽出、保存、提供する管理対象機器に適用される。
COFFEE POT MIB は、他の MIB で管理されるサービスをサポートするハードウェアポートを持つすべてのシステムで必須である。

この MIB には、物理的な接続、構成、ストレージレベル、可用性、サービス品質、および可用性に関連するオブジェクトが含まれている。

（訳注：可用性が２回でてくるけど、誤記では無いらしい？　あるいは誤記だけど、あえて残しているみたい。詳細は [正誤表](https://www.rfc-editor.org/errata/rfc2325) を参照。重要なことなので２回書いている、とのこと）


### 3.1.  Relationship to Interface MIB（インタフェース MIB との関係）

> The COFFEE-POT-MIB is one of many MIBs designed for layered use as described in the Interface MIB [5].
> In most implementations where it is present, it will be in the lowest interface sublayer, that is, the COFFEE-POT-MIB represents the physical layer, providing service to higher layers such as the Character MIB [6].
>
> Although it is unlikely that a coffee port will actually be used as a network interface, which is the intent of the Interface MIB, the COFFEE-POT-MIB is closely connected to the Character MIB, which can share hardware interfaces with network operation, and relate to the RS-232 MIB [7].
>
> The Interface MIB's ifTestTable and ifRcvAddressTable are not relevant to the COFFEE-POT-MIB.
>
> The COFFEE-POT-MIB is relevant for ifType values sip(31), and perhaps others.
>
> The COFFEE-POT-MIB requires the conformance groups ifGeneralGroup, and ifFixedLengthGroup.
>
> Usefulness of error counters in this MIB depends on the octet counters in ifFixedLengthGroup.

COFFEE-POT-MIB は、インターフェース MIB [5] で説明されているように、階層的に使用するために設計された多くの MIB の 1 つである。
つまり、COFFEE-POT-MIB は物理層を表し、キャラクター MIB [6] のような高位の層にサービスを提供するものである。

コーヒーポートが実際にネットワークインタフェースとして使用されることはほとんどなく、それがインタフェース MIB の意図であるが、COFFEE-POT-MIB は、ネットワーク操作とハードウェアインタフェースを共有できるキャラクター MIB と密接に関係し、RS-232 MIB [7] に関連している。

インターフェース MIB の `ifTestTable` と `ifRcvAddressTable` は、COFFEE-POT-MIB には関係がない。

COFFEE-POT-MIB は、`ifType` の値 `sip(31)` と、おそらく他の値に関連している。

COFFEE-POT-MIB は、コンフォーマンスグループ `ifGeneralGroup` と `ifFixedLengthGroup` を必要とする。

この MIB のエラーカウンタの有用性は、`ifFixedLengthGroup` のオクテットカウンタに依存する。

## 4.  Definitions（定義）

```
   COFFEE-POT-MIB DEFINITIONS ::= BEGIN

   IMPORTS
       MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
       TimeStamp, TimeInterval,
       Counter32, Integer32
           FROM SNMPv2-SMI
       InterfaceIndex
           FROM IF-MIB
       transmission
           FROM RFC1213-MIB
       MODULE-COMPLIANCE, OBJECT-GROUP
           FROM SNMPv2-CONF;

   coffee MODULE-IDENTITY
        LAST-UPDATED "9803231700Z"
        ORGANIZATION "Networked Appliance Management Working Group"

        CONTACT-INFO
               "        Michael Slavitch
                        Loran Technologies,
                        955 Green Valley Crescent
                        Ottawa, Ontario Canada K2A 0B6

                   Tel: 613-723-7505
                   Fax: 613-723-7209
                E-mail: slavitch@loran.com"
        DESCRIPTION
               "The MIB Module for coffee vending devices."
       ::= { transmission 132 }
```

* コーヒー提供器用MIBモジュール

```
   potName OBJECT-TYPE
        SYNTAX     DisplayString (SIZE (0..255))
        MAX-ACCESS read-only
        STATUS current
        DESCRIPTION
                "The vendor description of the pot under management"
        ::= { coffee 1 }
```

* 管理下にあるポットの説明

```
   potCapacity OBJECT-TYPE
        SYNTAX Integer32
        MAX-ACCESS read-only
        STATUS current
        DESCRIPTION
           "The number of units of beverage supported by this device
            (regardless of its current state) ."
       ::= { coffee 2 }
```

* このデバイスがサポートする飲料の単位数(現在の状態には関係なし)

```
   potType OBJECT-TYPE
        SYNTAX     INTEGER {
           automatic-drip(1),
           percolator(2),
           french-press(3),
           espresso(4),
           }
        MAX-ACCESS read-only
        STATUS current
        DESCRIPTION
                "The brew type of the coffee pot."
        ::= { coffee 3 }
```

* コーヒーポットの抽出タイプ(自動ドリップ/パーコレーター/フレンチプレス/エスプレッソ)

```
   potLocation OBJECT-TYPE {
        SYNTAX     DisplayString (SIZE (0..255))
        MAX-ACCESS read-write
        STATUS current
        DESCRIPTION
                "The physical location of the pot in question"
        ::= { coffee 4 }
```

* 当該ポットの物理的な位置

```
   potMonitor            OBJECT IDENTIFIER ::= { coffee 6 }

   potOperStatus
        SYNTAX     Integer {
                        off(1),
                        brewing(2),
                        holding(3),
                        other(4),
                        waiting(5)
                        }
        MAX-ACCESS read-only
        STATUS current
        DESCRIPTION
                "The operating status of the pot in question. Note
                 that this is a read-only feature. Current hardware
                 prevents us from changing the port state via SNMP."
        ::= { potMonitor 1 }
```

* 当該ポットの動作状況(オフ/抽出中/保持中/その他/待機中)。これは読み取り専用であることに注意。現在のハードウェアでは、SNMP でポートの状態を変更することはできない。

```
    potLevel OBJECT-TYPE
        SYNTAX     Integer32
        MAX-ACCESS read-only
        STATUS current
        DESCRIPTION
                "The number of units of coffee under management. The
                 units of level are defined in potMetric below."
        ::= { potMonitor 2 }
```

* 管理されているコーヒーの単位数。レベルの単位は、以下の `potMetric` で定義されている。

```
    potMetric  OBJECT-TYPE
        SYNTAX     Integer {
                    espresso(1),
                    demi-tasse(2),
                    cup(3),
                    mug(4),
                    bucket(5)
                    }
        MAX-ACCESS read-only
        STATUS current
        DESCRIPTION
                "The vendor description of the pot under management"
        ::= { potMonitor 3 }
```

* （訳注：多分、説明は誤記）ポットの計量タイプ(エスプレッソ/デミタス/カップ/マグ/バスケット)

```
   potStartTime OBJECT-TYPE
       SYNTAX     Integer64
       MAX-ACCESS read-write
       STATUS     current
       DESCRIPTION
               "The time in seconds since Jan 1 1970 to start the pot
                if and only if potOperStatus is waiting(5)"
       ::= { potMonitor 4 }
```

* ポットの開始時刻。1970年1月1日からの秒数。`potOperStatus` が `waiting(5)` の場合のみ。

```
    lastStartTime OBJECT-TYPE
       SYNTAX     TimeInterval
       MAX-ACCESS read-only
       STATUS     current
       DESCRIPTION
               "The amount of time, in TimeTicks, since the coffee
               making process was initiated."
       ::= { potMonitor 5 }
```

* コーヒー抽出が開始されてからの経過時間

```
    potTemperature OBJECT-TYPE
       SYNTAX     Integer32
       UNITS      "degrees Centigrade"
       MAX-ACCESS read-only
       STATUS     current
       DESCRIPTION
               "The ambient temperature of the coffee within the pot"
      ::= { potMonitor 6 }

   END
```

* ポット内のコーヒーの温度

## 5.  Acknowledgements（謝辞）

> Networked Appliance Management Working Group (not) of the IETF.

IETF の Networked Appliance Management Working Group (ではない)。

## 6.  References

```
   [1] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Structure
       of Management Information for version 2 of the Simple Network
       Management Protocol (SNMPv2)", RFC 1442, April 1993.

   [2] McCloghrie, K., and M. Rose, Editors, "Management Information
       Base for Network Management of TCP/IP-based internets: MIB-II",
       STD 17, RFC 1213, March 1991.

   [3] Galvin, J., and K. McCloghrie, "Administrative Model for version
       2 of the Simple Network Management Protocol (SNMPv2)", RFC 1445,
       April 1993.

   [4] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Protocol
       Operations for version 2 of the Simple Network Management
       Protocol (SNMPv2)", RFC 1448, April 1993.

   [5] McCloghrie, K., and F. Kastenholz, "Evolution of the Interfaces
       Group of MIB-II", RFC 1573, January 1994.

   [6] Valdez, Juan, "Definitions of Columbian Objects for Coffee Pot
       Devices using SMIv2", Columbia, Inc., March 1998.
```

## 7.  Security Considerations（セキュリティに関する考慮事項）

> Security issues are not discussed in this memo.

セキュリティの問題については、このメモでは触れない。

## 8.  Author's Address

```
   Michael Slavitch
   Loran Technologies
   955 Green Valley Crescent
   Ottawa, Ontario Canada K2C 3V4

   Phone: 613 723 7505
   EMail: slavitch@loran.com
```

## 9.  Full Copyright Statement

```
   Copyright (C) The Internet Society (1998).  All Rights Reserved.

   This document and translations of it may be copied and furnished to
   others, and derivative works that comment on or otherwise explain it
   or assist in its implementation may be prepared, copied, published
   and distributed, in whole or in part, without restriction of any
   kind, provided that the above copyright notice and this paragraph are
   included on all such copies and derivative works.  However, this
   document itself may not be modified in any way, such as by removing
   the copyright notice or references to the Internet Society or other
   Internet organizations, except as needed for the purpose of
   developing Internet standards in which case the procedures for
   copyrights defined in the Internet Standards process must be
   followed, or as required to translate it into languages other than
   English.

   The limited permissions granted above are perpetual and will not be
   revoked by the Internet Society or its successors or assigns.

   This document and the information contained herein is provided on an
   "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING
   TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING
   BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION
   HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF
   MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
```