2026/01/07追記: ONTAP 9.13.1以降のシミュレータでも同様の問題が発生している
シミュレータ環境の場合のチェック点
ONTAPアップデートを行う環境が下記であること
・vol0 の空き容量が 7GB以上(6GBでもいいかもしれないけど)であること
・/mroot/etc/upload 領域の設定(system services web file-uploads config show)が 7GB であること
上記が満たせていない場合、特にシミュレータを新規で作成した場合は、以下の手順で作業を行う
(1) 現在の /mroot/etc/upload 領域の設定(system services web file-uploads config show) を確認
→ たぶん5MB設定なので、7GBを設定するには、vol0 に 7GB+7GBの計14GBの空き領域が必要
(2) vol0に約14GBの空き領域がない場合、vol0を20GBぐらいにする
(3) /mroot/etc/upload 領域を7GBに設定する
(4) vol0の空き容量を確認し、7GB以上あること、ない場合はvol0の割り当て容量を増やす
最後のvol0の空き容量が足りない場合、ONTAPアップデート中にシステムが起動不能状態に陥りることがよくあります。足らないから途中で中断ではなく、完全に使えなくなります。
注意してください
ONTAP 9.5P5シミュレータ環境をONTAP 9.7にアップデートした場合には問題なかったのに、運用中のONTAP 9.5P10環境をアップデートしようとしたところ、firmwareアップロードの段階で「THe request body must have content type multipart/form-data with a field named file」というエラーとなった。
確認すると、ONTAP 9.5P10, ONTAP9.6～ONTAP 9.6P6で発生するというえらくピンポイントな仕様問題だった。(System Manager ONTAP 9.7 image upload fails with multipart/form-data error)
ファイルをアップロードする領域が2GBと設定されているが、ONTAP 9.7では2GBでは足らなくなったためエラーになる、という問題だった。
webのアップロード用パラメータを2GBから4GBに変更することで対処できるとのことで実施した。
まず、diagモードに切り替えて現在の設定確認
netappcluster::> set diag
Warning: These diagnostic commands are for use by NetApp personnel only.
Do you want to continue? {y|n}: y
netappcluster::*> system services web file-uploads config show
Node Size
----------------- ------------
netappcluster-01 2GB
netappcluster-02 2GB
2 entries were displayed.
netappcluster::*>
次に変更を実施
netappcluster::*> system services web file-uploads config modify -node * -size 4GB
Warning: Files already uploaded or are being uploaded will be lost. Starting a
file upload before the resize operation is finished will cause the
uploaded file to be unavailable.
Do you want to continue? {y|n}: y
[Job 14002] Job is queued: Web File Upload Resize Node Job.
[Job 14003] Job is queued: Web File Upload Resize Node Job.
2 entries were modified.
netappcluster::*>
すぐに反映されないので、上記で出力されたジョブIDのステータスを確認する。
netappcluster::*> job show -id 14002
Owning
Job ID Name Vserver Node State
------ -------------------- ---------- -------------- ----------
14002 Web File Upload Resize Node Job netappcluster netappcluster-01 Success
Description: Web File Upload Resize Node Job
netappcluster::*> job show -id 14003
Owning
Job ID Name Vserver Node State
------ -------------------- ---------- -------------- ----------
14003 Web File Upload Resize Node Job netappcluster netappcluster-02 Success
Description: Web File Upload Resize Node Job
netappcluster::*>
「Success」が含まれていれば変更が完了している。(変更途中は Running )
ただ、変更が終わったあとの設定表記は4GBとならずに「0B」となるが、これで正常とのこと
netappcluster::*> system services web file-uploads config show
Node Size
----------------- ------------
netappcluster-01 0B
netappcluster-02 0B
2 entries were displayed.
netappcluster::*>
KBには「system node systemshell -node * -command df -h /mroot/etc/upload」を実行して /mroot/etc/upload に割り当てられた容量を確認する、という記載がある。
ここで使っているsystemshellコマンドは最近のONTAP OSでは標準で使えない状態に変更されているため「Error: command failed: Error: Account currently locked. Contact the storage administrator to unlock it.」というエラーとなる場合がある。その場合は、ロックを解除する必要がある。手順については「NetApp ONTAPから他サーバに気軽にsshできる穴がふさがれてしまった」を参考のこと
で、ONTAP 9.13.1ぐらいになってくると状況によっては4GBより必要な可能性もあるようで、最近になって「System Manager fails to upload ONTAP image due to insufficient space」というKBが追加されていた。こちらは7GBに変更するとあるが、2023年11月時点ではこの問題が発生する状況が未公開となっているため、4GBのままで良さそうである。
2025/12/23追記
ONTAP 9.17.1 シミュレータ環境をアップデートしようとしたら、ファイルアップロードで下記のエラーが出力された。
Internal Error: There is not sufficient space in the file upload directory to upload this file. Contact technical support for assistance.
同様にコマンドを実行してみる
netapp::> set diag
Warning: These diagnostic commands are for use by NetApp personnel only.
Do you want to continue? {y|n}: y
netapp::*> system services web file-uploads config show
Node Size
----------------- ------------
netapp-01 5MB
netapp::*> system services web file-uploads show
This table is currently empty.
netapp::*>
で・・・「スペース不足のため、System ManagerはONTAPイメージのアップロードに失敗する」を参照すると、容量確認をしている・・・
netapp::*> system node systemshell -node netapp-01 -command df -h /mroot/etc/upload
Error: command failed: Error: Account currently locked. Contact the storage administrator to unlock it.
netapp::*>
ロックされてるので、unlockして再実行
netapp::*> security login unlock -username diag
netapp::*> system node systemshell -node netapp-01 -command df -h /mroot/etc/upload
Filesystem Size Used Avail Capacity Mounted on
/dev/md3 5.4M 12K 5.0M 0% /mroot/etc/www/upload
netapp::*>
5MBでおけるわけがない。
ただ、手順みると、本来は/dev/md3に空き容量があることが期待されている模様・・・
とりあえず容量制限の値を増やす操作をしても失敗
netapp::*> system services web file-uploads config show
Node Size
----------------- ------------
netapp-01 5MB
netapp::*> system services web file-uploads config modify -node * -size 7GB
Warning: Files already uploaded or are being uploaded will be lost. Starting a file upload before the resize operation is finished will cause the uploaded file to be unavailable.
Do you want to continue? {y|n}: y
[Job 204] Job is queued: Web File Upload Resize Node Job.
1 entry was modified.
netapp::*> system services web file-uploads config show
Node Size
----------------- ------------
netapp-01 5MB
netapp::*> job show -id 204
Owning
Job ID Name Vserver Node State
------ -------------------- ---------- -------------- ----------
204 Web File Upload Resize Node Job
netapp netapp-01 Error
Description: Web File Upload Resize Node Job
netapp::*> system services web file-uploads config show
Node Size
----------------- ------------
netapp-01 5MB
netapp::*>
値は変更されいない
現状この話は未解決です
2025/12/26 に、もう1回試してみた
netapp::*> system node systemshell -node * -command df -h /mroot/etc/upload
Node: netapp-01
Filesystem Size Used Avail Capacity Mounted on
/dev/md3 5.4M 12K 5.0M 0% /mroot/etc/www/upload
1 entry was acted on.
netapp::*> system services web file-uploads config modify -node * -size 4GB
Warning: Files already uploaded or are being uploaded will be lost. Starting a
file upload before the resize operation is finished will cause the
uploaded file to be unavailable.
Do you want to continue? {y|n}: y
[Job 224] Job is queued: Web File Upload Resize Node Job.
1 entry was modified.
netapp::*> job show -id 224
Owning
Job ID Name Vserver Node State
------ -------------------- ---------- -------------- ----------
224 Web File Upload Resize Node Job
netapp netapp-01 Running
Description: Web File Upload Resize Node Job
netapp::*>
なんかRunningになっているし、uploadが見えなくなっている
netapp::*> system node systemshell -node * -command df -h /mroot/etc/upload
Node: netapp-01
df: /mroot/etc/upload: No such file or directory
1 entry was acted on.
netapp::*> job show -id 224
Owning
Job ID Name Vserver Node State
------ -------------------- ---------- -------------- ----------
224 Web File Upload Resize Node Job
netapp netapp-01 Running
Description: Web File Upload Resize Node Job
netapp::*>
しばらく待ってから・・・
netapp::*> job show -id 224
There are no entries matching your query.
netapp::*> system node systemshell -node * -command df -h /mroot/etc/upload
Node: netapp-01
Filesystem Size Used Avail Capacity Mounted on
/dev/md3 4.2G 12K 3.9G 0% /mroot/etc/www/upload
1 entry was acted on.
netapp::*> system services web file-uploads config show
Node Size
----------------- ------------
netapp-01 3.86GB
netapp::*>
拡張に成功しました
しかし・・・ONTAPアップデート用ファイルをアップロードしていたところ、目を離している間に再起動がかかり、そして、再起動ループに陥る状態になっていました・・・
なぜか「Orphaning disk v0.17, because of generation count mismatch (208/206)」といったディスク認識の問題が出ている
2026/01/07追記
ONTAP 9.14.1シミュレータでいろいろ実験
どうやら、複数箇所で容量の問題が発生する模様
アップデートの際に使用されるディレクトリが/mroot/etc/upload だけではなかった。
ONTAP上で普通に見える各ノードのシステムボリューム /vol/vol0 の容量
systemshellで見える /mroot の容量(vol0の容量がそのまま見える)
systemshellで見える /mroot/etc/upload の容量(ONTAP 9.14.1では実体が/mroot/etc/www/upload)
systemshellで見える /mroot/etc/software の容量(ONTAP 9.14.1では /mrootとおなじ領域)
ONTAP 9.6のトラブル対応では/mroot/etc/upload領域を4GBに拡張となっていたが、ONTAP 9.13.1のトラブル対応では7GBとなっているが、設定できる時と出来ない時があった。
どういう違いなのかと思ったら、シミュレータ作成時にvol0の容量をいくつと設定していて、そこに空き容量がどれくらいあるか、という問題だった。
/mroot/etc/upload 領域は vol0 領域の中にloopデバイスとして作られているようなので、vol0の空き容量が少ないと拡張できない、という状態だった。
なおかつ、/mroot/etc/upload はファイルの転送に使う領域で、そこからファイルを展開して /mroot/etc/software に転送することになるのだが、upload領域を拡張すると、softwareで使用できる容量が減る、という状況となっていた。
おそらく、upload領域を7GBと設定した場合は、vol0 領域は16GB程度に設定しなければならいと思われる(14GBだとsoftwareへの展開時にファイルシステムフルが発生した)
ONTAP 9.14.1環境で9.14.1P15をアップロードした時の容量の動き
upload領域は展開終了後は使用されていない。volume領域は/mrootとおなじ
で・・・このあと、ONTAP 9.17.1P3へのアップデートを実行したところ、死にました・・・
で、vol0を20GB、upload領域を7GB設定にしてから、9.14.1から9.17.1P3へのアップデートを試したところアップデートは順調に進み・・・
途中、微妙な感じのコンソール画面になりつつも・・・
無事アップデートが完了しました
