Vultr WHMCS-modul

Obs : Vänligen läs detta dokument i sin helhet innan du installerar Vultr WHMCS-modulen

Modulinformation

• Version: 2.0.0 (Uppdaterad)
• Releasedatum: 25 juni 2019
• Ändringslogg
• Vänligen skicka in eventuella problem/felrapporter till det officiella Vultr WHMCS github-förrådet

Introduktion

Vultr-plattformen erbjuder ett kraftfullt, funktionsrikt API som låter användare kontrollera varje aspekt av sitt konto. Vultr WHMCS-modulen förser värdleverantörer med en helt automatiserad lösning som gör att de kan erbjuda pålitliga molnservrar på Vultr-plattformen till sina kunder.

Obs: Den nuvarande versionen av modulen är en fullständig omskrivning av originalmodulen, men är kompatibel med befintliga Vultr-baserade produkter i WHMCS.

Systemkrav

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

Förutsättningar

• Vultr API-nyckel
• Dina WHMCS-server-IP:er vitlistas för API-åtkomst

Anteckningar

• Du måste vitlista din WHMCS-servers IPv4- och IPv6-adresser för API-åtkomst
  • Om din server har flera IPv4-adresser kan du vitlista dem individuellt eller vitlista hela undernätet.
  • Om din server har en IPv6-adress är det bäst att vitlista hela /64-undernätet
• WHMCS Version 6 inte stöds på grund av att nå slutet av sin livslängd.
• PHP version 7.0.x är inte stöds på grund av att nå slutet av sin livslängd.
• Det finns inga planer på att stödja äldre versioner av WHMCS och PHP.
• Du måste använda de konfigurerbara alternativen som genereras av modulen för produkterna. Att skapa din egen kommer sannolikt att orsaka en konflikt.

Begränsningar

Nedan är listan över alternativ som modulen inte innehåller genom design.

1. Lägg till ytterligare IPv4-adresser.
2. Aktivera privat nätverk efter att en virtuell maskin har distribuerats.
3. Växla mellan OS och appar.
4. Växla mellan Linux och Windows.

Omfattning

Detta dokument kommer att täcka processen för att installera och konfigurera den officiella Vultr WHMCS-modulen. Moduler som laddas ner från tredje parts webbplatser stöds inte av Vultr.

Modulfunktioner

• Ett klick Skapande av VPS-produkter baserade på Vultr
  • Du måste manuellt ställa in prissättningen för varje produkt och konfigurerbart alternativ.
• Distribuera och uppgradera virtuella maskiner
• Ström på/av/cykelfunktion
• HTML5 VNC-konsol
• rDNS-kontroll
• Privat nätverk
• Startskript
• SSH-nycklar
• Snapshot Control
• Distribuera virtuella datorer från en lista med fördefinierade ISO:er
• Distribuera virtuella datorer från en lista med fördefinierade ögonblicksbilder
• Aktivera/inaktivera specifika ISO:er och ögonblicksbilder för VM-distributioner
• Aktivera/inaktivera distributionsplatser
• Vultr DNS Support med Vanity DNS (Custom Nameserver) Support

Skapa en API-nyckel

1. Logga in på Vultr Client Area.
2. Klicka på Konto.
3. Klicka på API.
4. Klicka på Aktivera API.
5. Vitlista IP-adresserna för din WHMCS-server under Åtkomstkontroll.

Installation

Det första steget är att ladda ner Vultr WHMCS-modulen här

Ny installation

1. Extrahera ZIP-arkivet.
2. Ladda upp modulfilerna till din WHMCS-server enligt kataloghierarkin som definieras nedan

Uppgradera från en äldre version av modulen

1. Säkerhetskopiera din databas och filer
2. Helt ta bort modules/addons/vultroch modules/servers/vultrkataloger.
3. Extrahera och ladda upp den nya modulen.

Kataloghierarki

Nedladdat arkiv

• Moduler
  • tillägg
    • vultr
  • servrar
    • vultr

Första installationen

