Personal tools
Namespaces

Variants
Actions

IP Manager For WHMCS

From ModulesGarden Wiki
(Difference between revisions)
Jump to: navigation, search
(→‎Export)
Line 4: Line 4:
 
=About [http://www.modulesgarden.com/products/whmcs/ip_manager/features IP Manager For WHMCS]=
 
=About [http://www.modulesgarden.com/products/whmcs/ip_manager/features IP Manager For WHMCS]=
 
{|
 
{|
−
|style="padding: 10px 0px 5px 0px;"|'''IP Manager For WHMCS''' allows you to conveniently add and manage IP pools, and automatically assign IP addresses to your servers, products, addons or configurable options.<br />
+
|style="padding: 10px 0px 5px 0px;"|'''IP Manager For WHMCS''' allows you to conveniently add and manage IP subnet, and automatically assign IP addresses to your servers, products, addons or configurable options.<br />
−
With our module you will be also able to assign an IP pool to a specified client, integrate with 3rd party applications like cPanel, export IP pools or view clear graphs.<br />
+
With our module you will be also able to assign an IP subnet to a specified client, integrate with 3rd party applications like cPanel, export IP subnets or view clear graphs.<br />
−
You will also be able to synchronize IP addresses used by products in your WHMCS system with the module's IP blocks and pools.<br />
+
You will also be able to synchronize IP addresses used by products in your WHMCS system with the module's IP subnets.<br />
 
What is more, IP Manager For WHMCS will allow your customers to easily manage their IP addresses from the WHMCS client area.
 
What is more, IP Manager For WHMCS will allow your customers to easily manage their IP addresses from the WHMCS client area.
 
|}
 
|}
Line 172: Line 172:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:IPM1.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_1.png]]
 
|}
 
|}
 
{|
 
{|
Line 183: Line 183:
 
{|
 
{|
 
|style="padding: 0px 0px 15px 15px;"|'''3. When you install IP Manager for the first time, you have to rename '' 'license_RENAME.php' '' file.'''<br />
 
|style="padding: 0px 0px 15px 15px;"|'''3. When you install IP Manager for the first time, you have to rename '' 'license_RENAME.php' '' file.'''<br />
−
File is located in '' 'modules/addons/ipmanager2/license_RENAME.php'. '' Rename it from '' 'license_RENAME.php' '' to '' 'license.php'. ''
+
File is located in '' 'modules/addons/IPM2_anager2/license_RENAME.php'. '' Rename it from '' 'license_RENAME.php' '' to '' 'license.php'. ''
 
|}
 
|}
 
{|
 
{|
Line 204: Line 204:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:IPM5.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_5.png]]
 
|}
 
|}
 
{|
 
{|
Line 211: Line 211:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:IPM6.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_6.png]]
 
|}
 
|}
 
{|
 
{|
 
|style="padding: 0px 0px 15px 15px;"|'''8. The last step is setting chmod 755 to '' 'storage' '' folder.'''<br />
 
|style="padding: 0px 0px 15px 15px;"|'''8. The last step is setting chmod 755 to '' 'storage' '' folder.'''<br />
−
Folder is located in '' 'you_whmcs/modules/addons/ipmanager2'. ''
+
Folder is located in '' 'you_whmcs/modules/addons/IPM2_anager2'. ''
 
|}
 
|}
 
{|
 
{|
Line 225: Line 225:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 30px 25px;"|[[File:IPM7.png]]
+
|style="padding: 0px 0px 30px 25px;"|[[File:IPM2_7.png]]
 
|}
 
|}
 +
 
=Configuration and Management=
 
=Configuration and Management=
 
{|
 
{|
Line 234: Line 235:
 
In this short guide we will present you the possibilities of our module.  
 
In this short guide we will present you the possibilities of our module.  
 
|}
 
|}
−
==IP Pools==
+
==Subnets==
 
{|
 
{|
−
|style="padding: 10px 0px 30px 15px;"|To manage any IP pool via IP Manager you have to add it first.<br />
+
|style="padding: 10px 0px 30px 15px;"|To manage any Subnet via IP Manager you have to add it first.<br />
−
There are four ways to do that. You can use CIDR notation, enter IP addresses range, provide a full list of IP addresses or create IP blocks for subnets.<br /> <br />
+
Remember that it is very important to configure any IP reservation rules before you create any subnets. If you add rules later on, they may not work properly!<br/>
−
''Note 1: IP addresses range and IP addresses list support IPv4 only.''<br />
+
Read about rules reservation [LINK DO RUKLI here.]
−
''Note 2: IPv6 pools rely on IP addresses range. Additionally, only assigned IP addresses are stored in the database.''<br />
+
 
−
''Therefore free IPv6 addresses will not be visible in the IP pool overview.''<br/>
+
To add a new subnet press '' 'Create New Subnet' '' and follow further instructions.
−
''Note 3: IP Block Assigned For Subnet feature is currently available for IPv6 only.''
+
 
|}
 
|}
−
===Create IP Pool===
+
===Create Subnet===
 
{|
 
{|
−
|style="padding: 10px 0px 20px 15px;"|In order to add a new IP addresses pool, go to '' 'IP Pool' '' → '' 'Create IP Pool'. ''
+
|style="padding: 10px 0px 20px 15px;"|To begin, add a new IP addresses subnet, press'' 'Create New Subnet' '' button.
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 30px 25px;"|[[File:IPM7_1.png]]
+
|style="padding: 0px 0px 30px 25px;"|[[File:IPM2_8.png]]
 
|}
 
|}
−
====CIDR Notation====
 
 
{|
 
{|
−
|style="padding: 10px 0px 15px 15px;"|Select '' 'Classless Inter-Domain Routing (CIDR)'. ''<br />
+
|style="padding: 0px 0px 15px 15px;"|'' 'Classless Inter-Domain Routing (CIDR)' '' can be used to add subnets.<br/>
−
Select IP version, type the first IP address from a pool and a netmask (in prefix notation).<br />
+
First of all, select IP version: IPv4 or IPv6, type the subnet IP address and a correct bitmask.<br/>
−
''Note: The first IP from the pool should be compatible with [http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing CIDR notation].''
+
Correct ranges:<br/>
 +
*IPv4 - 1 to 32
 +
*IPv6 - 1 to 128
 +
''Note: The first IP from the subnet should be compatible with [http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing CIDR notation].''
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:IPM8.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_9.png]]
 
|}
 
|}
 
{|
 
{|
 
|style="padding: 0px 0px 15px 15px;"|You can exclude any number of IP addresses from the pool.<br />
 
|style="padding: 0px 0px 15px 15px;"|You can exclude any number of IP addresses from the pool.<br />
−
To do so, enter them into '' 'Excluded IP Addresses:' '' textbox, one IP address or IP range per line.<br />
+
To do so, enter them into '' 'Excluded IP Addresses:' '' textarea, one IP address or IP range per line.<br />
−
Additionally, you can exclude boundary IP addresses through marking '' 'Exclude Boundary' '' checkbox.<br />
+
−
If you want to set nameservers and gateway click on '' 'Toggle Advanced Settings'. ''
+
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:IPM8_1.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_10.png]]
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 15px 15px;"|Enter nameservers and gateway address into textboxes as shown on the screen below ''(This step is optional)''.<br />
+
|style="padding: 0px 0px 15px 15px;"|If you want to set nameservers and gateway click on '' 'Toggle Advanced Settings'. ''<br/>
−
Afterwards, confirm the creation of an IP pool through pressing '' 'Add Pool' '' button.
+
Enter nameservers and gateway address into textboxes as shown on the screen below ''(This step is optional)''.<br />
 +
Afterwards, confirm the creation of an IP pool through pressing '' 'Add Subnet' '' button.
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 30px 25px;"|[[File:IPM8_2.png]]
+
|style="padding: 0px 0px 30px 25px;"|[[File:IPM2_11.png]]
 
|}
 
|}
−
====IP Addresses Range====
+
 
 +
===Available IP Subnets and Child-Subnets===
 
{|
 
{|
−
|style="padding: 10px 0px 15px 15px;"|Select '' 'IP Range'. ''<br />
+
|style="padding: 10px 0px 15px 15px;"|Once you have added some IP pools you can preview some details on them and manage the IP addresses.
−
Type the first and the last IP address of a pool you wish to add.
+
As you can see on the following screen, you can find here a list of Subnets in a tree view. Press any of added IP subnets to see its details.
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:IPM8_3.png]]
+
|style="padding: 0px 0px 30px 25px;"|[[File:IPM2_13.png]]
 
|}
 
|}
 +
====Subnet====
 
{|
 
{|
−
|style="padding: 0px 0px 15px 15px;"|You can exclude any number of IP addresses from the pool.<br />
+
|style="padding: 10px 0px 20px 15px;"|To view subnet's details press on its address as shown on the following screen.
−
To do so, enter them into '' 'Excluded IP Addresses:' '' textbox, one IP address or IP range per line.<br />
+
−
Additionally, you can exclude boundary IP addresses through marking '' 'Exclude Boundary' '' checkbox.<br />
+
−
You should also enter netmask which your IP pool fits in.<br />
+
−
If you want to set nameservers and gateway click on '' 'Toggle Advanced Settings'. ''<br />
+
−
Otherwise, press '' 'Add Pool' '' button and your IP pool will be created.
+
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:IPM8_4.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_14.png]]
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 15px 15px;"|Fill out nameservers and gateway address as shown on the screen below ''(This step is optional)''.<br />
+
|style="padding: 0px 0px 15px 15px;"|In '' 'Subnet'' ' field, you can find information about the address, mask, size, nameservers, gateway and many others.
−
Afterwards, confirm creation of an IP pool through pressing '' 'Add Pool' '' button.
+
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 30px 25px;"|[[File:IPM8_5.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_15.png]]
 
