Vultr WHMCS-modul

Bemærk : Læs dette dokument i sin helhed, før du installerer Vultr WHMCS-modulet

Moduloplysninger

• Version: 2.0.0 (opdateret)
• Udgivelsesdato: 25. juni 2019
• Ændringslog
• Indsend venligst eventuelle problem-/fejlrapporter til det officielle Vultr WHMCS github-lager

Introduktion

Vultr-platformen tilbyder en kraftfuld, funktionsrig API, der giver brugerne mulighed for at kontrollere alle aspekter af deres konto. Vultr WHMCS-modulet giver hostingudbydere en fuldautomatisk løsning, der giver dem mulighed for at tilbyde pålidelige Cloud-servere på Vultr-platformen til deres kunder.

Bemærk: Den nuværende version af modulet er en komplet omskrivning af det originale modul, men er kompatibel med eksisterende Vultr-baserede produkter i WHMCS.

Systemkrav

• WHMCS version 7.2.x eller nyere
• PHP version 7.1.x eller nyere
• MySQL  5.6 , MariaDB  5.6 , MariaDB  10.0 eller MariaDB  10.1 .
• ionCube Loader.

Forudsætninger

• Vultr API nøgle
• Dine WHMCS-server-IP'er bliver hvidlistet til API-adgang

Noter

• Du skal hvidliste din WHMCS-servers IPv4- og IPv6-adresser for API-adgang
  • Hvis din server har flere IPv4-adresser, kan du hvidliste dem individuelt eller hvidliste hele undernettet.
  • Hvis din server har en IPv6-adresse, er det bedst at hvidliste hele /64-undernettet
• WHMCS Version 6 understøttes ikke på grund af endt levetid.
• PHP Version 7.0.x understøttes ikke på grund af endt levetid.
• Der er ingen planer om at understøtte ældre version af WHMCS og PHP.
• Du skal bruge de konfigurerbare muligheder, der er genereret af modulet til produkterne. At skabe din egen vil sandsynligvis forårsage en konflikt.

Begrænsninger

Nedenfor er en liste over muligheder, som modulet ikke inkluderer ved design.

1. Tilføj yderligere IPv4-adresser.
2. Aktiver privat netværk, efter at en virtuel maskine er blevet implementeret.
3. Skift mellem OS og Apps.
4. Skift mellem Linux og Windows.

Omfang

Dette dokument vil dække processen med at installere og konfigurere det officielle Vultr WHMCS-modul. Moduler, der er downloadet fra tredjepartswebsteder, understøttes ikke af Vultr.

Modulfunktioner

• Et-klik oprettelse af VPS-produkter baseret på Vultr
  • Du skal manuelt indstille prisen for hvert produkt og konfigurerbar mulighed.
• Implementer og opgrader virtuelle maskiner
• Tænd/sluk/cyklus funktion
• HTML5 VNC-konsol
• rDNS kontrol
• Privat netværk
• Opstartsscripts
• SSH nøgler
• Snapshot kontrol
• Implementer VM'er fra en liste over foruddefinerede ISO'er
• Implementer VM'er fra en liste over foruddefinerede Snapshots
• Aktiver/deaktiver specifikke ISO'er og snapshots til VM-implementeringer
• Aktiver/deaktiver implementeringssteder
• Vultr DNS Support med Vanity DNS (Custom Nameserver) Support

Oprettelse af en API-nøgle

1. Log ind på Vultr Client Area.
2. Klik på Konto.
3. Klik på API.
4. Klik på Aktiver API.
5. Hvidliste IP-adresserne på din WHMCS-server under Adgangskontrol.

Installation

Det første trin er at downloade Vultr WHMCS-modulet her

Ny installation

1. Udpak ZIP-arkivet.
2. Upload modulfilerne til din WHMCS-server ved at følge kataloghierarkiet defineret nedenfor

Opgrader fra en ældre version af modulet

1. Sikkerhedskopier din database og filer
2. Slet mapperne modules/addons/vultrog fuldstændigt modules/servers/vultr.
3. Udpak og upload det nye modul.

Directory hierarki

Downloadede arkiv

• Moduler
  • tilføjelser
    • vultr
  • servere
    • vultr

Første opsætning

