[2.x] TDB (iproto): recommendations for `space:upgrade()`

[xuniq]

Product: Tarantool DB
Since: 2.3?
Jira ticket: https://jira.vk.team/browse/TNTP-3228
Root documents: https://www.tarantool.io/en/tarantooldb/doc/latest/examples/space_upgrade/migrations_space_upgrade/

SME: @ a1div0

Details

Проблема:

space:upgrade() запущен не в асинхронном режиме и tt CLI должна была дожидаться окончания этой процедуры, которая оказалась дольше, чем таймаут.

Решения два:

или включить асинхронный режим работы space:upgrade() с помощью флажка is_async:
box.space[space_name]:upgrade({
func = convert_function_name,
format = new_format,
is_async = true,
})

или увеличить таймаут для tt CLI:
--execution-timeout=240

Нужно всё это как-то явственно подсветить в документации