|}
 
|}
−
====List of IP Addresses====
+
'''Bulk Actions'''
 
{|
 
{|
−
|style="padding: 10px 0px 15px 15px;"|Select '' 'One or more single IP Addresses'. ''<br />
+
|style="padding: 0px 0px 10px 15px;"|The most important functions of your IP Manager For WHMCS include some actions that can done on subnets.<br />
−
Type in IP addresses you want to add, comma separated, after typing in the last IP address press '' 'Enter' '' button.<br />
+
−
Afterwards, confirm creation of IP pool through pressing '' 'Add Pool' '' button.<br />
+
−
''Note 1: This option supports only IPv4 addresses.''<br />
+
−
''Note 2: For each IP address added this way, one IP pool will be created.''
+
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 30px 25px;"|[[File:IPM8_8.png]]
+
|style="padding: 0px 0px 20px 15px;"|
 +
*'''Delete''' - use it to remove the subnet together with any IP address in it (if there are such already).
 +
*'''Split''' - select split to divide the subnet into equal subnets according to the chosen mask. Keep in mind that the subnet may already include some assigned IP addresses.<br/> If you split such a subnet, the assigned IPs might be transferred to another subnet.
 +
*'''Merge''' - use this option if you want to join previously split subnet. Note that you can merge only parallel subnets.<br/>
 +
Additionally, you must remember that merge action removes IP addresses from external servers.
 +
*'''Create Child Subnet''' - this option allows to create subnet within a  '' 'parent' '' subnet.
 +
*:Such child subnet may again be slit/merged, have its own child subnets.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:IPM2_17.png]]
 
|}
 
|}
  
−
====IPv6 Block Assigned For Subnet====
+
====Excluded IP Addresses====
 +
{|
 +
|style="padding: 10px 0px 15px 15px;"|List of excluded IP addresses. You can remove some addresses from the list or add new ones. <br/>
 +
Important! If you have any IP reservation rules set up, then do not include singe IP addresses here. This option should be used as an addition if you do not use rules.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:IPM2_18.png]]
 +
|}
 +
====Custom Fields====
 
{|
 
{|
−
|style="padding: 10px 0px 15px 15px;"|Provide a valid network block address, then select the number of subnets that will be created for the block.<br/>
+
|style="padding: 10px 0px 15px 15px;"|IP Manager allows you to add custom fields per subnet.<br />
−
Finally press ''Add Pool'' button.<br/>
+
To add a new custom field, press '' 'Create New Custom Field'. '' Afterwards, fill out the form with custom field name and value. <br/>
−
''Note 1: This option supports only IPv6 addresses.''
+
Again, this option should be used if you do not specify default custom fields or if you want to add some additional ones. Be careful and do not double custom fields here.  
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 30px 25px;"|[[File:IPM801.png]]
+
|style="padding: 0px 0px 30px 25px;"|[[File:IPM2_19.png]]
 
|}
 
|}
  
−
===Show IP Pools===
+
====Assigned Client/Service====
 
{|
 
{|
−
|style="padding: 10px 0px 15px 15px;"|To manage previously created pools and blocks, proceed to '' 'IP Pool' '' → '' 'Show IP Pools'. ''<br />
+
|style="padding: 10px 0px 15px 15px;"|If you wish to assign an IP pool to a client or specific service, our module makes it available to you.<br />
−
As you can see on the following screen, you can find here a list of IP Pools and a list of IP Blocks.
+
You can achieve that through using auto-complete textbox to choose the client and/or service.
 +
Again, remember to '' 'Save Changes'. ''<br />
 +
''Notes:<br/>
 +
IP addresses will be added to all products ordered by client.<br/>
 +
IP addresses will be added to all addons included in products.''
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 30px 25px;"|[[File:IPM8_6_1.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_20.png]]
 
|}
 
|}
−
====Additional Information====
 
 
{|
 
{|
−
|style="padding: 10px 0px 15px 15px;"|You can edit IP pools additional information even after creation of the pool.<br />
+
|style="padding: 0px 0px 30px 15px;"|Keep in mind that a subnet that is assigned to a client is reserved for this client only.<br/>
−
To do so, press the option you want to alter.
+
While IP addresses are assigned to a client, the following aspect s are taken into consideration (in this order):
 +
*subnets assigned to a hosting
 +
*subnets assigned to a client
 +
*subnets assigned to configuration.
 
|}
 
|}
 +
 +
===IP Addresses List===
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:IPM8_6.png]]
+
|style="padding: 10px 0px 15px 15px;"|The easiest possible way of creating IP addresses within the created subnet.<br/>
 +
Simply press '' 'Create IP Address' '' and a new address in the subnet will be generated.  
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 15px;"|Afterwards, enter a new value and press save button as shown on the screen below.
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_21.png]]
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 30px 25px;"|[[File:IPM8_7.png]]
+
|style="padding: 0px 0px 20px 15px;"|Once the address is generated, you can proceed to its assignment.<br/>
 +
Use action buttons to do do so.
 
|}
 
|}
−
====Custom Fields====
 
 
{|
 
{|
−
|style="padding: 10px 0px 15px 15px;"|IP Manager allows you to add custom fields per IP pool.<br />
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_22.png]]
−
To add a new custom field, press '' 'Create a New Custom Field'. ''<br />
+
−
Afterwards, fill out the form with custom field name and value.
+
 
|}
 
|}
 +
====Assign Single IP Address====
 
{|
 
{|
−
|style="padding: 0px 0px 30px 25px;"|[[File:IPM8_9.png]]
+
|style="padding: 0px 0px 20px 15px;"|You are now redirected to a page where you can assign this specific IP address to a service by entering a domain or a username,<br/> using 3rd party integration module or custom assignment.
 
|}
 
|}
−
====Assign To A Client====
 
 
{|
 
{|
−
|style="padding: 10px 0px 15px 15px;"|If you wish to assign an IP pool to a client, our module makes it available to you.<br />
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_23.png]]
−
You can achieve that through using auto-complete textbox to choose the client and pressing '' 'Save Changes' '' button.<br />
+
−
''Note: IP addresses will be added to all products ordered by client.''
+
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 30px 25px;"|[[File:IPM9.png]]
+
|style="padding: 0px 0px 20px 15px;"|Choose the method you wish to use and save the changes.
 
|}
 
|}
−
====IP Pool Details====
 
 
{|
 
{|
−
|style="padding: 10px 0px 20px 15px;"|To view IP pool details press on its address as shown on the following screen.
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_24.png]]
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:IPM10.png]]
+
|style="padding: 0px 0px 20px 15px;"|As you can see, IP address is assigned to selected previously service (related to chosen domain).<br> You may always unassign this IP from this service and again assign it to another one, delete the IP address, create custom field for this single address.
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 15px 15px;"|In IP pool view you can find information about current assignment of IP addresses in the pool and manually manage their assignment.<br />
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_25.png]]
−
We also added records' filters to facilitate the management of addresses.
+
 
|}
 
|}
 +
 +
===Tree View===
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:IPM11.png]]
+
|style="padding: 0px 0px 20px 15px;"|To clarify, a comfortable tree view of your created subnets and child-subnets is available. Let's take a look at it to summarize the divisions.
 
|}
 
|}
−
'''Bulk Actions'''
 
 
{|
 
{|
−
|style="padding: 0px 0px 15px 15px;"|Our module supports actions on multiple IP addresses.<br />
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_26.png]]
−
To issue such action, mark involved IP addresses and choose desired action from '' 'Action For Selected IP Addresses' '' dropdown menu.<br />
+
−
Afterwards, confirm your choice through pressing '' 'Save Changes'. ''
+
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:IPM11_1.png]]
+
|style="padding: 0px 0px 20px 15px;"| You can see here a list of all subnets and child subnets in your IP Manager. Subnets marked with red already have some child subnets created, press any to show the list of child subnets.<br/> Accordingly available actions change.  
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 15px;"|
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_27.png]]
−
*'''Delete From The Pool''' - as its name suggests, removes IP addresses from a pool.
+
−
*'''Unassign''' - removes IP addresses from products they were assigned to, IP addresses still remain in the pool.
+
−
*'''Unassign Using Submodules''' - works in the same way as '''Unassign''' does.
+
−
Additionally, it removes IP addresses from external servers.
+
−
*'''Assign''' - is the most interesting option, it allows you to:
+
−
**Choose a product which IP addresses should be assigned to.
+
−
**Define whether or not to use 3rd party integration module.
+
−
**Set them as assigned without assigning them to any product. You can also add a note to each involved IP address.
+
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 30px 25px;"|[[File:IPM11_2.png]]
+
|style="padding: 0px 0px 20px 15px;"| Any subnet can have child subnets created (with IP reservation rules taken into consideration) and custom fields assigned.
 
