Login/Register

Advanced Usage FAQ

How do I install Installatron Plugin?

Download and install Installatron Plugin

How do I install Installatron Server?

Continue to the What is Installatron Server? page.

How do I upgrade/update Installatron Plugin or Installatron Server?

Installatron automatically adds a Crontab or Windows Task Scheduler process to upgrade/update once per day.

To force an upgrade/update, click run Installatron update now in Administration, or follow the steps on the upgrade page.

How do I uninstall Installatron Plugin?

Continue to the How to: Uninstall/remove Installatron Plugin page.

How do I restore an Installatron Plugin or Installatron Server backup to a different location?

To edit a backup so that it can be restored to a different location or web hosting account:

  • Create a new database within the control panel software on the destination web hosting account.

  • Copy the application backup archive to a second location so in the event something goes wrong this process can be restarted.

  • Extract the application backup archive to a temporary directory.

  • Within the temporary directory, edit any application config files (for example, "app/etc/local.xml" for Magento, or "wp-config.php" for WordPress) to replace the old database information with information of the just-created database. Do not modify the table prefix variable.

  • Within the temporary directory, edit the ".ht*.meta" file (the exact file name will vary). These values need to be updated to the correct values for the new location: owner, url, url-domain, path, db-host, db-name, db-user, and db-pass. Do not edit the db-prefix value.

  • Copy the edited file from the last step to "/.appdata/backups/" (within the destination web hosting account) and rename the file to remove the ".ht" and ".meta" portions of its name. The file should be renamed such that only the alphanumeric middle portion of the name persists, for example "77b88f4b603641f08d147fde90166a2f".

  • Add both of the edited files back into the existing application backup archive, and move the application backup archive to the "application_backups" directory of the destination web hosting account (if it's not already located there).

That's it! It should now be possible to restore the backup through the Installatron GUI.

If problems are experienced with the restored application, use phpMyAdmin to search the database for the old install URL. A few applications keep the install URL in their database and this will need to be updated (for example, Magento has a variable named "web/secure/base_url" in the "core_config_data" table).

If there are any questions open a ticket.

How do I translate Installatron products?

The Installatron Locale Translator tool allows anyone to translate lines, and can also be used to generate locale customizations for your server.

How do I add applications to Installatron?

The Installatron Application Packaging SDK allows anyone create and maintain applications.

How do I mirror an Installatron Plugin or Installatron Server configuration between multiple servers?

To help streamline the management of individual Installatron Plugin or Installatron Server instances on a large number of servers it's possible to simply mirror these files between servers using rsync or a product like Puppet:

/usr/local/installatron/etc/settings.ini
/root/.appdata/.settings
/home/admin/.appdata/.settings
/var/installatron/data/admin/.settings
/var/installatron/data/root/.settings

To mirror secondary groups, also include these files:

/root/.appdata/.groups
/home/admin/.appdata/.groups
/var/installatron/data/admin/.groups
/var/installatron/data/root/.groups
/root/.appdata/*.settings
/home/admin/.appdata/*.settings
/var/installatron/data/admin/*.settings
/var/installatron/data/root/*.settings

Note that depending on the control panel software used some of these files may not exist. Only mirror files that exist.

How do I make the Installatron platform work with my own control panel?

Installatron Server enables any web hosting control panel or user interface to incorporate Installatron.

How do I transfer Installatron Plugin to another server?

To transfer Installatron Plugin to another server and retain all existing installed applications, backups, and administrative settings:

  • Ensure that you have the latest version of Installatron Plugin installed.
  • Disable Installatron Plugin on the old server (in Administration > General).
  • Transfer the control panel user accounts to the new server. Make sure the ".appdata" and "application_backups" directories are included in the account transfer.
  • Use your account page to change the assignment on the license to the new server.
  • Install Installatron on the new server.

To reinstate administrative settings: After Installatron Plugin is installed on the new server, copy these files from the old server to the new server. Note that depending on the control panel software used some of these files may not exist.

/usr/local/installatron/etc/settings.ini
/root/.appdata/.settings
/root/.appdata/*.settings
/home/admin/.appdata/.settings
/home/admin/.appdata/*.settings
/var/installatron/data/admin/.settings
/var/installatron/data/admin/*.settings

How do I change the IP on my Installatron Plugin license?

Login to your account page and save a new IP value for your license.

How do I fix Installatron Plugin or Installatron Server?

Continue to the Troubleshooting page.

How do I renew a monthly or annual Installatron Plugin license before it expires?

Log into your account and click the renew link for the license you wish to renew. This will create an invoice, email you the details, and take you to the payment page.

Licenses renewed before expiration have the renewal added to the existing expiration. There is no waste when renewing early.

How do I install web applications using the command line?

How do I install web applications using an API?

Installatron is able to install and upgrade applications from both a command line interface and HTTP-API. This can be used to pre-populate new hosting accounts with software. Continue to the Automation Guide for more information and usage examples.

How do I create an Installatron Fast Update server?

Installatron Fast Update enables providers to deploy a local Installatron data mirror, enabling Installatron to be installed and updated through the local network instead of through the traditional Internet. In the event a Fast Update server is offline or out of sync, servers will automatically fallback to updating through the Internet. Fast Update saves bandwidth, increases update speed, and is fully redundant. To deploy an Installatron Fast Update server please follow the below instructions.

First, provision a small server or VPS with CentOS 5.1 or newer. A Fast Update server currently requires around 10GB disk space and grows at approximately 75MB per month; we recommend provisioning a minimum 128MB memory and 25GB disk space, and this server can be configured to only accept incoming connections from within your network. Note that Fast Update servers are pretty lightweight; if only a couple hundred servers will be using the Fast Update server, it's feasible to use an account on an existing shared hosting server instead.

Once the bare server is provisioned, no control panel software must be installed, however using control panel software may save some management time in the long run. To set up a Fast Update server without a control panel, execute the below command from the server's SSH root command prompt. Skip this section if a control panel will be used instead.

yum install httpd php php-gd

Finally, add the below cronjob to sync Installatron data every hour. If a control panel or shared hosting account was chosen, the /var/www/html directory should be modified to point to the home directory of the control panel account created for Fast Update.

56 * * * * rsync -rlptDvzW --delete data1.installatron.com::data/ /var/www/html

Now that the Fast Update server is activated, to configure existing servers to use the server as their primary data source execute this command from the SSH root command prompt on each server:

echo "mirror=installatron.company.com" >> /usr/local/installatron/etc/settings.ini

To provision new servers, execute this command from the SSH root command prompt (replacing controlpanel with the type of control panel):

FASTUPDATE=installatron.company.com rpm -Uvh http://installatron.company.com/installatron-plugin-controlpanel.latest.noarch.rpm

Want a fully-managed Fast Update server?
We provide full management services for Installatron Fast Update servers under certain circumstances. Please contact us for further information.

How do I re-apply installed application branding after changing it?

Executing the below command from the command prompt will reapply installed application branding. Depending on the number of installed applications this command may take some time to complete.

/usr/local/installatron/installatron --rebrand-installs

How do I add an Installatron.com-styled The Apps page to my website?

How do I use the Installatron List Builder?

The Installatron List Builder tool enables a list of applications to be generated. The resulting files (one for each Installatron ACL) can be incorporated into a website.

To display a dynamic page similar to Installatron.com's The Apps page, a flat file database will need to be created using this code:

And then the below PHP code can be pasted into a website PHP file. Make sure to at minimum modify the LB_PATH constant to point to the correct list builder directory.

http://installatron.com/docs.listbuilder.appbrowser.phps

How do I change the affiliate ID displayed on the WHMCS install screen?

To change the affiliate ID from the default value, navigate to Installatron Admin >> Interface >> Locale and enter the below line into the Locale Customizations textbox, replacing "2222" with the desired affiliate ID:

_installer_whmcs_licensekeytext_aid=2222
© 2004 - 2013 Installatron LLC. All rights reserved.