Another (but minor) documentation bug

TG4FOSS

Member
May 25, 2022
13
0
6
In the "Backup Repository Locations" section of the "Backup Client Usage" chapter, there is a table showing examples.

Is this line correct?
ExampleUserHost : PortDatastore
user@pbs!token@host:storeuser@pbs!tokenmyhostname:8007mydatastore

The user portion looks ok, but the shouldn't the Host : Port be "host:8007", and the Datastore be "store"?
 
According to other parts of the documentation the example looks fine:
The client uses the following format to specify a datastore repository on the backup server (where username is specified in the form of user@realm):

[[username@]server[:port]:]datastore
"user@pbs!token" is a valid username.
And "host:store" would also be correct as the port part is optional. I guess PBS will interpret "host:store" as "host:8007:store in case the second part is not an integer and will then assume you want to use the default port.

So a "host:store" or"user@pbs@host:store" or "user@pbs!token@host:store" or "user@pbs!token@host:8007:store" should be fine.
 
Last edited:
According to other parts of the documentation the example looks fine:

"user@pbs!token" is a valid username.
And "host:store" would also be correct as the port part is optional. I guess PBS will interpret "host:store" as "host:8007:store in case the second part is not an integer and will then assume you want to use the default port.

So a "host:store" or"user@pbs@host:store" or "user@pbs!token@host:store" or "user@pbs!token@host:8007:store" should be fine.
Yes, the syntax looks fine. It's just that a parse of the value in the "Example" column doesn't yield the values in the other columns.
 
Jup, you are right. A "user@pbs!token@myhostname:8007:mydatastore" as an example would be less confusing.
 
OK, good. Hopefully someone can file a bug on it (I'm presently a non-subscription user).

... And while I've got you here, any chance you could help with the other documentation problem I'm having? It's at https://forum.proxmox.com/threads/documentation-errors-non-subscription-repos-for-pbs-client.112245/. The second post in the thread is the TL;DR.
You don't need a subscription to file a bug or features request. Just create a account on the bug tracker and file it there: bugzilla.proxmox.com
 

About

The Proxmox community has been around for many years and offers help and support for Proxmox VE, Proxmox Backup Server, and Proxmox Mail Gateway.
We think our community is one of the best thanks to people like you!

Get your subscription!

The Proxmox team works very hard to make sure you are running the best software and getting stable updates and security enhancements, as well as quick enterprise support. Tens of thousands of happy customers have a Proxmox subscription. Get yours easily in our online shop.

Buy now!