|}
 
|}
−
====Custom Fields For IP Addresses====
 
 
{|
 
{|
−
|style="padding: 10px 0px 15px 15px;"|Additionally, you can assign a custom field to IP address.<br />
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_28.png]]
−
Some 3rd party integration submodules may need additional information provided along with IP address (like MAC address) this it the place to add them.<br />
+
−
To add custom field, press '' 'Add a New Custom Field' '' next to IP address you want to assign a custom field to.
+
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:IPM11_3.png]]
+
|style="padding: 0px 0px 30px 15px;"| Child subnets, however, can again have their child subnets created, can be split, merged or deleted. 
 +
You may also manually exclude some IP addresses from a child subnet, assign clients and services directly to it and finally manage single IP addresses in such subnet.
 
|}
 
|}
 +
 +
==Settings==
 
{|
 
{|
−
|style="padding: 0px 0px 20px 15px;"|Afterwards, fill in '' 'Custom Field Name' '' and '' 'Custom Field Value' '' and press '' 'Save Changes' ''.
+
|style="padding: 10px 0px 15px 15px;"|'''Along with great power comes great responsibility.'''<br />
 +
IP Manager For WHMCS allows you to define its behavior, therefore make sure you configure settings that suit you needs.
 
|}
 
|}
 +
===Show Settings===
 +
====Module Settings====
 
{|
 
{|
−
|style="padding: 0px 0px 30px 25px;"|[[File:IPM11_4.png]]
+
|style="padding: 10px 0px 20px 15px;"|Below, you can find description of each option.
 +
*'''Assignment Process Settings'''
 +
*#For any configuration you provide into this field, '' 'Dedicated IP' '' field will be omitted.
 +
*#If checked, additional IP addresses will be stored in a custom field or '' 'Assigned IPs' '' field.
 +
*#If checked, in case of a server provisioning failure, relation will be saved.
 +
*#Automatically process the IP address when downgrading the configurable option.
 +
*#Module ignores error message from an external server and continues the action.
 +
*'''IP Logs Settings'''
 +
*#IP addresses without product or user will not be displayed in '' 'IP Logs' '' page.
 +
*'''IP Reservation Settings'''
 +
*#If you check this checkbox, you will allow to add IP reservation rules.
 +
*'''Email Reminder Settings'''
 +
*#If you check this checkbox, you will receive an email with notification about IP subnets running out of IP addresses.
 +
*#Enables you to define percentage value which, when exceeded by any subnet, results in a notification being sent.
 
|}
 
|}
−
===IP Blocks List===
 
 
{|
 
{|
−
|style="padding: 10px 0px 15px 15px;"|You will find here any information on the blocks including:<br/><br />
+
|style="padding: 0px 0px 30px 25px;"|[[File:IPM2_31.png]]
−
'''Pool details'''
+
−
*Maximum available subnets in the block
+
−
*Number of subnets that can be generated
+
−
*Number of already generated subnets
+
−
*Number of generated and ready to be assigned subnets
+
−
*Subnets CIDR
+
−
*Available address in the subnet<br/>
+
−
'''Additional Information'''
+
−
*Nameservers
+
−
*Gateway
+
−
*:Manage the block additional information just like it was described in case of IP pools management<br/>
+
−
'''Usage'''
+
−
*Percentage graph on generated subnets
+
−
*Percentage graph on subnets assignment<br/>
+
−
'''Actions'''
+
−
*Delete button<br/>
+
 
|}
 
|}
 +
 +
====IP Addresses Cleaner====
 
{|
 
{|
−
|style="padding: 0px 0px 30px 25px;"|[[File:IPM120.1.png]]
+
|style="padding: 10px 0px 20px 15px;"|IP Addresses Cleaner allows you to restore/remove IP addresses form WHMCS/IP Manager/both depending on chosen settings.
 +
*'''IP Addresses Cleaner Settings'''
 +
*#IP address are added to hosting if relation exists.
 +
*#IP address' relation are removed if IP address is not assigned to any hosting.
 +
*#If IP address does not exist in any subnet, it is removed from hosting.
 +
*#Create IP address' relation if it does not exist.
 +
*#If IP address does not exist in any subnet, it is removed from relations.
 +
*#Set IP address as unassigned if its relation does not exist.
 +
'''Important:''' After making any changes in those settings, press '' 'Update Settings'. ''<br />
 +
Otherwise, settings will not be saved and the Cleaner will run using old ones.
 
|}
 
|}
−
====IP Block Details====
 
 
{|
 
{|
−
|style="padding: 10px 0px 20px 15px;"|Press any block to see details and move to the list of the bloc's subnets.  
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_32.png]]
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:IPM120.png]]
+
|style="padding: 0px 0px 15px 15px;"|IP Addresses Cleaner allows you to automatically find and fix broken IP addresses assignment.<br />
 +
For example, when you manually remove a product with IP addresses assigned or remove an IP pool.<br />
 +
To start IP Addresses Cleaner, press '' 'Perform Cron Cleanup' ''.<br />
 +
Actions issued by the cleaner are listed in a popup as shown on the following screen.
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 15px;"|If you do not have any subnets yet, you can generate them here.<br/>Press ''Generate Subnet'' button.  
+
|style="padding: 0px 0px 30px 25px;"|[[File:IPM24_6.png]]
 
|}
 
|}
 +
 +
===IP Reservation===
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:IPM121.png]]
+
|style="padding: 10px 0px 20px 15px;"|You can automate the process of IP assignment by adding some rules that will be then executed while assigning IP addresses from a subnet to clients or services.<br/>
 +
'' 'IP Reservation' '' rules can be configured under '' 'Settings' '' section.
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 15px;"|Enter the number of Subnets that will be generated and press '' 'Submit'. ''
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_34.png]]
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:IPM122.png]]
+
|style="padding: 0px 0px 15px 15px;"|Use the rules consciously because they will be then taken into consideration while assigning any IP from any subnet in your IP Manager.<br/>
 +
Like it is stated in the guide visible on the screen you must stick to some standards while personalizing your assignment process.<br/>
 +
Press '' 'Add New Rule'. ''
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 15px;"|Now you can see the generated subnets for that block.<br/>
+
|style="padding: 0px 0px 30px 25px;"|[[File:IPM2_35.png]]
 
|}
 
|}
 +
====New Rules====
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:IPM123.png]]
+
|style="padding: 10px 0px 20px 15px;"|To add a new rule, type in the required value in the '' 'Rule' '' field and describe it in the text box nearby.<br/>
 +
To illustrate:<br/>
 +
Enter '''n''' in the '' 'Rule' '' textarea. Then the first IP address from a subnet will be always excluded. It will be reserved and it will not be assigned to any client or service.
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 15px 15px;"|Block subnets management:<br/><br />
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_36.png]]
−
'''IP Block Details'''
+
−
#Block and its usage details
+
−
#Pool details
+
−
#Address range
+
−
#Services assigned
+
−
#Username
+
−
#Client Name
+
−
#Custom Fields
+
−
#*Press ''Create a New Custom Field'' to generate
+
−
#Available actions:
+
−
#*Assign To
+
−
#*Unassign
+
−
#*Delete<br/>
+
−
'''IP Addresses In Pool'''<br/>
+
−
#IP Address in the pool
+
−
#Full IP address
+
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 30px 25px;"|[[File:IPM124.png]]
+
|style="padding: 0px 0px 15px 15px;"|You can add more that one rule. If you do it thoughtfully, you will have much less work later on while creating new subnets because <br/>customized rules will substitute the need to fill out the '' 'Excluded IP Addresses' '' area.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:IPM2_37.png]]
 +
|}
 +
 
 +
===Default Custom Fields===
 +
{|
 +
|style="padding: 10px 0px 20px 15px;"|In this section ''('Settings' → 'Default Custom Fields')'' you are allowed to add and configure some custom fields that will be assigned to subnets by default.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_42.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|All you need to do is enter the name of your custom field, its value and save changes.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_43.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|Surely, you can create plenty of such custom fields and remove any if you no longer wish to use them.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:IPM2_44.png]]
 
|}
 
|}
  
Line 501: Line 532:
 
*'''Order 4''': Product F with addon A: 4 IP addresses assigned
 
*'''Order 4''': Product F with addon A: 4 IP addresses assigned
 
|}
 
|}
−
==Automatic IP Assignment==
+
===Automatic IP Assignment===
 
