Documentation
Plesk
Plesk is the second control panel integration. It creates and manages subscriptions on a server that is already running. There is no operating system to install and no machine to boot. A subscription is created, given a service plan, and later suspended, moved to another plan or removed.
What you need
Do not use the administrator password. Plesk has API keys, and a key is the right shape for this: it is bound to the account that made it, it can be limited to a set of addresses, and you can withdraw it without changing anyone's password.
- Host: the panel's address. Port 8443 is filled in for you if you leave it out, and the address has to be https.
- API key: created under Tools & Settings, with an administrator account.
- TLS fingerprint: optional, and needed whenever the panel still has its self-signed certificate.
openssl s_client -connect <host>:8443 </dev/null 2>/dev/null | \
openssl x509 -noout -fingerprint -sha256One key, two APIs
Plesk has a REST API and an older XML/RPC API, and neither is complete on its own: REST has no subscriptions and no service plans, XML has everything but returns XML. Provibr uses both: creating and removing over REST, reading, suspending and switching plans over XML. The same key opens them, so you fill in one value.
Encrypted, always
Unlike DirectAdmin there is no plain-text option here: Plesk redirects http on both 8880 and 8443 to https, so Provibr refuses an http address instead of pretending it could work.
What a fresh install does have is a self-signed certificate. Fill in its fingerprint and the agent trusts that one certificate instead of switching verification off; replace the certificate later and the fingerprint has to follow.
Service plans
A Plesk service plan is the panel's own description of a subscription: disk quota, monthly traffic, how many domains and mailboxes, which services are on. It is not a Provibr plan and not an operating system. It is a name we refer to, and its contents can change on your server without us noticing.
The integration page can read the list of service plans from the panel, so you can see what you are choosing rather than typing a name from memory.
A web plan pins one service plan on one integration and gives it a name of your own. Ordering with a plan beats picking a loose service plan, and the loose picker stays available for the cases a plan does not cover.
What a subscription looks like in Provibr
A subscription is an ordinary server row of the type webserver. Its identifier is the subscription name, which in Plesk is the main domain, and its service plan, quota and traffic come along on every poll.
- Creating a subscription needs a main domain, an email address, a service plan and a password. There is no separate account name to think up.
- The domain is the identity: it is what the panel shows, what its API filters on, and what Provibr stores. It cannot be changed afterwards.
- The password is not recorded anywhere. Only the fact that you supplied one is; the value travels separately and becomes both the customer and the FTP password.
- Afterwards you can suspend, resume, change the service plan and delete. There is no console, because a hosting account does not have one.
Adopting subscriptions that already exist
The import tab lists the subscriptions on the panel and lets you take the ones you want into Provibr. Subscriptions already known are shown but cannot be selected again, so you can see the whole picture rather than a filtered one.
Usage
Quota and traffic ride along with the regular poll, so a subscription gets a usage graph without anything extra being switched on. Monthly traffic is a property of the subscription rather than a rate, so it is shown as a number on the account and not as a line on the graph.