1. Upload modulet som beskrevet ovenfor
2. Log ind på dit WHMCS Admin Panel og naviger til Setup -> Addon Modules.
3. Ved siden af Vultr Module, skal du klikke på Configureknappen.
4. Marker afkrydsningsfeltet ud for Hooks Enabled.
5. Indtast din API-nøgle i API Keyfeltet.
6. Opsætning Access Controlfor Administratorog andre roller, du ønsker at aktivere det til.
7. Klik Save Changes
8. Log ind på dit WHMCS Admin Panel og naviger til for Addons -> Vultr Moduleat konfigurere dine modulindstillinger i næste afsnit af dette dokument

Modul konfiguration

Denne sektion af dokumentationen viser alle de tilgængelige konfigurationsmuligheder for modulet, forklarer, hvordan de fungerer, og forklarer, hvordan de konfigureres.

Produktskaber

Dette afsnit giver dig mulighed for at oprette et Vultr-baseret produkt i WHMCS. Der er to tilstande, Single Product Creatorog Multiple Product Creator.

Den Single Product Creatortilstand vil give dig mulighed for at skabe et produkt baseret på de tilgængelige Vultr pakker, skal du vælge en produktgruppe, og prissætningen for det produkt, du tilføjer. Priser for konfigurerbare indstillinger såsom Snapshots, Windows, cPanel Apps osv... skal tilføjes manuelt til produktets konfigurerbare indstillinger.

De Multi Product Creatorvil masseoprette Vultr-baserede VPS-pakker i din WHMCS, men du bliver nødt til manuelt at konfigurere prissætningen for hver pakke samt prissætning for de konfigurerbare indstillinger, svarende til Single Product Creatortilstanden.

Produkter

Dette afsnit viser en komplet liste over alle dine Vultr-baserede produkter i WHMCS og giver dig mulighed for hurtigt at navigere til Edit, eller Configurable Options siden for hver enkelt. Du kan også slette et produkt fra den side. Dette afsnit er ret nyttigt, når du hurtigt vil finde et Vultr-produkt i dit WHMCS-administrationsområde for at ændre det eller ændre de konfigurerbare indstillinger for det.

DNS

Vultr WHMCS-modulet understøtter Vanity Nameservers (custom ns1 og ns2.domain.com). Opsætning af Vanity Nameservers kræver et første trin, som er at oprette de brugerdefinerede navneservere med din domæneregistrator og pege dem til IP'erne ns1.vultr.comog ns2.vultr.comløser til. Når du er færdig, skal du følge nedenstående trin:

1. Log ind på dit WHMCS Admin Panel.
2. Fortsæt Addons -> Vultr Module.
3. Klik på DNS.
4. Tilføj værdierne for Nameserver 1og Nameserver 2og klik på Save Changes.
5. Du er færdig.

Bemærk venligst, at Vanity-navneservere anvendes på nyligt tilføjede DNS-zoner/domæner. Eksisterende skal ændres manuelt i https://my.vultr.com.

Serverplacering

Du har mulighed for at aktivere og deaktivere visse Cloud-placeringer, hvilket giver dine kunder mulighed for kun at implementere virtuelle maskiner på de steder, du vælger. Husk, at det ikke er muligt at vælge Cloud-placeringen under ordreprocessen, da lokationer indlæses dynamisk afhængigt af, hvor den valgte pakke er tilgængelig på tidspunktet for implementeringen.

Følg nedenstående trin for at vælge, hvilke lokationer der skal aktiveres for dine kunder:

1. Log ind på dit WHMCS Admin Panel.
2. Fortsæt Addons -> Vultr Module.
3. Klik på Server Location.
4. Klik på Enabledknappen for at deaktivere de placeringer, du ønsker at deaktivere (hvis du klikker på knappen, når der står Disabled, genaktiveres placeringen).
5. Du er færdig.

Snapshots

Vultr WHMCS-modulet giver dig mulighed for at lave et eller flere af snapshots på din konto Public- hvilket betyder, at du vil tillade dine kunder at implementere nye virtuelle maskiner fra disse snapshots, hvis de vælger at gøre det. Alle snapshots på din konto er Disabled som standard indstillet til i modulet, og du skal aktivere dem.

For at vælge, hvilke snapshots der skal offentliggøres for dine kunder, skal du følge nedenstående trin:

1. Log ind på dit WHMCS Admin Panel.
2. Fortsæt Addons -> Vultr Module.
3. Klik på Snapshots.
4. Klik på Disabledknappen for at aktivere de Snapshots, du ønsker at offentliggøre (hvis du klikker på knappen, når der står Enabled, genaktiveres Snapshot).
5. Du er færdig.