{|
 
{|
 
|style="padding: 10px 0px 15px 15px;"|The main reason, why this module has been created, was to automate IP addresses assignment.<br />
 
|style="padding: 10px 0px 15px 15px;"|The main reason, why this module has been created, was to automate IP addresses assignment.<br />
 
Here we will show you how to set up its configuration. In order to start, go to '' 'Configuration' '' → '' 'Create Configuration'. ''<br />
 
Here we will show you how to set up its configuration. In order to start, go to '' 'Configuration' '' → '' 'Create Configuration'. ''<br />
−
Type your configuration name, press textboxes corresponding to options you wish to add and select them from dropdown menus.<br />
+
Type your configuration name, press textboxes corresponding to options you wish to add and select them from dropdown menus:
−
Afterwards, press '' 'Create New Configuration' '' button. On the screen below you can see sample configuration with two products.
+
*Products
 +
*Addons
 +
*Servers
 +
*Config Options<br/>
 +
Afterwards, press '' 'Create New Configuration' '' button. On the screen below you can see sample configuration with two products selected.
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:IPM12.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_45.png]]
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 15px;"|Now you have to assign at least one IP pool to configuration. You can do it through '' 'Assigned Pools' '' or '' 'Assigned Blocs' '' button.<br/>
+
|style="padding: 0px 0px 20px 15px;"|Now you have to assign at least one subnet to configuration. Use '' 'Assigned Subnets' '' button.<br/>
−
'''''Note: It is possible to assign IPs using either pools or blocks! You are not allowed to assign both to one configuration.'''''<br/>
+
−
Let's start with Assigning pools.
+
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:IPM13.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_46.png]]
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 15px 15px;"|Next, choose an IP pool from a dropdown menu and press '' 'Add Pool' '' button.<br />
+
|style="padding: 0px 0px 15px 15px;"|Choose a subnet from a dropdown menu and press '' 'Assign Subnet' '' button.<br />
−
Keep in mind that you can assign multiple pools to a single configuration.
+
Keep in mind that you can assign multiple subnets to a single configuration.
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:IPM14.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_47.png]]
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 15px 15px;"|If you wish you can assign IP using blocks assignment. You can also assign blocks to the configuration. <br/>
+
|style="padding: 0px 0px 15px 15px;"|See the list of subnets assigned to your configuration.
−
To do so, press ''Assigned Blocks'' in the configuration.<br/>
+
*Press Subnet address to see its details
 +
*Manage additional Information: nameservers, gateway
 +
*Check usage
 +
*Remove subnet from the list
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:IPM127.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_47_1.png]]
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 15px;"|Select block from the list of available and press ''Assign A Block'' button.
+
|style="padding: 0px 0px 15px 15px;"|On pressing subnet address you will be moved to its details. There you can manage single IP addresses that are created within this subnet.<br/>
−
|}
+
 
−
{|
+
−
|style="padding: 0px 0px 20px 25px;"|[[File:IPM125.png]]
+
−
|}
+
−
{|
+
−
|style="padding: 0px 0px 20px 15px;"|Added block will appear on the list of below.<br/>
+
−
|}
+
−
{|
+
−
|style="padding: 0px 0px 20px 25px;"|[[File:IPM126.png]]
+
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 30px 15px;"|Keep in mind that you can add more than one block to a single configuration.
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_47_2.png]]
 
|}
 
|}
  
−
==Advanced Configuration==
+
===Advanced Configuration===
 
{|
 
{|
 
|style="padding: 10px 0px 15px 15px;"|Let's say, that you want to set multiple IP assignment to specific product, it is available with our module!<br />
 
|style="padding: 10px 0px 15px 15px;"|Let's say, that you want to set multiple IP assignment to specific product, it is available with our module!<br />
Line 557: Line 585:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:IPM15.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_48.png]]
 
|}
 
|}
 
{|
 
{|
Line 564: Line 592:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 30px 25px;"|[[File:IPM16.png]]
+
|style="padding: 0px 0px 30px 25px;"|[[File:IPM2_49.png]]
 
|}
 
|}
  
−
==Usage Graph==
+
====Usage Statistics====
 
{|
 
{|
 
|style="padding: 10px 0px 20px 15px;"|In each configuration you can find a graph, which shows the statistics of IP addresses assignment.
 
|style="padding: 10px 0px 20px 15px;"|In each configuration you can find a graph, which shows the statistics of IP addresses assignment.
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 30px 25px;"|[[File:IPM17.png]]
+
|style="padding: 0px 0px 30px 25px;"|[[File:IPM2_50.png]]
 
|}
 
|}
 +
 
==3rd Party Integration==
 
==3rd Party Integration==
 
{|
 
{|
 
|style="padding: 10px 0px 30px 15px;"|In this tab you can set up 3rd party integration which allows you to manage IP through our module in your WHMCS and synchronize changes on 3rd party servers.<br />
 
|style="padding: 10px 0px 30px 15px;"|In this tab you can set up 3rd party integration which allows you to manage IP through our module in your WHMCS and synchronize changes on 3rd party servers.<br />
−
''Note 1: Some of these integration submodules require free IP pools (cPanel) or IP addresses (Plesk) on servers to be set up.''<br />
+
''Note 1: Some of these integration submodules require free IP subnets (cPanel) or IP addresses (Plesk) on servers to be set up.''<br />
 
''Note 2: IP Manager can integrate multiple IP addresses with a single product.''
 
''Note 2: IP Manager can integrate multiple IP addresses with a single product.''
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_50_1.png]]
 
|}
 
|}
 
===Enabling 3rd Party Integration===
 
===Enabling 3rd Party Integration===
Line 586: Line 618:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:IPM18.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_51.png]]
 
|}
 
|}
 
{|
 
{|
 
|style="padding: 0px 0px 15px 15px;"| Press '' 'Configure' '' button and assign configurations to it.<br />
 
|style="padding: 0px 0px 15px 15px;"| Press '' 'Configure' '' button and assign configurations to it.<br />
−
Confirm through clicking '' 'Save Changes' ''.
+
Confirm through clicking '' 'Save Changes'. ''
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:IPM19.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_52.png]]
 
|}
 
|}
 
{|
 
{|
 
|style="padding: 0px 0px 15px 15px;"| cPanel and cPanel Extended additionally allow you to choose the method of the integration.<br />
 
|style="padding: 0px 0px 15px 15px;"| cPanel and cPanel Extended additionally allow you to choose the method of the integration.<br />
−
1. Creates a DNS zone for each IP address assigned to a product.<br />
+
* Creates a DNS zone for each IP address assigned to a product.
−
2. The first IP address assigned to a product is set up as a site dedicated IP address.  
+
* The first IP address assigned to a product is set up as a site dedicated IP address.  
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:IPM19_1.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_53.png]]
 
|}
 
|}
 
{|
 
{|
Line 607: Line 639:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 30px 25px;"|[[File:IPM19_2.png]]
+
|style="padding: 0px 0px 30px 25px;"|[[File:IPM2_54.png]]
 
|}
 
|}
 +
 
===Integration With Proxmox VPS/Cloud For WHMCS===
 
===Integration With Proxmox VPS/Cloud For WHMCS===
 
{|
 
{|
 
|style="padding: 10px 0px 30px 15px;"|Integration with Proxmox VPS For WHMCS & Proxmox Cloud For WHMCS are the only integrations which are set up on both IP Manager For WHMCS and integrated module sides.<br />
 
|style="padding: 10px 0px 30px 15px;"|Integration with Proxmox VPS For WHMCS & Proxmox Cloud For WHMCS are the only integrations which are set up on both IP Manager For WHMCS and integrated module sides.<br />
 
Due to that, setting up the integration consists of 3 steps:<br />
 
Due to that, setting up the integration consists of 3 steps:<br />
−
1. Create IP addresses pool which will be used for product.<br />
+
1. Create IP addresses subnet which will be used for product.<br />
−
2. Create configuration and assign a previously created pool to it. '''No additional action is required in this step.'''<br />
+
2. Create configuration and assign a previously created subnet to it. '''No additional action is required in this step.'''<br />
−
<!--3. Go to product → '' 'Module Settings' '' tab and assign a previously created configuration in '' 'IP Manager' '' section.<br /> --><br />
+
'''Important: Assigning anything beyond the Subnet to the configuration in IP Manager For WHMCS may cause unexpected effect in your WHMCS environment.'''
−
'''Important: Assigning anything beyond the IP pool to the configuration in IP Manager For WHMCS may cause unexpected effect in your WHMCS environment.'''
+
 
|}
 
|}
 
===Integration With SolusVM Extended VPS For WHMCS===
 
===Integration With SolusVM Extended VPS For WHMCS===
Line 634: Line 666:
 
|style="padding: 0px 0px 30px 25px;"|[[File:IPM19.1.png]]
 
|style="padding: 0px 0px 30px 25px;"|[[File:IPM19.1.png]]
 
|}
 
|}
 +
 
===Creation of Integration Submodule===
 
===Creation of Integration Submodule===
 
{|
 
{|
 
|style="padding: 10px 0px 15px 15px;"|You can create your own integration, all you need is knowledge of PHP programming language.<br />
 
|style="padding: 10px 0px 15px 15px;"|You can create your own integration, all you need is knowledge of PHP programming language.<br />
 
You can do it through using '' 'Autorelease' '' submodule file.<br />
 
You can do it through using '' 'Autorelease' '' submodule file.<br />
−
1. To begin, make copy of '' 'AutorelaseIntegration.php' '' located in '' 'your_whmcs/modules/addons/ipmanager2/app/modules'. ''
+
1. To begin, make copy of '' 'AutorelaseIntegration.php' '' located in '' 'your_whmcs/modules/addons/IPM2_anager2/app/modules'. ''
 
|}
 
|}
 
{|
 
{|
Line 673: Line 706:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 30px 25px;"|[[File:IPM19.6.png]]
+
|style="padding: 0px 0px 30px 25px;"|[[File:IPM2_56.png]]
 
|}
 
|}
 +
 
==Export==
 
==Export==
 
