Revision as of 13:15, 9 November 2012 (view source) Andrew (talk | contribs) m ← Older edit		Latest revision as of 15:54, 10 January 2023 (view source) PeterM (talk | contribs)
(11 intermediate revisions by 2 users not shown)
Line 1:		Line 1:
		+	== About this Module ==
		+
		+	The InterWorx module allows you to add and manage InterWorx servers in WHMCS.
	{{Provisioning_Module		{{Provisioning_Module
	| changepackage = Yes		| changepackage = Yes
Line 5:		Line 8:
	| clientarealink = Yes		| clientarealink = Yes
	| port = 2443}}		| port = 2443}}
		+	== Adding an InterWorx Server ==
		+
		+	To set up an InterWorx server in WHMCS:
		+
		+	# Make certain that your server's PHP complication includes SOAP.
		+	#* You can check this at '''Utilities > System > [[PHP Info]]'''.
		+	#* WHMCS Technical Support cannot assist with recompiling PHP. For help, contact your system administrator or hosting provider.
		+	# Go to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Servers]]''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Servers'''.
		+	# Click '''Add New Server'''.
		+	# Select ''InterWorx'' from the menu.
		+	# Enter the hostname or IP address.
		+	# Enter a username and password or access hash.
		+	# Click '''Continue'''.
		+	# Enter the desired additional server information.
		+	# Examine the displayed default port. If your server uses a different port, check '''Override with Custom Port''' and enter the correct port. For more information, see [[Server Port Overrides]].
		+	# Click '''Save Changes'''.
		+	# If this is the only InterWorx server that is currently in WHMCS, click on the name and ensure that it results in an asterisk (*) next to it. This indicates that it is the default to use when any other non-specific configuration doesn't apply.
−	==Important Notes==	+	=== Creating an InterWorx Product ===
		+
		+	You can create a product that provisions accounts on your InterWorx server at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Products_and_Services|Products/Services]]''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Products/Services'''.
−	With InterWorx, a key is used for communicating with the API. Therefore when configuring an InterWorx server inside WHMCS, all you need to do is enter the API Key into the Access Hash field. Username and password are not required.	+	=== WHMCS Connect ===
−	Packages are then configured by entering the package name as it appears in InterWorx and the theme to set as the default for the new account. Both the package name and theme name should be entered all in lowercase or it will result in errors occuring.	+	This module does not support [[WHMCS Connect]].
−	'''If WHMCS is installed on the same InterWorx server that you will be setting up accounts on...'''	+	==Troubleshooting==
−	When as part of the account creation process InterWorx restarts apache, it will kill the WHMCS process, causing a problem.  To prevent that, edit /usr/local/interworx/iworx.ini, and change the line	+	===WHMCS is installed on the InterWorx server===
−	force_graceful="0"	+	When as part of the account creation process InterWorx restarts apache, therefore if WHMCS is installed on the same server upon which the account is being provisioned, it will kill the WHMCS process causing a problem.
−	to	+	To prevent that, adjust the [https://appendix.interworx.com/current/user_guide/nodeworx-webserver-guide.html#web-server-options InterWorx Webserver Settings] so '''Force Graceful Restart''' is ''On''.
−	force_graceful="1"
		+	<div class="docs-alert-info">
		+	When a user clicks '''Log in to SiteWorx''' in the Client Area, the system uses the email address on the [[Clients:Profile_Tab|client's profile]] in conjunction with the password of the [[Clients:Products/Services_Tab|client's service]]. When [[Migration_Guide#Adding_Services|manually importing services]], ensure the client's email address in WHMCS matches the email address for the account in InterWorx.
		+	</div>
	{{modules}}		{{modules}}

---

Latest revision as of 15:54, 10 January 2023

About this Module

The InterWorx module allows you to add and manage InterWorx servers in WHMCS.

Supported Features

Create	Suspend	Unsuspend	Terminate
Yes	Yes	Yes	Yes

Change Package	Change Password	Usage Updates	Client Area Link
Yes	Yes	Yes	Yes

The following ports should be open for outbound connections from your WHMCS server: 2443

Adding an InterWorx Server

To set up an InterWorx server in WHMCS:

1. Make certain that your server's PHP complication includes SOAP.
   • You can check this at Utilities > System > PHP Info.
   • WHMCS Technical Support cannot assist with recompiling PHP. For help, contact your system administrator or hosting provider.
2. Go to Configuration () > System Settings > Servers or, prior to WHMCS 8.0, Setup > Products/Services > Servers.
3. Click Add New Server.
4. Select InterWorx from the menu.
5. Enter the hostname or IP address.
6. Enter a username and password or access hash.
7. Click Continue.
8. Enter the desired additional server information.
9. Examine the displayed default port. If your server uses a different port, check Override with Custom Port and enter the correct port. For more information, see Server Port Overrides.
10. Click Save Changes.
11. If this is the only InterWorx server that is currently in WHMCS, click on the name and ensure that it results in an asterisk (*) next to it. This indicates that it is the default to use when any other non-specific configuration doesn't apply.

Creating an InterWorx Product

You can create a product that provisions accounts on your InterWorx server at Configuration () > System Settings > Products/Services or, prior to WHMCS 8.0, Setup > Products/Services > Products/Services.

WHMCS Connect

This module does not support WHMCS Connect.

Troubleshooting

WHMCS is installed on the InterWorx server

When as part of the account creation process InterWorx restarts apache, therefore if WHMCS is installed on the same server upon which the account is being provisioned, it will kill the WHMCS process causing a problem.

To prevent that, adjust the InterWorx Webserver Settings so Force Graceful Restart is On.