ISO

I lighed med Snapshot-funktionen kan du lave en eller flere af de brugerdefinerede uploadede PublicISO'er på din konto - hvilket betyder, at du vil tillade dine kunder at implementere nye virtuelle maskiner fra disse ISO'er, hvis de vælger at gøre det. Alle ISO'er på din konto er Disabled som standard indstillet til i modulet, og du skal aktivere dem.

For at vælge, hvilke snapshots der skal offentliggøres for dine kunder, skal du følge nedenstående trin:

1. Log ind på dit WHMCS Admin Panel.
2. Fortsæt Addons -> Vultr Module.
3. Klik på ISO.
4. Klik på Disabledknappen for at aktivere de ISO'er, du ønsker at offentliggøre (hvis du klikker på knappen, når der står Enabled, genaktiveres ISO'en).
5. Du er færdig.

Bestillingsproces

Bestilling af Vultr-baserede produkter i WHMCS er en tre-trins proces.

Trin 1

Klientordrer i WHMCS-klientområdet/indkøbskurven: Klienten afgiver en ordre på en virtuel maskine. De vil blive bedt om at indtaste:

• Værtsnavn
• Root-adgangskode
• NS1 & NS2

Dette er standard WHMCS-bestillingsformularen, og Vultr har ingen kontrol over. Du er velkommen til at ændre din WHMCS-bestillingsformularskabelon for at skjule nogen af ​​disse muligheder. Husk, at den valgte root-adgangskode i rækkefølgen for ikke vil blive brugt, da Vultr's API vil generere en tilfældig sikker adgangskode for hver VM. Derudover, hvis en klient implementerer fra et Snapshot, skal de kende root-adgangskoden til Snapshot på forhånd, ellers vil de ikke være i stand til at logge ind.

Derudover vil klienten blive bedt om at vælge, om automatisk sikkerhedskopiering, Snapshot-grænse og OS-type skal aktiveres eller ej.

Med hensyn til OS-typen er der 4 muligheder i rullemenuen, der vises under OS Typei ordreformularen

1. En liste over alle tilgængelige OS-billeder
2. ISO
3. Snapshot
4. Ansøgning

Valg Applicationaktiverer en liste over alle de tilgængelige One-Click Apps Vultr-tilbud. ISO og Snapshot giver kunden mulighed for at vælge, hvilken ISO eller Snapshot den virtuelle maskine skal installeres fra.

Trin 2

Administratoren vil godkende ordren og levere tjenesten i WHMCS (eller du kan vælge at gøre det til en automatiseret proces i produktindstillingen i WHMCS på samme måde som ethvert andet produkt i WHMCS.

Trin 3

Kunden skal afslutte bestillingsprocessen i klientområdet ved at vælge en Label/Kaldenavn til deres server, et værtsnavn og andre muligheder såsom SSH Key, IPv6, Private Networking eller Startup Script.

FAQ

Jeg modtog en fejl om forbindelsesfejl.

Sørg for, at din API-nøgle ikke er præfikset eller suffikset med et mellemrum, og at din servers IPv4- og IPv6-adresser begge er hvidlistet til API-adgang. Du kan bekræfte dine API-regler i medlemsområdet .

Hvis nøglen og ACL-reglerne er korrekte, kan du yderligere teste din nøgle ved at logge ind på din WHMCS-server og køre direkte API-kald ved at bruge cURL. cURL-eksempler findes i vores API-eksempelsektion .

Hvordan angiver jeg et standard opstartsscript via det automatiske opsætningssystem?

Som nævnt forventes kunden at færdiggøre udrulningen af ​​den virtuelle maskine i klientområdet, efter at de har tilpasset deres muligheder efter deres smag. Husk venligst, at listen over lokationer er dynamisk udfyldt afhængigt af den valgte plans tilgængelighed på tværs af Vultrs skylokationer - se trin 3 ovenfor. Der er i øjeblikket ingen funktion til at opsætte et globalt opstartsscript.

Hvordan opdaterer jeg applikationerne i konfigurationsmulighederne?

Hvis du vil have en liste over alle tilgængelige applikationer, kan du bruge denne API-kommando og tilføje de applikationer, du ønsker, i de konfigurerbare muligheder. Automatisk synkronisering findes ikke i modulet.