{|
 
{|
−
|style="padding: 10px 0px 15px 15px;"|You can export your IP pools to CSV and XML files.<br />
+
|style="padding: 10px 0px 15px 15px;"|You can export your subnets with IP addresses to CSV and XML files.<br />
−
To export, go to '' 'Export' '' tab, choose IP pool to export and file format.<br />
+
To export, go to '' 'Export' '' tab, choose subnet to export and output format.<br />
−
Confirm through pressing '' 'Save Changes' '' button. Download of the file will start shortly.<br />
+
Now you can '' 'Generate' '' the file. Download of the file will start shortly.<br />
−
''Note: Your '' 'storage' '' folder located in 'your_whmcs/modules/addons/ipmanager2' should have chmod set to '''755'''.''
+
''Note: Your '' 'storage' '' folder located in 'your_whmcs/modules/addons/IPM2_anager2' should have chmod set to '''755'''.''
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 30px 25px;"|[[File:IPM25.3.png]]
+
|style="padding: 0px 0px 30px 25px;"|[[File:IPM2_62.png]]
 
|}
 
|}
  
Line 690: Line 724:
 
|style="padding: 10px 0px 15px 15px;"|In '' 'Import' '' tab you can find tools to synchronize IP addresses from your WHMCS as well as import them from a file.<br />
 
|style="padding: 10px 0px 15px 15px;"|In '' 'Import' '' tab you can find tools to synchronize IP addresses from your WHMCS as well as import them from a file.<br />
 
'''Synchronization'''<br />
 
'''Synchronization'''<br />
−
Synchronization will confirm relations in your system with relations in IP Manager pools.
+
Synchronization will confirm relations in your system with relations in IP Manager subnets.
−
*IP address is used by a product, but inside of IP Manager pool is marked as unassigned - record inside of a pool will be updated.
+
*IP address is used by a product, but inside of IP Manager subnet it is marked as unassigned - record inside of a subnet will be updated.
−
*IP address is used by a product, but does not exist in any IP Manager pool - a new pool will be created.
+
*IP address is used by a product, but does not exist in any IP Manager subnet - a new subnet will be created.
 
There are three available cron commands:<br />
 
There are three available cron commands:<br />
 
1. This cron command synchronizes all products (it will require confirmation).<br />
 
1. This cron command synchronizes all products (it will require confirmation).<br />
Line 701: Line 735:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 30px 25px;"|[[File:IPM24_1.png]]
+
|style="padding: 0px 0px 30px 25px;"|[[File:IPM2_63.png]]
 
|}
 
|}
 +
 
==IP Logs==
 
==IP Logs==
 
{|
 
{|
Line 708: Line 743:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 30px 25px;"|[[File:IPM24_5.png]]
+
|style="padding: 0px 0px 30px 25px;"|[[File:IPM2_64.png]]
 
|}
 
|}
−
==Settings==
+
 
 +
 
 +
==Integration Code==
 
{|
 
{|
−
|style="padding: 10px 0px 15px 15px;"|'''Along with great power comes great responsibility.'''<br />
+
|style="padding: 10px 0px 15px 15px;"|'''Integration described below is not obligatory.'''<br />
−
IP Manager For WHMCS allows you to define its behavior, therefore make sure you configure settings that suit you needs.
+
Module allows your customers to view IP addresses assigned to their product and order additional ones.<br />
 +
To enable it, follow these simple steps:
 
|}
 
|}
 +
====Integration in WHMCS V6====
 
{|
 
{|
−
|style="padding: 0px 0px 30px 25px;"|[[File:IPM24_2.png]]
+
|style="padding: 10px 0px 20px 25px;"|[[File:IPM2_65.png]]
 
|}
 
|}
−
===Module Settings===
 
 
{|
 
{|
−
|style="padding: 10px 0px 20px 15px;"|Below, you can find description of each option.
+
|style="padding: 0px 0px 20px 15px;"|Correctly placed code is presented on the following screen.  
−
*'''Assignment Process Settings'''
+
−
*#For any configuration you provide into this field, '' 'Dedicated IP' '' field will be omitted.
+
−
*#If checked, additional IP addresses will be stored in a custom field or '' 'Assigned IPs' '' field.
+
−
*#If checked, in case of a server provisioning failure, relation will be saved.
+
−
*#Automatically process the IP address when downgrading the configurable option.
+
−
*#Module ignores error message from an external server and continues the action.
+
−
*'''IP Logs Settings'''
+
−
*#IP addresses without product or user will not be displayed in '' 'IP Logs' '' page.
+
−
*'''Email Reminder Settings'''
+
−
*#If you check this checkbox, you will receive an email with notification about IP pools running out of IP addresses.
+
−
*#Enables you to define percentage value which, when exceeded by any IP pool, results in a notification being sent.
+
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 30px 25px;"|[[File:IPM24_3.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_66.png]]
 
|}
 
|}
−
===IP Addresses Cleaner===
 
 
{|
 
{|
−
|style="padding: 10px 0px 20px 15px;"|IP Addresses Cleaner allows you to restore/remove IP addresses form WHMCS/IP Manager/both depending on chosen settings.
+
|style="padding: 0px 0px 20px 15px;"|In the client area it should look like on the screen below.
−
*'''IP Addresses Cleaner Settings'''
+
−
*#IP address are added to hosting if relation exists.
+
−
*#IP address' relation are removed if IP address is not assigned to any hosting.
+
−
*#If IP address does not exist in any IP pool, it is removed from hosting.
+
−
*#Create IP address' relation if it does not exist.
+
−
*#If IP address does not exist in any IP pool, it is removed from relations.
+
−
*#Set IP address as unassigned if its relation does not exist.
+
−
'''Important:''' After making any changes in those settings, press '' 'Update Settings'. ''<br />
+
−
Otherwise, settings will not be saved and the Cleaner will run using old ones.
+
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:IPM24_4.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_67.png]]
 
|}
 
|}
 +
====Integration in WHMCS V5====
 
{|
 
{|
−
|style="padding: 0px 0px 15px 15px;"|IP Addresses Cleaner allows you to automatically find and fix broken IP addresses assignment.<br />
+
|style="padding: 10px 0px 20px 25px;"|[[File:IPM2_68.png]]
−
For example, when you manually remove a product with IP addresses assigned or remove an IP pool.<br />
+
−
To start IP Addresses Cleaner, press '' 'Perform Cron Cleanup' ''.<br />
+
−
Actions issued by the cleaner are listed in a popup as shown on the following screen.
+
−
|}
+
−
{|
+
−
|style="padding: 0px 0px 30px 25px;"|[[File:IPM24_6.png]]
+
−
|}
+
−
==Integration Code==
+
−
{|
+
−
|style="padding: 10px 0px 15px 15px;"|'''Integration described below is not obligatory.'''<br />
+
−
Module allows your customers to view IP addresses assigned to their product and order additional ones.<br />
+
−
To enable it, follow these simple steps:
+
−
|}
+
−
{|
+
−
|style="padding: 0px 0px 20px 25px;"|[[File:IPM_49.png]]
+
 
|}
 
|}
 
{|
 
{|
Line 774: Line 777:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:IPM_50.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_69.png]]
 
|}
 
|}
 
{|
 
{|
Line 780: Line 783:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:IPM_51.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_70.png]]
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 15px;"|To allow your customers to buy a new IP address you need to set up a product addon for product and assign the addon to a configuration in IP Manager.
+
|style="padding: 10px 0px 20px 15px;"|To allow your customers to buy a new IP address you need to set up a product addon for product and assign the addon to a configuration in IP Manager.
 
|}
 
|}
 
{|
 
{|
Line 791: Line 794:
 
   &lt;div class="moduleoutput"&gt;;{$moduleclientarea|replace:'modulebutton':'btn'}
 
   &lt;div class="moduleoutput"&gt;;{$moduleclientarea|replace:'modulebutton':'btn'}
 
   {if $pid == 26 || $module ==  'proxmoxCloud' || $module == 'proxmoxVPS'}
 
   {if $pid == 26 || $module ==  'proxmoxCloud' || $module == 'proxmoxVPS'}
−
         {$ipmanager_integration}
+
         {$IPM2_anager_integration}
 
   {/if}
 
   {/if}
 
   &lt;/div&gt;
 
   &lt;/div&gt;
Line 800: Line 803:
 
|style="padding: 0px 0px 30px 15px;"|Once such code is inserted in the template, IP Manager will be displayed for product with ID that equals 26 or if the product is based on '' 'proxmoxCloud/proxmoxVPS' '' modules.<br/> Extend the IP Manager integration according to your needs. The above code is just an example which can undergo modifications.  
 
|style="padding: 0px 0px 30px 15px;"|Once such code is inserted in the template, IP Manager will be displayed for product with ID that equals 26 or if the product is based on '' 'proxmoxCloud/proxmoxVPS' '' modules.<br/> Extend the IP Manager integration according to your needs. The above code is just an example which can undergo modifications.  
 
|}
 
|}
 +
 
==Client Area==
 
==Client Area==
 
{|
 
{|
−
|style="padding: 10px 0px 15px 15px;"|Your clients can view and manage their IP addresses owing to IP Manager For WHMCS.<br />
+
|style="padding: 10px 0px 15px 15px;"|Your clients can view and manage their IP addresses and subnets thanks to installed IP Manager For WHMCS module.<br />
−
To remove an IP address from a product, press '' 'Unassign'. ''
+
To remove any IP address or subnet from a product, simply press '' 'Unassign' '' button.
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:IPM_52.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_71.png]]
 
