CUCMの完全な共通パーティションのトラブルシューティング

Updated: 2023 年 10 月 5 日
Document ID:221038

偏向のない言語

この製品のドキュメントセットは、偏向のない言語を使用するように配慮されています。このドキュメントセットでの偏向のない言語とは、年齢、障害、性別、人種的アイデンティティ、民族的アイデンティティ、性的指向、社会経済的地位、およびインターセクショナリティに基づく差別を意味しない言語として定義されています。製品ソフトウェアのユーザインターフェイスにハードコードされている言語、RFP のドキュメントに基づいて使用されている言語、または参照されているサードパーティ製品で使用されている言語によりドキュメントに例外が存在する場合があります。シスコのインクルーシブ ランゲージの取り組みの詳細は、こちらをご覧ください。

翻訳について

シスコは世界中のユーザにそれぞれの言語でサポート コンテンツを提供するために、機械と人による翻訳を組み合わせて、本ドキュメントを翻訳しています。ただし、最高度の機械翻訳であっても、専門家による翻訳のような正確性は確保されません。シスコは、これら翻訳の正確性について法的責任を負いません。原典である英語版（リンクからアクセス可能）もあわせて参照することを推奨します。

    概要

    このドキュメントでは、Unified Communications Manager(CUCM)サーバの完全な共通パーティションをトラブルシューティングする方法と、ストレージをクリーンアップする方法について説明します。

    前提条件

    要件

    次の項目に関する知識があることが推奨されます。

    • リアルタイム監視ツール(RTMT)
    • CUCM GUIインターフェイスおよびCLIセッション

    使用するコンポーネント

    このドキュメントの情報は、次のソフトウェアとハードウェアのバージョンに基づいています。

    • CUCM バージョン 12.5.1.16900-48

    このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されました。このドキュメントで使用するすべてのデバイスは、クリアな（デフォルト）設定で作業を開始しています。本稼働中のネットワークでは、各コマンドによって起こる可能性がある影響を十分確認してください。

    背景説明

    CUCMには3つのメインディスクパーティションがあります。

    • Disk/active：現在のCUCMバージョンとその設定が含まれます。
    • Disk/inactive：アップグレード後に何らかの理由で切り替えが必要になった場合に備えて、以前のバージョンが含まれています。
    • ディスク/ロギング：これは共通パーティションとも呼ばれ、有効なすべてのログ/トレースファイルを保持し、アップグレード中にアップグレードISOファイルを一時的に保存するためにも使用されます。

    次の2つのシナリオでは、一般的なパーティションのクリーンアップが必要です。

    • ログのローテーションが中断され、ログが削除されないため、ログ(/common)パーティションがバインドされずに拡張されます。ロギングできないことが異なるコマンドの実行に影響を与えるため、パフォーマンスの問題が発生する可能性があります。
    • CUCMのアップグレードでは、共通パーティションの下により多くのスペースが必要です。アップグレード前の準備状況COPファイルでは、アップグレードを実行する前にクラスタのさまざまな側面を検証します。CUCMアップグレードでは共通パーティションに少なくとも25 GBの空き容量が必要になるため、モジュールの1つがディスク容量チェックです。

    共通パーティション領域の検証

    ディスク領域を検証するには、show statusコマンドを使用します。コマンドの最後にディスクの使用状況が表示されます。

    admin:show status

    Host Name          : xxxxxxxx-cucm1
    Date               : Fri Sep 29, 2023 17:20:40
    Time Zone          : Central Daylight Time (America/Mexico_City)
    Locale             : en_US.UTF-8
    Product Ver        : 12.5.1.16900-48
    Unified OS Version : 7.0.0.0-4

    Uptime:
     17:20:42 up 141 days,  1:12,  1 user,  load average: 2.22, 0.98, 0.82

    CPU Idle:   85.86%  System:   07.58%    User:   05.56%
      IOWAIT:   00.51%     IRQ:   00.00%    Soft:   00.51%

    Memory Total:        7990056K
            Free:         130848K
            Used:        3963172K
          Cached:        3232656K
          Shared:         484376K
         Buffers:        3896036K

                            Total            Free            Used
    Disk/active         19805412K        6240536K       13345948K (69%)    
    Disk/inactive       19805412K        6601928K       12984556K (67%)    
    Disk/logging        69234984K        5315340K       60379628K (92%)    <--- Used common partition space

    ストレージを検証するもう1つのコマンドはshow tech runtime diskです。このコマンドを使用して、パーティションごとにファイルシステムを検証できます。Disk/activeパーティションは/にマウントされ、Disk/inactiveパーティションは/partBにマウントされ、Disk/loggingパーティションは/commonにマウントされます。

    admin:show tech runtime disk
     -------------------- show platform runtime --------------------

    The disk usage:
    Filesystem      Size  Used Avail Use% Mounted on
    devtmpfs        3.8G     0  3.8G   0% /dev
    tmpfs           3.9G   85M  3.8G   3% /dev/shm
    tmpfs           3.9G  402M  3.5G  11% /run
    tmpfs           3.9G     0  3.9G   0% /sys/fs/cgroup
    /dev/sda2        19G   13G  6.0G  69% /                 <--- Active partition
    /dev/sda1        19G   13G  6.3G  67% /partB            <--- Inactive partition
    /dev/sda3       240M  9.5M  214M   5% /grub
    /dev/sda6        67G   58G  5.1G  92% /common           <--- Logging partition
    none            128M     0  128M   0% /var/log/ramfs/cm/trace/ccm/sdi
    none            128M  1.6M  127M   2% /var/log/ramfs/cm/trace/ccm/sdl
    none            128M   32K  128M   1% /var/log/ramfs/cm/trace/ccm/calllogs
    none            128M     0  128M   0% /var/log/ramfs/cm/trace/ccm/dntrace
    none            128M  1.4M  127M   2% /var/log/ramfs/cm/trace/lbm/sdl
    none            128M     0  128M   0% /var/log/ramfs/cm/trace/cti/sdi
    none            128M  556K  128M   1% /var/log/ramfs/cm/trace/cti/sdl
    tmpfs           781M     0  781M   0% /run/user/504
    tmpfs           781M     0  781M   0% /run/user/1000
    tmpfs           781M     0  781M   0% /run/user/0

    一般的なパーティションのクリーンアップ方法

    caution-icon

    注意：削除されたファイルは、クラスタ全体のDRS復元を実行しないと復元できません。削除されたファイルの影響を理解してください。ファイルを削除する前にバックアップを取ることを推奨します。

    仮想化ストレージ要件の検証

    CUCMの実装は、バージョンに応じたディスク仮想化要件に準拠している必要があります。Virtualization for CUCM Guideを参照してください。show hardwareコマンドを使用して、仮想マシンのストレージを確認します。

    admin:show hardware

    HW Platform       : VMware Virtual Machine
    Processors        : 2
    Type              : Intel(R) Xeon(R) CPU E5-2699A v4 @ 2.40GHz
    CPU Speed         : 2400
    Memory            : 8192 MBytes
    Object ID         : 1.3.6.1.4.1.9.1.1348
    OS Version        : UCOS 7.0.0.0-4.i386
    Serial Number     : VMware-42 16 9b c5 f6 08 da f9-36 d7 72 7c 01 41 52 62

    RAID Version      :
    No RAID controller information is available

    BIOS Information  :
    PhoenixTechnologiesLTD 6.00 11/12/2020

    RAID Details      :
    No RAID information is available
    -----------------------------------------------------------------------
    Physical device information
    -----------------------------------------------------------------------
    Number of Disks   : 1              <--- # of vdisks
    Hard Disk #1
    Size (in GB)      : 110            <--- disk size

    Partition Details :

    Disk /dev/sda: 14359 cylinders, 255 heads, 63 sectors/track
    Units: sectors of 512 bytes, counting from 0

       Device Boot    Start       End   #sectors  Id  System
    /dev/sda1   *      2048  40511487   40509440  83  Linux
    /dev/sda2      40511488  81020927   40509440  83  Linux
    /dev/sda3      81020928  81545215     524288  83  Linux
    /dev/sda4      81545216 230686719  149141504   5  Extended
    /dev/sda5      81547264  89739263    8192000  82  Linux swap / Solaris
    /dev/sda6      89741312 230686719  140945408  83  Linux
    note-icon

    注:vDiskの追加は、アプリケーションによる再パーティショニングが必要になるため、サポートされていません。ストレージ構成が要件に合っていない場合は、正しいOVAテンプレートを使用してVMを再構築する必要があります。

    ログパーティション監視ツール

    ログパーティション監視ツール(LPM)は、設定されたしきい値を使用して、5分ごとにサーバ上のログパーティションのディスク使用量を監視します。このしきい値を変更するためにRTMTで設定できるアラートは2つあります。

    • LogPartitionLowWaterMarkExceeded（ディスク領域の割合）：ディスク使用率が指定した割合を超えると、LPMからsyslogにアラームメッセージが送信され、RTMT Alert Centralにアラートが送信されます。ログファイルを保存してディスク容量を回復するには、RTMTでtrace and log centralオプションを使用します。
    • LogPartitionHighWaterMarkExceeded(% disk space)：ディスク使用率が指定したパーセンテージを超えると、LPMからsyslogにアラームメッセージが送信され、RTMT Alert centralにアラートが送信されます。このしきい値に達すると、古いログファイルがパージされ、ロギングパーティションに追加のディスク領域が作成されます。

    ファイルを消去するには、『Call Manager手順ガイド』の「RTMTでのWaterMarkの調整」を参照してください。

    空き領域COPファイルの実行

    High/Low WaterMark値の調整後に共通のパーティション領域が十分でない場合は、最新のCisco Free Common Space COPファイルのインストールに進みます。

    warning-icon

    警告：通常の営業時間内にインストールすると、システムのパフォーマンスに一時的に影響を与えるため、メンテナンス期間中にパッチをインストールする必要があります。パッチはすべてのCLIおよびGUIセッションを終了し、Tomcatサービスを再起動するため、システム上に他のCLIまたはGUIアクティビティがない場合は、必ずパッチをインストールしてください。

    1. ソフトウェアのダウンロードから最新のCisco Free Common Space COPファイルをダウンロードします。ReadMeファイルを確認して、このCOPファイルの実行による影響を理解してください。
    2. COPファイルをインストールするには、Cisco Unified OS Administration > Software Upgrades > Install/Upgradeの順に移動し、ソフトウェアの場所の設定を確認して、Nextをクリックします。

    Install/Upgrade Software Location ScreenInstall/Upgrade Software Location画面

    1. Free Common Space COP Fileを選択し、Nextをクリックします。

    Software File Selection ScreenSoftware File Selection画面

    1. COPファイルは実行を開始し、共通のパーティション領域を解放します。

    COP File Installation in Progress ScreenCOPファイルのインストール進行中の画面

    CLIによるログの削除

    ロギングパーティションがいっぱいになると(100 %)、COPのインストールが失敗します。このシナリオでは、CLIからログを手動で削除できます。show diskusage common sortコマンドを実行して、大量の領域を消費している巨大なファイルを特定します。

    admin:show diskusage common sort

    This command can take significantly long time,
    and can also effect the system wide IOWAIT on your system.
    Continue (y/n)?y
    Filesystem     1K-blocks     Used Available Use% Mounted on
    /dev/sda6       69234984 60388736   5306232  92% /common
    60305892        /common/
    60239612        /common/log
    37020784        /common/log/taos-log-b
    23209092        /common/log/taos-log-a
    13585228        /common/log/taos-log-b/cm
    9506060 /common/log/taos-log-b/car_db
    9506016 /common/log/taos-log-a/car_db
    9379480 /common/log/taos-log-b/cm/trace
    8764376 /common/log/taos-log-a/cm
    6222036 /common/log/taos-log-b/car_db/cardbspace
    6222004 /common/log/taos-log-a/car_db/cardbspace
    5998244 /common/log/taos-log-b/tomcat
    5281404 /common/log/taos-log-a/cm/trace
    4458320 /common/log/taos-log-b/tomcat/logs
    4159960 /common/log/taos-log-b/core
    4159952 /common/log/taos-log-b/core/core.jvm.core
    2923152 /common/log/taos-log-b/cm/trace/dbl
    2921840 /common/log/taos-log-b/cm/trace/dbl/sdi
    2002008 /common/log/taos-log-b/car_db/cartempdbs
    2002004 /common/log/taos-log-a/car_db/cartempdbs
    1935008 /common/log/taos-log-b/cm/bin
    1932000 /common/log/taos-log-a/cm/bin
    1928508 /common/log/taos-log-a/cm/trace/ccm
    1928424 /common/log/taos-log-a/cm/trace/ccm/sdl
    1806628 /common/log/taos-log-b/cm/tftpdata

    cm/トレースログの削除

    cm/trace pathからログファイルを削除し、一度に1つずつ実行するsaveコマンドを次に示します。

    • file delete activelog cm/trace/ccm/sdl/* noconfirm
    • file delete activelog cm/trace/cti/sdl/* noconfirm
    • file delete activelog cm/trace/*/*/*/* noconfirm
    • file delete activelog cm/trace/*/*/* noconfirm
    • file delete activelog cm/trace/*/* noconfirm
    • file delete activelog cm/trace/* noconfirm
    • file delete inactivelog cm/trace/*/*/*/* noconfirm
    • file delete inactivelog cm/trace/*/*/* noconfirm
    • file delete inactivelog cm/trace/*/* noconfirm
    • file delete inactivelog cm/trace/* noconfirm
    • file delete activelog cm/log/ris/csv/*
    • file delete activelog tomcat/logs/ccmservice/log4j/*
    • file delete activelog /platform/snmp/*/*

    コアダンプの削除

    コアダンプは通常、ディスク内の多くのスペースを使用し、utils core active listコマンドとutils core inactive listコマンドを使用して識別します。

    admin:utils core active list
          Size         Date            Core File Name
    =================================================================
                 2023-03-02 22:03:11   core.jvm.core
    admin:
    admin:utils core inactive list
          Size         Date            Core File Name
    =================================================================
     292616 KB   2022-02-20 00:02:37   core.62556.6.ccm.1645336926

    パーティションに応じて、file delete activelog core/filenameまたはfile delete inactivelog core/filenameを使用してコアダンプを削除し、これ以上コアがリストされていないことを確認します。

    admin:file delete activelog core/core.jvm.core
    Delete the File core/core.jvm.core?
    Enter "y" followed by return to continue: y
    files: found = 1, deleted = 1
    admin:
    admin:file delete inactivelog core/core.62556.6.ccm.1645336926
    Delete the File core/core.62556.6.ccm.1645336926?
    Enter "y" followed by return to continue: y
    files: found = 1, deleted = 1
    admin:
    admin:utils core active list
    No core files found
    admin:utils core inactive list
    No core files found

    コール詳細レコード(CDR)のロー/ハイウォーターマーク値の変更

    CDR Repository ManagerのFile Managerコンポーネントは毎時間実行されます。ファイルマネージャを実行すると、設定された保存期間外の日付のファイルが削除されます。また、ディスク使用率が最高水準点を超えていないかどうかも確認します。その場合、最も古いファイルから順に、最低水準点に達するまで処理されたCDRファイルが削除されます。

    1. Cisco Unified Serviceability > Tools > CDR Managementの順に選択し、General Parametersセクションの最初の値をクリックします。

    CDR Management ScreenCDR Management画面

    1. High Water Mark (%)とLow Water Mark (%)を変更します。

    CDR Management Modify General Parameters ScreenCDR Management Modify General Parameters画面

    CDR Analysis and Reporting(CAR)データベースの消去

    CARデータベースが多くのスペースを使用している場合は、データベースの消去とロギングスペースの解放を実行できます。これを行うには、

    1. CAR Webページにアクセスして、Cisco Unified Serviceability > Tools > CDR Analysis and Reportingの順に移動します。
    2. ローダをディセーブルにし、System > Scheduler > CDR Loadの順に選択し、Disable Loaderチェックボックスにチェックマークを入れて、Updateをクリックします。

    Disable Loader ScreenLoader画面を無効にする

    1. 変更を有効にするには、Cisco Unified Serviceability > Tools > Control Center - Network Services > Cisco CAR Scheduler の順に選択し、サービスを再起動します。
    2. CAR DBを消去するには、System > Database > Manual Purgeの順に選択し、Table Informationをクリックして、テーブルのタイプごとに最も古いレコードを検証します。

    CAR Table Information ScreenCARテーブル情報画面

    1. Closeをクリックし、選択したテーブルのファイルを消去する日付範囲を選択します。

    Manual Database Purge Screenデータベースの手動消去画面

    未使用の電話ファームウェアファイルの削除

    アップグレードシナリオでは、共通パーティションに十分なスペースがない場合は、TFTPから古い/未使用のファームウェアを削除します。これを行うには、

    1. Cisco Unified OS Administration > Software Upgrades > Device Load Managementの順に移動します。
    2. フィルタ「Find Device Loads where > Status > is exactly > Not In Use > Find」を適用します。
    3. ステータスがNot In Useのすべてのデバイスロードを削除します。

    Device Load Management ScreenDevice Load Management画面

    （「トラブルシューティング」）

    さらにサポートが必要な場合は、Cisco TACでサービスリクエストをオープンし、次のコマンドを収集してください。

    • show version active
    • show network cluster
    • show status
    • show tech runtime disk
    • show hardware
    • show diskusage common sort

    関連情報

    更新履歴

    改定 発行日 コメント
    1.0
    05-Oct-2023
    初版
    TAC Authored

    シスコ エンジニア提供

    • Belen Sanchez Torralva
      シスコテクニカルコンサルティングエンジニア

    このドキュメントは役に立ちましたか?

    Feedbackフィードバック

    シスコに問い合わせ

    このドキュメントは次の製品に対応しています