Modulinformasjon
Introduksjon
Systemkrav
Forutsetninger
Begrensninger
omfang
Modulfunksjoner
Opprette en API-nøkkel
Installasjon
Første oppsett
Modulkonfigurasjon
Bestillingsprosess
FAQ
Merk : Les dette dokumentet i sin helhet før du installerer Vultr WHMCS-modulen
Introduksjon
Vultr-plattformen tilbyr en kraftig, funksjonsrik API som lar brukere kontrollere alle aspekter av kontoen sin. Vultr WHMCS-modulen gir hostingleverandører en helautomatisert løsning som lar dem tilby pålitelige skyservere på Vultr-plattformen til sine kunder.
Merk: Den nåværende versjonen av modulen er en fullstendig omskrivning av den originale modulen, men er kompatibel med eksisterende Vultr-baserte produkter i WHMCS.
Systemkrav
- WHMCS versjon 7.2.x eller nyere
- PHP versjon 7.1.x eller nyere
- MySQL 5.6 , MariaDB 5.6 , MariaDB 10.0 eller MariaDB 10.1 .
- ionCube Loader.
Forutsetninger
- Vultr API-nøkkel
- WHMCS-serverens IP-er blir hvitelistet for API-tilgang
Notater
- Du må godkjenne WHMCS-serverens IPv4- og IPv6-adresser for API-tilgang
- Hvis serveren din har flere IPv4-adresser, kan du godkjenne dem individuelt eller hviteliste hele undernettet.
- Hvis serveren din har en IPv6-adresse, er det best å hviteliste hele /64-undernettet
- WHMCS versjon 6 støttes ikke på grunn av slutten av levetiden.
- PHP versjon 7.0.x støttes ikke på grunn av slutten av levetiden.
- Det er ingen planer om å støtte eldre versjoner av WHMCS og PHP.
- Du må bruke de konfigurerbare alternativene generert av modulen for produktene. Å lage din egen vil sannsynligvis føre til en konflikt.
Begrensninger
Nedenfor er listen over alternativer som modulen ikke inkluderer etter design.
- Legg til flere IPv4-adresser.
- Aktiver privat nettverk etter at en virtuell maskin har blitt distribuert.
- Bytte mellom OS og apper.
- Bytte mellom Linux og Windows.
omfang
Dette dokumentet vil dekke prosessen med å installere og konfigurere den offisielle Vultr WHMCS-modulen. Moduler lastet ned fra tredjeparts nettsteder støttes ikke av Vultr.
Modulfunksjoner
- Ett-klikks opprettelse av VPS-produkter basert på Vultr
- Du må angi prisene manuelt for hvert produkt og konfigurerbart alternativ.
- Distribuer og oppgrader virtuelle maskiner
- Slå på/av/syklus funksjon
- HTML5 VNC-konsoll
- rDNS-kontroll
- Privat nettverk
- Oppstartsskript
- SSH-nøkler
- Stillbildekontroll
- Distribuer VM-er fra en liste over forhåndsdefinerte ISO-er
- Distribuer VM-er fra en liste over forhåndsdefinerte øyeblikksbilder
- Aktiver/deaktiver spesifikke ISO-er og øyeblikksbilder for VM-implementeringer
- Aktiver/deaktiver distribusjonsplasseringer
- Vultr DNS-støtte med Vanity DNS (Custom Nameserver)-støtte
Opprette en API-nøkkel
- Logg på Vultr Client Area.
- Klikk på Konto.
- Klikk API.
- Klikk på Aktiver API.
- Hvitelist IP-adressene til WHMCS-serveren din under Access Control.
Installasjon
Det første trinnet er å laste ned Vultr WHMCS-modulen her
Ny installasjon
- Pakk ut ZIP-arkivet.
- Last opp modulfilene til WHMCS-serveren din ved å følge kataloghierarkiet som er definert nedenfor
Oppgrader fra en eldre versjon av modulen
- Sikkerhetskopier databasen og filene
- Slett katalogene
modules/addons/vultrog fullstendig modules/servers/vultr.
- Pakk ut og last opp den nye modulen.
Kataloghierarki
Lastet ned arkiv
Første oppsett
- Last opp modulen som instruert ovenfor
- Logg på WHMCS Admin Panel og naviger til
Setup -> Addon Modules.
- Ved siden av
Vultr Module, klikker du på Configureknappen.
- Kryss av i avmerkingsboksen ved siden av
Hooks Enabled.
- Skriv inn API-nøkkelen din i
API Keyfeltet.
- Oppsett
Access Controlfor Administratorog andre roller du ønsker å aktivere det for.
- Klikk
Save Changes
- Logg på WHMCS Admin Panel og naviger til for
Addons -> Vultr Moduleå konfigurere modulalternativene i neste del av dette dokumentet
Modulkonfigurasjon
Denne delen av dokumentasjonen vil vise frem alle tilgjengelige konfigurasjonsalternativer for modulen, forklare hvordan de fungerer og forklare hvordan de konfigureres.
Produktskaper
Denne delen lar deg lage et Vultr-basert produkt i WHMCS. Det er to moduser, Single Product Creatorog Multiple Product Creator.
Den Single Product Creatormodusen vil tillate deg å lage et produkt basert på de tilgjengelige Vultr pakker, velg en produktgruppe, og priser for det produktet du vil legge til. Priser for konfigurerbare alternativer som Snapshots, Windows, cPanel Apps etc... må legges til manuelt i produktets konfigurerbare alternativer.
De Multi Product Creatorvil masseopprette Vultr-baserte VPS-pakker i WHMCS-en din, men du må manuelt konfigurere prisene for hver pakke samt prissettingen for de konfigurerbare alternativene, som ligner på Single Product Creatormodusen.
Produkter
Denne delen vil vise en komplett liste over alle dine Vultr-baserte produkter i WHMCS og lar deg raskt navigere til Edit, eller Configurable Options siden for hver enkelt. Du kan også slette et produkt fra den siden. Denne delen er ganske nyttig når du raskt vil finne et Vultr-produkt i ditt WHMCS-administrasjonsområde for å endre det, eller endre de konfigurerbare alternativene for det.
DNS
Vultr WHMCS-modulen støtter Vanity Nameservers (tilpasset ns1 og ns2.domain.com). Å sette opp Vanity Nameservers krever et første trinn, som er å opprette de egendefinerte navneserverne med domeneregistratoren din og peke dem til IP-ene ns1.vultr.comog ns2.vultr.comløser til. Når du er ferdig, følg trinnene nedenfor:
- Logg på WHMCS Admin Panel.
- Fortsett
Addons -> Vultr Module.
- Klikk på
DNS.
- Legg til verdiene for
Nameserver 1og Nameserver 2og klikk Save Changes.
- Du er ferdig.
Vær oppmerksom på at Vanity-navneservere brukes på nylig lagt til DNS-soner/domener. Eksisterende må endres i https://my.vultr.com manuelt.
Serverplassering
Du har muligheten til å aktivere og deaktivere visse skylokasjoner, og dermed tillate kundene dine å distribuere virtuelle maskiner kun på de stedene du velger. Vær oppmerksom på at det ikke er mulig å velge Cloud Location under bestillingsprosessen siden lokasjoner lastes dynamisk avhengig av hvor den valgte pakken er tilgjengelig på tidspunktet for distribusjon.
Følg trinnene nedenfor for å velge hvilke lokasjoner som skal aktiveres for kundene dine:
- Logg på WHMCS Admin Panel.
- Fortsett
Addons -> Vultr Module.
- Klikk på
Server Location.
- Klikk på
Enabledknappen for å deaktivere plasseringene du ønsker å deaktivere (ved å klikke på knappen når det står Disabled, aktiveres plasseringen på nytt).
- Du er ferdig.
Øyeblikksbilder
Vultr WHMCS-modulen lar deg lage ett eller flere av øyeblikksbildene på kontoen din Public– noe som betyr at du lar kundene dine distribuere nye virtuelle maskiner fra disse øyeblikksbildene hvis de velger å gjøre det. Alle øyeblikksbildene på kontoen din er satt til Disabled som standard i modulen, og du må aktivere dem.
For å velge hvilke øyeblikksbilder som skal offentliggjøres for kundene dine, følg trinnene nedenfor:
- Logg på WHMCS Admin Panel.
- Fortsett
Addons -> Vultr Module.
- Klikk på
Snapshots.
- Klikk på
Disabledknappen for å aktivere øyeblikksbildene du ønsker å gjøre offentlige (ved å klikke på knappen når det står Enabled, aktiveres øyeblikksbildet på nytt).
- Du er ferdig.
ISO
I likhet med Snapshot-funksjonen kan du lage en eller flere av de tilpassede opplastede ISO-ene på kontoen din Public- noe som betyr at du vil tillate kundene dine å distribuere nye virtuelle maskiner fra disse ISO-ene hvis de velger å gjøre det. Alle ISO-ene på kontoen din er satt til Disabled som standard i modulen, og du må aktivere dem.
For å velge hvilke øyeblikksbilder som skal offentliggjøres for kundene dine, følg trinnene nedenfor:
- Logg på WHMCS Admin Panel.
- Fortsett
Addons -> Vultr Module.
- Klikk på
ISO.
- Klikk på
Disabledknappen for å aktivere ISO-ene du ønsker å gjøre offentlige (ved å klikke på knappen når det står Enabled, aktiveres ISO på nytt).
- Du er ferdig.
Bestillingsprosess
Å bestille Vultr-baserte produkter i WHMCS er en tre-trinns prosess.
Trinn 1
Klientbestillinger i WHMCS-klientområdet/handlekurven: Klienten vil legge inn en bestilling på en virtuell maskin. De vil bli bedt om å legge inn:
- Vertsnavn
- Root-passord
- NS1 og NS2
Dette er standard WHMCS-bestillingsskjema og Vultr har ingen kontroll over. Du er velkommen til å endre malen for WHMCS-bestillingsskjema for å skjule noen av disse alternativene. Vær oppmerksom på at det valgte root-passordet i rekkefølgen for ikke vil bli brukt siden Vultrs API vil generere et tilfeldig sikkert passord for hver VM. I tillegg, hvis en klient distribuerer fra et øyeblikksbilde, må de vite root-passordet for øyeblikksbildet på forhånd, ellers vil de ikke kunne logge på.
I tillegg vil klienten bli bedt om å velge om automatisk sikkerhetskopiering, øyeblikksbildegrense og OS-type skal aktiveres eller ikke.
Når det gjelder OS-typen, er det 4 alternativer i rullegardinmenyen som vises under OS Typei bestillingsskjemaet
- En liste over alle tilgjengelige OS-bilder
- ISO
- Øyeblikksbilde
- applikasjon
Velger Applicationdu en liste over alle tilgjengelige One-Click Apps Vultr-tilbud. ISO og Snapshot lar kunden velge hvilken ISO eller Snapshot den virtuelle maskinen skal distribueres fra.
Steg 2
Administratoren vil godkjenne bestillingen og levere tjenesten i WHMCS (eller du kan velge å gjøre det til en automatisert prosess i produktalternativet i WHMCS på samme måte som alle andre produkter i WHMCS.
Trinn 3
Kunden må fullføre bestillingsprosessen i klientområdet ved å velge en etikett/kallenavn for serveren, et vertsnavn og andre alternativer som SSH-nøkkel, IPv6, privat nettverk eller oppstartsskript.
FAQ
Jeg fikk en feilmelding om tilkoblingsfeil.
Sørg for at API-nøkkelen din ikke er prefiks eller suffiksert med noen mellomrom, og at serverens IPv4- og IPv6-adresser begge er hvitelistet for API-tilgang. Du kan bekrefte API-reglene dine i medlemsområdet .
Hvis nøkkelen og ACL-reglene er riktige, kan du teste nøkkelen din ytterligere ved å logge på WHMCS-serveren din og kjøre direkte API-kall ved å bruke cURL. cURL-eksempler er gitt i vår API-eksempelseksjon .
Hvordan spesifiserer jeg et standard oppstartsskript via det automatiske oppsettsystemet?
Som nevnt forventes kunden å fullføre utplasseringen av den virtuelle maskinen i klientområdet etter at de har tilpasset alternativene etter deres smak. Husk at listen over plasseringer er dynamisk fylt ut avhengig av den valgte planens tilgjengelighet på tvers av Vultrs skylokasjoner - se trinn 3 ovenfor. Det er for øyeblikket ingen funksjon for å sette opp et globalt oppstartsskript.
Hvordan oppdaterer jeg applikasjonene i konfigurasjonsalternativene?
Hvis du vil liste opp alle tilgjengelige applikasjoner, kan du bruke denne API-kommandoen og legge til applikasjonene du ønsker i de konfigurerbare alternativene. Automatisk synkronisering finnes ikke i modulen.