|}
 
|}
 
{|
 
{|
Line 814: Line 818:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:IPM_53.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_72.png]]
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 15px;"|As soon as the addon is active, new IP address is granted.
+
|style="padding: 0px 0px 30px 15px;"|As soon as the addon is active, new IP address is granted.
−
|}
+
−
{|
+
−
|style="padding: 0px 0px 30px 25px;"|[[File:IPM_54.png]]
+
 
|}
 
|}
 +
 
==Add IP via Addon==
 
==Add IP via Addon==
 
{|
 
{|
Line 828: Line 830:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:IPM_55.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_74.png]]
 
|}
 
|}
 
{|
 
{|
Line 836: Line 838:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:IPM_56.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_75.png]]
 
|}
 
|}
 
{|
 
{|
Line 844: Line 846:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:IPM_57.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_76.png]]
 
|}
 
|}
 
{|
 
{|
Line 851: Line 853:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:IPM_58.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:IPM2_77.png]]
 
|}
 
|}
 
{|
 
{|
Line 877: Line 879:
 
|style="padding: 0px 0px 30px 25px;"|[[File:IPM_59.png]]
 
|style="padding: 0px 0px 30px 25px;"|[[File:IPM_59.png]]
 
|}
 
|}
 +
 
==How To Update==
 
==How To Update==
 
{|
 
{|
 
|style="padding: 10px 0px 30px 15px;"|In order to upgrade your module, follow [[Modules_Update|Modules Update]] article.
 
|style="padding: 10px 0px 30px 15px;"|In order to upgrade your module, follow [[Modules_Update|Modules Update]] article.
 
|}
 
|}
 +
 
=Tips=
 
=Tips=
 
{|
 
{|
−
|style="padding: 10px 0px 30px 15px;"|1. If your client orders a product bonded to two configurations (e.g. by product type and configurable option), IP Manager will add IP addresses from both configurations.
+
|style="padding: 10px 0px 15px 15px;"|1. If your client orders a product that is combined with two configurations (e.g. by product type and configurable option), IP Manager will add IP addresses from both configurations.
 
|}
 
|}
 +
{|
 +
|style="padding: 0px 0px 30px 15px;"|2. If you have used IPv6 block before the update to IP Manager 2.2.0, all of them will be migrated to corresponding subnets. Note that migration is done automatically for you.
 +
|}
 +
 
=Common Problems=
 
=Common Problems=
 
{|
 
{|
Line 896: Line 904:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 30px 15px;"|3. If you export file and it is empty, check your '' 'Storage' '' folder chmod, it should be set to '''755'''. Folder is located in '' 'your_whmcs/modules/addons/ipmanager2' ''.<br />
+
|style="padding: 0px 0px 30px 15px;"|3. If you export file and it is empty, check your '' 'Storage' '' folder chmod, it should be set to '''755'''. Folder is located in '' 'your_whmcs/modules/addons/IPM2_anager2' ''.<br />
 
If you still have that problem, set chmod '''777'''.  
 
If you still have that problem, set chmod '''777'''.  
 
|}
 
|}

Revision as of 17:27, 10 December 2015

Contents

About IP Manager For WHMCS

IP Manager For WHMCS allows you to conveniently add and manage IP subnet, and automatically assign IP addresses to your servers, products, addons or configurable options.

With our module you will be also able to assign an IP subnet to a specified client, integrate with 3rd party applications like cPanel, export IP subnets or view clear graphs.
You will also be able to synchronize IP addresses used by products in your WHMCS system with the module's IP subnets.
What is more, IP Manager For WHMCS will allow your customers to easily manage their IP addresses from the WHMCS client area.

  • Admin Area Features:
✔ Create Multiple Configurations For Multiple Scenarios Of IP Addresses Assignment
✔ Create Multiple Relations In One Configuration For Products, Addons, Configurable Options & Servers
✔ Add IP Pools:
✔ CIDR Notation
✔ IP Addresses Range (IPv4 Only)
✔ IP Addresses List (IPv4 Only)
✔ Add IPv6 Block In CIDR Notation
✔ Export IP Pools To XML And CSV Format
✔ Import IP Pools From XML And CSV Files
✔ Synchronize IP Addresses Used By Products In WHMCS With IP Manager
✔ Exclude Selected IP Addresses From IP Pool During Its Creation
✔ Integrate With 3rd Party Applications:
✔ cPanel
✔ cPanel Extended
✔ Plesk
✔ Parallels Cloud Server
✔ SolusVM Extended VPS
✔ Proxmox VPS
✔ Create New Integration Modules
✔ Assign/Unassign IP Addresses From IP Pool For Specified Client Service
✔ Omit Dedicated IP Address Fields For Specific Configuration
✔ Define Custom Field Usage
✔ Receive Automatic Email Reminder Sent When Specified Usage Percentage Of Any IP Pool Has Been Exceeded
✔ Define Configuration Of Integration Method (cPanel & cPanel Extended)
✔ Set Up IP Addresses Cleaner - Ensures That All Assigned IP Addresses Are In Use
✔ View IP Pool Usage Statistics And Graphs
✔ View Logs
  • IP Pool Features:
✔ Lock IP Pool To Client
✔ Filter Data In IP Addresses List
✔ View IP Addresses Of IP Pool
✔ Delete Single IP Address From Pool
✔ Bulk Actions - Assign/Unassign/Delete IP Addresses
✔ Create Custom Fields For IP Pool Or IP Address
✔ Generate Free IP Addresses
  • IP Block Features:
✔ View IP Pools Of Block
✔ View IP Addresses Of IP Pool
✔ Assign/Unassign/Delete Any IP Pool
✔ Create Custom Fields For IP Pools
✔ Generate Free IP Pools
  • Client Area Features:
✔ View Assigned IP Addresses
✔ Unassign IP Addresses
✔ Order Additional IP Addresses
  • General Info:
✔ Supports IPv4 and IPv6
✔ Supported All Types Of Configurable Options
✔ IPv6 Pools Relying On IP Addresses Range And Assigned IP Addresses (Free IPv6 Addresses Are Not Stored In Database)
✔ Block Assignment Of IP Addresses For IPv6
✔ Multi-Language Support
✔ Supports WHMCS Templates Five and Six
✔ Supports WHMCS V5 and V6

Installation

This tutorial will show you how to successfully install and configure IP Manager For WHMCS.

We will guide you step by step through the whole installation and configuration process.

1. Log in to your client area and download IP Manager For WHMCS.
File:IPM2 1.png
2. Upload and extract the module into the main WHMCS directory.

Files in your WHMCS directory should look like this.

IPM2.png
3. When you install IP Manager for the first time, you have to rename 'license_RENAME.php' file.

File is located in 'modules/addons/IPM2_anager2/license_RENAME.php'. Rename it from 'license_RENAME.php' to 'license.php'.

IPM3.png
4. In order to configure your license key, you have to edit a previously renamed 'license.php' file.

Enter your license key between quotation marks as presented on the following screen. You can find your license key in your client area → 'My Products'.

IPM4.png
5. Remove all files from 'tempates_c' folder located in your WHMCS root directory.
6. Now, you have to activate the module in your WHMCS system.

Log in to your WHMCS admin area and go to 'Setup' → 'Addon Modules'.
Afterwards, find 'IP Manager' and press 'Activate' button.

IPM2 5.png
7. In the next step you need to permit the access to the module.

Click on 'Configure' button, tick desired admin roles and press 'Save Changes'.

IPM2 6.png
8. The last step is setting chmod 755 to 'storage' folder.

Folder is located in 'you_whmcs/modules/addons/IPM2_anager2'.

IPM6.1.png
9. You have just successfully installed IP Manager!

You can access your module in 'Addons' → 'IP Manager'.

IPM2 7.png

Configuration and Management

IP Manager For WHMCS allows you to manage dedicated IP addresses' pools, automatically assign them to clients/products/servers/addons/configurable options.

IP Manager supports both IPv4 and IPv6.
Module enables clients to manage and order dedicated IP addresses.
In this short guide we will present you the possibilities of our module.

Subnets

To manage any Subnet via IP Manager you have to add it first.

Remember that it is very important to configure any IP reservation rules before you create any subnets. If you add rules later on, they may not work properly!
Read about rules reservation [LINK DO RUKLI here.]

To add a new subnet press 'Create New Subnet' and follow further instructions.

Create Subnet

To begin, add a new IP addresses subnet, press 'Create New Subnet' button.
IPM2 8.png
'Classless Inter-Domain Routing (CIDR)' can be used to add subnets.

First of all, select IP version: IPv4 or IPv6, type the subnet IP address and a correct bitmask.
Correct ranges:

  • IPv4 - 1 to 32
  • IPv6 - 1 to 128

Note: The first IP from the subnet should be compatible with CIDR notation.

IPM2 9.png
You can exclude any number of IP addresses from the pool.

To do so, enter them into 'Excluded IP Addresses:' textarea, one IP address or IP range per line.

IPM2 10.png
If you want to set nameservers and gateway click on 'Toggle Advanced Settings'.

Enter nameservers and gateway address into textboxes as shown on the screen below (This step is optional).
Afterwards, confirm the creation of an IP pool through pressing 'Add Subnet' button.