1. Ladda upp modulen enligt anvisningarna ovan
2. Logga in på din WHMCS adminpanel och navigera till Setup -> Addon Modules.
3. Vultr ModuleKlicka på Configureknappen bredvid .
4. Markera kryssrutan bredvid Hooks Enabled.
5. Ange din API-nyckel i API Keyfältet.
6. Ställ in Access Controlför Administratoroch andra roller du vill aktivera det för.
7. Klick Save Changes
8. Logga in på din WHMCS adminpanel och navigera till för Addons -> Vultr Moduleatt konfigurera dina modulalternativ som visas i nästa avsnitt av detta dokument

Modulkonfiguration

Det här avsnittet av dokumentationen kommer att visa upp alla tillgängliga konfigurationsalternativ för modulen, förklara hur de fungerar och förklara hur man konfigurerar dem.

Produktskapare

Det här avsnittet låter dig skapa en Vultr-baserad produkt i WHMCS. Det finns två lägen, Single Product Creatoroch Multiple Product Creator.

Det Single Product Creatorläget gör att du kan skapa en produkt baserad på de tillgängliga Vultr paket välja produktgrupp och prissättning för den produkt som du lägger till. Prissättning för konfigurerbara alternativ som Snapshots, Windows, cPanel Apps etc... måste läggas till manuellt i produktens konfigurerbara alternativ.

De Multi Product Creatorkommer att bulkskapa Vultr-baserade VPS-paket i din WHMCS, men du måste manuellt ställa in prissättningen för varje paket samt prissättningen för de konfigurerbara alternativen, liknande Single Product Creatorläget.

Produkter

Det här avsnittet visar en komplett lista över alla dina Vultr-baserade produkter i WHMCS och låter dig snabbt navigera till Edit, eller Configurable Options sidan för var och en. Du kan också ta bort en produkt från den sidan. Det här avsnittet är ganska användbart när du snabbt vill hitta en Vultr-produkt i ditt WHMCS-administrationsområde för att modifiera den eller modifiera de konfigurerbara alternativen för den.

DNS

Vultr WHMCS-modulen stöder Vanity Nameservers (anpassad ns1 och ns2.domain.com). Att ställa in Vanity Nameservers kräver ett första steg, vilket är att skapa de anpassade namnservrarna med din domänregistrator och peka dem till IP:erna ns1.vultr.comoch ns2.vultr.comlösa till. När du är klar, följ stegen nedan:

1. Logga in på din WHMCS adminpanel.
2. Fortsätt Addons -> Vultr Module.
3. Klicka på DNS.
4. Lägg till värdena för Nameserver 1och Nameserver 2och klicka på Save Changes.
5. Du är klar.

Observera att Vanity-namnservrar tillämpas på nyligen tillagda DNS-zoner/domäner. Befintliga kommer att behöva modifieras i https://my.vultr.com manuellt.

Serverplats

Du har möjlighet att aktivera och inaktivera vissa molnplatser, så att dina kunder kan distribuera virtuella maskiner endast på de platser du väljer. Tänk på att det inte är möjligt att välja molnplats under beställningsprocessen eftersom platserna laddas dynamiskt beroende på var det valda paketet är tillgängligt vid tidpunkten för implementeringen.

För att välja vilka platser som ska aktiveras för dina kunder, följ stegen nedan:

1. Logga in på din WHMCS adminpanel.
2. Fortsätt Addons -> Vultr Module.
3. Klicka på Server Location.
4. Klicka på Enabledknappen för att inaktivera de platser du vill inaktivera (om du klickar på knappen när det står Disabledkommer platsen att återaktiveras).
5. Du är klar.

Ögonblicksbilder

Vultr WHMCS-modulen låter dig göra en eller flera av ögonblicksbilderna på ditt konto Public- vilket innebär att du skulle tillåta dina kunder att distribuera nya virtuella maskiner från dessa ögonblicksbilder om de väljer att göra det. Alla ögonblicksbilder på ditt konto är inställda på som Disabled standard i modulen och du skulle behöva aktivera dem.

För att välja vilka ögonblicksbilder som ska göras offentliga för dina kunder, följ stegen nedan:

1. Logga in på din WHMCS adminpanel.
2. Fortsätt Addons -> Vultr Module.
3. Klicka på Snapshots.
4. Klicka på Disabledknappen för att aktivera de ögonblicksbilder du vill göra offentliga (om du klickar på knappen när det står Enabledkommer det att återaktivera ögonblicksbilden).
5. Du är klar.

