Page tree
Skip to end of metadata
Go to start of metadata

 

Description

This function extends one-time licenses for one year.

Examples 


 Browser-based Calls
XML
https://manage2.cpanel.net/XMLonetimeext.cgi?ip=127.0.0.1
JSON
https://manage2.cpanel.net/XMLonetimeext.cgi?output=json&ip=127.0.0.1
YAML
https://manage2.cpanel.net/XMLonetimeext.cgi?output=yaml&ip=127.0.0.1
 cPanel Licensing PHP Class
<?php
include("cpl.inc.php");
$cpl = new cPanelLicensing("barney@example.com","12345luggage");
$lisc = $cpl->extendOnetime(array( "ip" => "127.0.0.11" ) );
?>
 cPanel Licensing Perl Module
use cPanelLicensing;
my $licenseManager = new cPanelLicensing(user => 'barney\@example.com', pass => '12345luggage'); 
$licenseManager->extend_onetime_updates (
	'ip' => '127.0.0.1'
);
 Output (JSON)
{
  "version": 0.1,
  "status": 0,
  "reason": "Dispatched notification Updates have been extended for the license on 
ip: 127.0.0.11. The old updates experiation time was: Mon Jul 11 
03:27:02 2011 GMT. The new updates expiration time is: Tue Jul 10 
03:27:02 2012 GMT. If your updates have already expired, you should run 
/usr/local/cpanel/cpkeyclt to reenable updates."
}
 Output (XML)
<XMLonetimeext reason="
 Dispatched notification Updates have been extended for the license on 
ip: 127.0.0.11. The old updates experiation time was: Mon Jul 11 
03:27:02 2011 GMT. The new updates expiration time is: Tue Jul 10 
03:27:02 2012 GMT. If your updates have already expired, you should run 
/usr/local/cpanel/cpkeyclt to reenable updates. " status="1" version="0.1"/>
 Output (YAML)
--- 
reason: Dispatched notification Updates have been extended for the license on 
ip: 127.0.0.11. The old updates experiation time was: Mon Jul 11 
03:27:02 2011 GMT. The new updates expiration time is: Tue Jul 10 
03:27:02 2012 GMT. If your updates have already expired, you should run 
/usr/local/cpanel/cpkeyclt to reenable updates.
status: 0
version: 0.1

Parameters

ParameterTypeDescriptionPossible valuesExample
ipstring

Required

The license account's IP address.

A valid IP address on the server.

The List License Information function returns a list of possible values.

127.0.0.11

Returns

ReturnTypeDescriptionPossible valuesExample
reasonstringThe function's result.A string value.
 Click to view...

Dispatched notification Updates have been extended for the license on

ip: 127.0.0.11. The old updates experiation time was: Mon Jul 11

03:27:02 2011 GMT. The new updates expiration time is: Tue Jul 10

03:27:02 2012 GMT. If your updates have already expired, you should run

/usr/local/cpanel/cpkeyclt to reenable updates.

statusBooleanWhether the function succeeded.
  • 1 — Success

  • 0 — Failure.
1
versionnumericInternal information that the Manage2 API uses.A numeric value.0.1