IPM2 11.png

Available IP Subnets and Child-Subnets

Once you have added some IP pools you can preview some details on them and manage the IP addresses.

As you can see on the following screen, you can find here a list of Subnets in a tree view. Press any of added IP subnets to see its details.

IPM2 13.png

Subnet

To view subnet's details press on its address as shown on the following screen.
IPM2 14.png
In 'Subnet ' field, you can find information about the address, mask, size, nameservers, gateway and many others.
IPM2 15.png

Bulk Actions

The most important functions of your IP Manager For WHMCS include some actions that can done on subnets.
  • Delete - use it to remove the subnet together with any IP address in it (if there are such already).
  • Split - select split to divide the subnet into equal subnets according to the chosen mask. Keep in mind that the subnet may already include some assigned IP addresses.
    If you split such a subnet, the assigned IPs might be transferred to another subnet.
  • Merge - use this option if you want to join previously split subnet. Note that you can merge only parallel subnets.

Additionally, you must remember that merge action removes IP addresses from external servers.

  • Create Child Subnet - this option allows to create subnet within a 'parent' subnet.
    Such child subnet may again be slit/merged, have its own child subnets.
IPM2 17.png

Excluded IP Addresses

List of excluded IP addresses. You can remove some addresses from the list or add new ones.

Important! If you have any IP reservation rules set up, then do not include singe IP addresses here. This option should be used as an addition if you do not use rules.

IPM2 18.png

Custom Fields

IP Manager allows you to add custom fields per subnet.

To add a new custom field, press 'Create New Custom Field'. Afterwards, fill out the form with custom field name and value.
Again, this option should be used if you do not specify default custom fields or if you want to add some additional ones. Be careful and do not double custom fields here.

IPM2 19.png

Assigned Client/Service

If you wish to assign an IP pool to a client or specific service, our module makes it available to you.

You can achieve that through using auto-complete textbox to choose the client and/or service. Again, remember to 'Save Changes'.
Notes:
 IP addresses will be added to all products ordered by client.
IP addresses will be added to all addons included in products.

IPM2 20.png
Keep in mind that a subnet that is assigned to a client is reserved for this client only.

While IP addresses are assigned to a client, the following aspect s are taken into consideration (in this order):

  • subnets assigned to a hosting
  • subnets assigned to a client
  • subnets assigned to configuration.

IP Addresses List

The easiest possible way of creating IP addresses within the created subnet.

Simply press 'Create IP Address' and a new address in the subnet will be generated.

IPM2 21.png
Once the address is generated, you can proceed to its assignment.

Use action buttons to do do so.

IPM2 22.png

Assign Single IP Address

You are now redirected to a page where you can assign this specific IP address to a service by entering a domain or a username,
using 3rd party integration module or custom assignment.
IPM2 23.png
Choose the method you wish to use and save the changes.
IPM2 24.png
As you can see, IP address is assigned to selected previously service (related to chosen domain).
You may always unassign this IP from this service and again assign it to another one, delete the IP address, create custom field for this single address.
IPM2 25.png

Tree View

To clarify, a comfortable tree view of your created subnets and child-subnets is available. Let's take a look at it to summarize the divisions.
IPM2 26.png
You can see here a list of all subnets and child subnets in your IP Manager. Subnets marked with red already have some child subnets created, press any to show the list of child subnets.
Accordingly available actions change.
IPM2 27.png
Any subnet can have child subnets created (with IP reservation rules taken into consideration) and custom fields assigned.
IPM2 28.png
Child subnets, however, can again have their child subnets created, can be split, merged or deleted.

You may also manually exclude some IP addresses from a child subnet, assign clients and services directly to it and finally manage single IP addresses in such subnet.

Settings

Along with great power comes great responsibility.

IP Manager For WHMCS allows you to define its behavior, therefore make sure you configure settings that suit you needs.

Show Settings

Module Settings

Below, you can find description of each option.
  • Assignment Process Settings
    1. For any configuration you provide into this field, 'Dedicated IP' field will be omitted.
    2. If checked, additional IP addresses will be stored in a custom field or 'Assigned IPs' field.
    3. If checked, in case of a server provisioning failure, relation will be saved.
    4. Automatically process the IP address when downgrading the configurable option.
    5. Module ignores error message from an external server and continues the action.
  • IP Logs Settings
    1. IP addresses without product or user will not be displayed in 'IP Logs' page.
  • IP Reservation Settings
    1. If you check this checkbox, you will allow to add IP reservation rules.
  • Email Reminder Settings
    1. If you check this checkbox, you will receive an email with notification about IP subnets running out of IP addresses.
    2. Enables you to define percentage value which, when exceeded by any subnet, results in a notification being sent.
IPM2 31.png

IP Addresses Cleaner

IP Addresses Cleaner allows you to restore/remove IP addresses form WHMCS/IP Manager/both depending on chosen settings.
  • IP Addresses Cleaner Settings
    1. IP address are added to hosting if relation exists.
    2. IP address' relation are removed if IP address is not assigned to any hosting.
    3. If IP address does not exist in any subnet, it is removed from hosting.
    4. Create IP address' relation if it does not exist.
    5. If IP address does not exist in any subnet, it is removed from relations.
    6. Set IP address as unassigned if its relation does not exist.

Important: After making any changes in those settings, press 'Update Settings'.
Otherwise, settings will not be saved and the Cleaner will run using old ones.

IPM2 32.png
IP Addresses Cleaner allows you to automatically find and fix broken IP addresses assignment.

For example, when you manually remove a product with IP addresses assigned or remove an IP pool.
To start IP Addresses Cleaner, press 'Perform Cron Cleanup' .
Actions issued by the cleaner are listed in a popup as shown on the following screen.

IPM24 6.png

IP Reservation

You can automate the process of IP assignment by adding some rules that will be then executed while assigning IP addresses from a subnet to clients or services.

'IP Reservation' rules can be configured under 'Settings' section.

IPM2 34.png
Use the rules consciously because they will be then taken into consideration while assigning any IP from any subnet in your IP Manager.

Like it is stated in the guide visible on the screen you must stick to some standards while personalizing your assignment process.
Press 'Add New Rule'.

IPM2 35.png

New Rules

To add a new rule, type in the required value in the 'Rule' field and describe it in the text box nearby.

To illustrate:
Enter n in the 'Rule' textarea. Then the first IP address from a subnet will be always excluded. It will be reserved and it will not be assigned to any client or service.

IPM2 36.png
You can add more that one rule. If you do it thoughtfully, you will have much less work later on while creating new subnets because
customized rules will substitute the need to fill out the 'Excluded IP Addresses' area.
IPM2 37.png

Default Custom Fields

In this section ('Settings' → 'Default Custom Fields') you are allowed to add and configure some custom fields that will be assigned to subnets by default.
IPM2 42.png
All you need to do is enter the name of your custom field, its value and save changes.
IPM2 43.png
Surely, you can create plenty of such custom fields and remove any if you no longer wish to use them.
IPM2 44.png

IP Assignment Mechanism

It is crucial to understand mechanism of automatic IP addresses assignment. In this section we will clarify it to you.

'IP Quantity' field defines the quantity of IP addresses added to the ordered product by triggering a specific relation.
Two and more relations from one configuration can be triggered for the same product (therefore, multiple quantity of IP addresses can be assigned).
Additionally, if you set up two configurations with the same relation, IP addresses from both configurations will be added.
Therefore, if you set up these two configurations in IP Manager:

  • Configuration 1: Addon A (IP Quantity = 2), Product C (IP Quantity = 1)
  • Configuration 2: Addon A (IP Quantity = 2), Addon B (IP Quantity = 2), Product D (IP Quantity = 3)

Orders listed below will trigger different relations:

  • Order 1: Product C with addon A: 5 IP addresses assigned
  • Order 2: Product C with addon B: 3 IP addresses assigned
  • Order 3: Product D with addon A: 7 IP addresses assigned
  • Order 4: Product F with addon A: 4 IP addresses assigned

Automatic IP Assignment

The main reason, why this module has been created, was to automate IP addresses assignment.

Here we will show you how to set up its configuration. In order to start, go to 'Configuration' → 'Create Configuration'.
Type your configuration name, press textboxes corresponding to options you wish to add and select them from dropdown menus:

  • Products
  • Addons
  • Servers
  • Config Options

Afterwards, press 'Create New Configuration' button. On the screen below you can see sample configuration with two products selected.

IPM2 45.png
Now you have to assign at least one subnet to configuration. Use 'Assigned Subnets' button.
IPM2 46.png
Choose a subnet from a dropdown menu and press 'Assign Subnet' button.

Keep in mind that you can assign multiple subnets to a single configuration.

IPM2 47.png
See the list of subnets assigned to your configuration.
  • Press Subnet address to see its details
  • Manage additional Information: nameservers, gateway
  • Check usage
  • Remove subnet from the list
IPM2 47 1.png
On pressing subnet address you will be moved to its details. There you can manage single IP addresses that are created within this subnet.
IPM2 47 2.png

Advanced Configuration

Let's say, that you want to set multiple IP assignment to specific product, it is available with our module!

Here we will show you how to set up multiple IP addresses assignment to configurable option 'Extra IP Addresses'.
Create a new configuration as while setting up a standard configuration.
Once it is done press 'Configurable Options' as shown on the screen below.

