Bug 53156

Summary:	Документация docs-alt-server-v, ⁠31.2. Хранилища по умолчанию: дополнения по работе с командами
Product:	Sisyphus	Reporter:	Tatyana Gagina <tatyana>
Component:	docs-alt-server-v	Assignee:	lepata <lepata>
Status:	CLOSED NOTABUG	QA Contact:	qa-sisyphus
Severity:	normal
Priority:	P5	CC:	azol, boyarsh, cas, lepata, lepata
Version:	unstable
Hardware:	x86_64
OS:	Linux

Description Tatyana Gagina 2025-02-19 17:54:05 MSK

Версия: docs-alt-server-v-10.4-alt4

Стенд c Opennebula: ALT Server V x86-64
Версия: opennebula-sunstone-6.2.0.1-alt4.1

Шаги:
Перейти в документации к п. ⁠31.2. Хранилища по умолчанию и выполнить:
1. $ man onedatastore ошибка
Результат: 'Error: cannot load such file -- rexml/document'
(при запуске от любого пользователя), не связано с самой документацией, выясняются причины. Может быть, потребуется примечание, чтобы не сталкиваться с данной проблемой пользователю.
# gem install rexml не помогает.

2. Выполнить согласно документации $ onedatastore show system
ONE_AUTH file not present (утилита onedatastore не может найти файл аутентификации)

Также ошибки при выполнении любой команды с onedatastore подобная проблема.

Причина: команды необходимо выполнять от имени пользователя opennebula (в данном случае используется oneadmin).
Думаю, что одного упоминания будет достаточно, чтобы пользователю было понятно, что все последующие команды выполняются от имени пользователя Opennebula.

3. Однако, данные команды выполнились только от root'а:
# onedatastore create imageds.conf и # onedatastore create systemds.conf
При выполнении от пользователя (любого, выясняются причины)
command create: argument 0 must be one of file

4. Перейти к примечанию: "Чтобы проверить доступное пространство на конкретном узле, можно воспользоваться командой onehost show" -> выполнить от пользователя opennebula команду $ onehost show:
Command show requires one parameter to run (то есть, требуется указать один параметр для запуска, иначе не будет работать).
Иными словами, в примечание добавить, "...можно воспользоваться командой onehost show с необходимым параметром".

Comment 1 Elena Mishina 2025-02-24 23:06:06 MSK

(Ответ для Tatyana Gagina на комментарий #0)
> 
> Шаги:
> Перейти в документации к п. ⁠31.2. Хранилища по умолчанию и выполнить:
> 1. $ man onedatastore ошибка 
> Результат: 'Error: cannot load such file -- rexml/document' 
> (при запуске от любого пользователя), не связано с самой документацией,
> выясняются причины. Может быть, потребуется примечание, чтобы не
> сталкиваться с данной проблемой пользователю.
> # gem install rexml не помогает.

И не поможет, так как во всех man-файлах opennebula имеем только такие строки (в примере /usr/share/man/man1/oneuser.1.xz):

.\" generated with Ronn/v0.7.3
.\" http://github.com/rtomayko/ronn/tree/0.7.3
.
.TH "ONEUSER" "1" "September 2023" "" "oneuser(1) -- manages OpenNebula users"
.
.SH "NAME"
\fBoneuser\fR \- manages OpenNebula users
.
.P
Error: cannot load such file \-\- rexml/document 
 
Это не ошибка документации (см. https://bugzilla.altlinux.org/53216)
> 
> 2. Выполнить согласно документации $ onedatastore show system
> ONE_AUTH file not present (утилита onedatastore не может найти файл
> аутентификации)

У меня все выполняется:
$ onedatastore show system
WARNING: Nokogiri was built against libxslt version 1.1.34, but has dynamically loaded 1.1.37
DATASTORE 0 INFORMATION                                                         
ID             : 0                   
NAME           : system              
USER           : oneadmin            
GROUP          : oneadmin            
CLUSTERS       : 0        

> Также ошибки при выполнении любой команды с onedatastore подобная проблема.
> 
> Причина: команды необходимо выполнять от имени пользователя opennebula (в
> данном случае используется oneadmin).
> Думаю, что одного упоминания будет достаточно, чтобы пользователю было
> понятно, что все последующие команды выполняются от имени пользователя
> Opennebula.

Одно упоминание об этом уже есть в документации:
"При установке OpenNebula система автоматически создает нового пользователя oneadmin, все дальнейшие действия по управлению OpenNebula необходимо выполнять от этого пользователя."

> 3. Однако, данные команды выполнились только от root'а: 
> #  onedatastore create imageds.conf и # onedatastore create systemds.conf
> При выполнении от пользователя (любого, выясняются причины)
> command create: argument 0 must be one of file

Данные команды прекрасно выполняются от пользователя oneadmin:
-bash-4.4$ onedatastore create systemds.conf
WARNING: Nokogiri was built against libxslt version 1.1.34, but has dynamically loaded 1.1.37
ID: 100

> 4. Перейти к примечанию:  "Чтобы проверить доступное пространство на
> конкретном узле, можно воспользоваться командой onehost show" -> выполнить
> от пользователя opennebula команду $ onehost show:

В документации не сказано, что нужно выполнить именно
$ onehost show

Но допишу про узел (а не параметр)
> Command show requires one parameter to run (то есть, требуется указать один
> параметр для запуска, иначе не будет работать).
> Иными словами, в примечание добавить, "...можно воспользоваться командой
> onehost show с необходимым параметром".