View source for Replacing a License

== Replacing a license ==

Go to the license page for your product. For example, if the product is installed in nats.site.com, the license page would be: http://nats.site.com/license.php

If you see a white page with a one line error, the automatic method will not work for you, and you will need to see the [[Replacing_a_License#Manual_Method|Manual method]].

If you see a license page (even if the page says license not found in red), see the [[Replacing_a_License#Automatic_Method|Automatic method]]

=== Automatic Method ===

Go to this page:

 http://nats.site.com/license.php?RELOAD_LICENSE=1

(where nats.site.com is your product's domain)

If you see <tt>*success*</tt> at the top of the page, you've successfully replaced the license.
If you see an error, you will need to use the [[Replacing_a_License#Manual_Method|Manual method]]

=== Manual Method ===
'''1'''. You will need the url to the new license (TMM can provide this for you). The url should look something like this:

 http://license.toomuchmedia.com/license.php?license=4444333322221111aaaabbbbccccdddd&html=1&zend=1

(if the url has zend=1, that does not necessarily mean you are using a zend version of the product)

'''2'''. In the product's directory, there is a directory called licenses. In there is the license file.

* If you are running an Ioncube version of the product, the file will be named [prod].txt (for ex: nats.txt, carma.txt, tube.txt)
* If you are running a Zend version of the product, the file will be named [prod].zl (fo ex: nats.zl, carma.zl, tube.zl)
* If you have both, or no license file, see if there is a directory called <tt>ioncube</tt> in the product's directory. If there is, you're using Ioncube. If there isn't, you're using Zend.

'''4'''. Make a copy of your current license file. For example:
 cp nats.txt nats.bak.txt

'''3'''. Open the license file url in your browser. Copy the text of the license file

'''4'''. Open a temporary file in the licenses directory in a text editor. For ex:
 nano -w nats.new.txt

'''5'''. Paste in the license text. Make sure there are not any blank lines at the beginning or the end, and save the file.

'''6'''. Replace the existing file with the new file. For ex:
 cp nats.new.txt nats.txt
== Making the new license take effect ==
If you are using Ioncube, the license should take effect immediately. If you go to license.php, you should see the new license has taken effect.

If you are using Zend, you will need to stop Apache, wait (around 5-10 seconds), and start Apache. If you do not know how to do this, your host should be able to.