IPM2 48.png
Afterwards, mark checkboxes next to configurable options you want to assign IP addresses to.

Enter quantity of IP addresses which will be assigned to each configurable option and press 'Save Changes'.

IPM2 49.png

Usage Statistics

In each configuration you can find a graph, which shows the statistics of IP addresses assignment.
IPM2 50.png

3rd Party Integration

In this tab you can set up 3rd party integration which allows you to manage IP through our module in your WHMCS and synchronize changes on 3rd party servers.

Note 1: Some of these integration submodules require free IP subnets (cPanel) or IP addresses (Plesk) on servers to be set up.
Note 2: IP Manager can integrate multiple IP addresses with a single product.

IPM2 50 1.png

Enabling 3rd Party Integration

Activation of all integration modules looks similar, there is only a difference in cPanel and cPanel Extended integration submodules.

Start by pressing 'Activate' button next to a module you want to activate.

IPM2 51.png
Press 'Configure' button and assign configurations to it.

Confirm through clicking 'Save Changes'.

IPM2 52.png
cPanel and cPanel Extended additionally allow you to choose the method of the integration.
  • Creates a DNS zone for each IP address assigned to a product.
  • The first IP address assigned to a product is set up as a site dedicated IP address.
IPM2 53.png
As you can see on the following screen, you can easily check the quantity of configurations assigned to each 3rd party integration.
IPM2 54.png

Integration With Proxmox VPS/Cloud For WHMCS

Integration with Proxmox VPS For WHMCS & Proxmox Cloud For WHMCS are the only integrations which are set up on both IP Manager For WHMCS and integrated module sides.

Due to that, setting up the integration consists of 3 steps:
1. Create IP addresses subnet which will be used for product.
2. Create configuration and assign a previously created subnet to it. No additional action is required in this step.
Important: Assigning anything beyond the Subnet to the configuration in IP Manager For WHMCS may cause unexpected effect in your WHMCS environment.

Integration With SolusVM Extended VPS For WHMCS

Integration with SolusVM Extended VPS For WHMCS is tricky.

IP Manager For WHMCS cannot inject the first IP address to VPS, due to the way SolusVM API works.
After creation of VPS, IP Manager is able to add additional IP addresses.
Therefore, if you are using this integration, we advise setting up IP Manager synchronization as a cron job.

Test Integration Module

This module logs information about IP processing for 'Autorelease' type products.

Your order should look similar to the one on the screen below.
Note: You need to set up 'Autorelease' type server, otherwise logs will not show up.

IPM19.1.png

Creation of Integration Submodule

You can create your own integration, all you need is knowledge of PHP programming language.

You can do it through using 'Autorelease' submodule file.
1. To begin, make copy of 'AutorelaseIntegration.php' located in 'your_whmcs/modules/addons/IPM2_anager2/app/modules'.

IPM19.2.png
2. Rename copy to your new submodule name.

Note: File name has to end with 'Integration', for example 'NewSubmoduleIntegration.php'.

IPM19.3.png
3. Edit the file, start by entering basic settings. 
1. Class name should be the same as the file name.
2. Submodule name visible in IP Manager.
3. Submodule description displayed in IP Manager.
4. Place here an integrating module name ( the best way is to copy a folder name of the module ).
IPM19.4.png
4. Now, it is time to implement integration part, you will need integrated module documentation to do that. 
1. Configuration of 3rd party integration submodule.
2. Code assigning IP address to module product goes here.
3. You can add a code to unassign IP address here.
IPM19.5.png
4. In order to view a submodule you have just created, log in to your WHMCS and go to 'Addons' → 'IP Manager' → '3rd Party Integration'.
IPM2 56.png

Export

You can export your subnets with IP addresses to CSV and XML files.

To export, go to 'Export' tab, choose subnet to export and output format.
Now you can 'Generate' the file. Download of the file will start shortly.
Note: Your 'storage' folder located in 'your_whmcs/modules/addons/IPM2_anager2' should have chmod set to 755.

IPM2 62.png

Import

In 'Import' tab you can find tools to synchronize IP addresses from your WHMCS as well as import them from a file.

Synchronization
Synchronization will confirm relations in your system with relations in IP Manager subnets.

  • IP address is used by a product, but inside of IP Manager subnet it is marked as unassigned - record inside of a subnet will be updated.
  • IP address is used by a product, but does not exist in any IP Manager subnet - a new subnet will be created.

There are three available cron commands:
1. This cron command synchronizes all products (it will require confirmation).
2. This cron command synchronizes all products (it will not require any confirmation).
3. This cron command synchronizes only products which IDs have been provided as arguments separated by comma.
Import
To import IP addresses from a file, select it, choose its format and press 'Import'.

IPM2 63.png

IP Logs

'Logs' page stores the history of actions ordered on each IP address.
IPM2 64.png


Integration Code

Integration described below is not obligatory.

Module allows your customers to view IP addresses assigned to their product and order additional ones.
To enable it, follow these simple steps:

Integration in WHMCS V6

IPM2 65.png
Correctly placed code is presented on the following screen.
IPM2 66.png
In the client area it should look like on the screen below.
IPM2 67.png

Integration in WHMCS V5

IPM2 68.png
Correctly placed code is presented on the following screen.
IPM2 69.png
In the client area it should look like on the screen below.
IPM2 70.png
To allow your customers to buy a new IP address you need to set up a product addon for product and assign the addon to a configuration in IP Manager.
The above described integration works for all products without exception.
However, in case you wish to restrict the integration to limited number of products, please insert the below codes instead of the one suggested in the addon. 

{if $moduleclientarea}
  <div class="moduleoutput">;{$moduleclientarea|replace:'modulebutton':'btn'}
  {if $pid == 26 || $module ==  'proxmoxCloud' || $module == 'proxmoxVPS'}
       {$IPM2_anager_integration}
  {/if}
  </div>
{/if}

Once such code is inserted in the template, IP Manager will be displayed for product with ID that equals 26 or if the product is based on 'proxmoxCloud/proxmoxVPS' modules.
Extend the IP Manager integration according to your needs. The above code is just an example which can undergo modifications.

Client Area

Your clients can view and manage their IP addresses and subnets thanks to installed IP Manager For WHMCS module.

To remove any IP address or subnet from a product, simply press 'Unassign' button.

IPM2 71.png
Your client can also order a new IP address.

Press 'Order Additional IP Addresses' as shown below.
Your client will be moved to order form containing previously configured addons.

IPM2 72.png
As soon as the addon is active, new IP address is granted.

Add IP via Addon

Setting up an addon allows your client to add an IP address to their product using integration.

Go to 'Setup' → 'Products/Services' → 'Product Addons' and press 'Add New Addon' .

IPM2 74.png
Afterwards, enter addon name, addon description and select applicable products.

Set pricing for addon by choosing 'Billing Cycle' and typing price.
Confirm through pressing 'Save Changes' button.

IPM2 75.png
Now, go to 'Addons' → 'IP Manager' and use configuration created before or create a new one.

Remember to add a previously created addon as a configuration relation.
You can do it by pressing 'Addon' button as shown on the following screen.

IPM2 76.png
Tick checkbox next to addon and enter the quantity of IP addresses to be added.

Afterwards, click 'Save Changes' button.

IPM2 77.png
If you enabled integration for the client area, your client should be able to order new IP addresses.

Management of Custom Hooks

Our module allows you to use custom hooks. All you have to do is create some functions using PHP programming language.

Here you can see possible hooks: 

before_ip_assign_hook($ip, $serviceid, $relation, $configid)
after_ip_assign_hook($ip, $serviceid, $relation, $configid)
before_ip_integrating_hook($ip, $service, $server)
after_ip_integrating_hook($ip, $service, $server)
before_ip_disintegrating_hook($ip, $service, $server)
after_ip_disintegrating_hook($ip, $service, $server)
To find details about hooks read 'custom_hooks.php' file.

You can find there all hooks, information about their time of run, returned values and parameters.
For example, if you want to throw message to activity log after IP address assignment find hook 'after_ip_assign_hook($ip, $serviceid, $relation, $configid)' and type: 

Logger::factory()->log('Custom hook was triggered');

It should look like on the screen below:

IPM 59.png

How To Update

In order to upgrade your module, follow Modules Update article.

Tips

1. If your client orders a product that is combined with two configurations (e.g. by product type and configurable option), IP Manager will add IP addresses from both configurations.
2. If you have used IPv6 block before the update to IP Manager 2.2.0, all of them will be migrated to corresponding subnets. Note that migration is done automatically for you.

Common Problems

1. When you have problems with connection, check whether your SELinux or firewall does not block ports.
2. If you see something like this when moving to 'Addon' → 'IP Manager', remove content of 'template_c' folder.
IPM 60.png
3. If you export file and it is empty, check your 'Storage' folder chmod, it should be set to 755. Folder is located in 'your_whmcs/modules/addons/IPM2_anager2' .

If you still have that problem, set chmod 777.

Retrieved from "https://www.docs.modulesgarden.com/index.php?title=IP_Manager_For_WHMCS&oldid=22086"
Navigation
WHMCS Modules
WHMCS Widgets
Tools And Applications
Translations
General
FAQ
Community
IP Manager For WHMCS