ISO

I likhet med Snapshot-funktionen kan du skapa en eller flera av de anpassade uppladdade ISO:erna på ditt konto Public- vilket innebär att du skulle tillåta dina kunder att distribuera nya virtuella maskiner från dessa ISO:er om de väljer att göra det. Alla ISO på ditt konto är inställda på som Disabled standard i modulen och du skulle behöva aktivera dem.

För att välja vilka ögonblicksbilder som ska göras offentliga för dina kunder, följ stegen nedan:

1. Logga in på din WHMCS adminpanel.
2. Fortsätt Addons -> Vultr Module.
3. Klicka på ISO.
4. Klicka på Disabledknappen för att aktivera ISO:erna du vill göra offentliga (om du klickar på knappen när det står Enabledkommer att återaktivera ISO).
5. Du är klar.

Beställningsprocess

Att beställa Vultr-baserade produkter i WHMCS är en process i tre steg.

Steg 1

Klientordrar i WHMCS-klientområdet/vagnen: Klienten kommer att lägga en beställning på en virtuell maskin. De kommer att bli ombedda att ange:

• Värdnamn
• Rotlösenord
• NS1 & NS2

Detta är standard WHMCS Order Form och Vultr har ingen kontroll över. Du är välkommen att ändra din WHMCS orderformulärmall för att dölja något av dessa alternativ. Kom ihåg att den valda rootlösenordet i beslutet om att inte användas eftersom Vultr API kommer att generera ett slumpmässigt säkert lösenord för varje VM. Dessutom, om en klient distribuerar från en ögonblicksbild, skulle de behöva känna till root-lösenordet för ögonblicksbilden i förväg, annars kommer de inte att kunna logga in.

Dessutom kommer klienten att bli ombedd att välja om automatisk säkerhetskopiering, gräns för ögonblicksbild och OS-typ ska aktiveras eller inte.

När det gäller OS-typen finns det fyra alternativ i rullgardinsmenyn som visas under OS Typei beställningsformuläret

1. En lista över alla tillgängliga OS-bilder
2. ISO
3. Ögonblicksbild
4. Ansökan

Genom Applicationatt välja aktiveras en lista över alla tillgängliga One-Click Apps Vultr-erbjudanden. ISO och Snapshot låter kunden välja vilken ISO eller Snapshot som den virtuella maskinen ska distribueras från.

Steg 2

Administratören skulle godkänna beställningen och tillhandahålla tjänsten i WHMCS (eller så kan du välja att göra det till en automatiserad process i produktalternativet i WHMCS på samma sätt som alla andra produkter i WHMCS.

Steg 3

Kunden måste slutföra beställningsprocessen i klientområdet genom att välja en etikett/smeknamn för sin server, ett värdnamn och andra alternativ som SSH-nyckel, IPv6, privat nätverk eller startskript.

FAQ

Jag fick ett felmeddelande om anslutningsfel.

Se till att din API-nyckel inte har prefix eller suffix med något blanksteg, och att serverns IPv4- och IPv6-adresser båda är vitlistade för API-åtkomst. Du kan verifiera dina API-regler i medlemsområdet .

Om nyckeln och ACL-reglerna är korrekta kan du testa din nyckel ytterligare genom att logga in på din WHMCS-server och köra direkta API-anrop med hjälp av cURL. cURL-exempel finns i vårt API-exempelavsnitt .

Hur anger jag ett standardstartskript via det automatiska installationssystemet?

Som sagt förväntas kunden slutföra utplaceringen av den virtuella maskinen i klientområdet efter att de har anpassat sina alternativ efter eget tycke. Tänk på att listan över platser är dynamiskt ifylld beroende på den valda planens tillgänglighet över Vultrs molnplatser - se steg 3 ovan. Det finns för närvarande ingen funktion för att ställa in ett globalt startskript.

Hur uppdaterar jag applikationerna i konfigurationsalternativen?

Om du vill lista alla tillgängliga applikationer kan du använda detta API-kommando och lägga till de applikationer du vill ha i de konfigurerbara alternativen. Automatisk synkronisering finns inte i modulen.