User Tools

Site Tools


Sidebar

tutorials:server:local_installation

This is an old revision of the document!


Local Installation

Several clients express a wish to run the software on their local machines while they are configuring their classified and auction software. This can certainly be done but there are a few things you need to be aware of.

Our software runs in a Internet server based environment which is not the environment of the local computer you connect to the Internet with. But you can emulate the Internet server based environment on your local Windows-based computer through the use of a program called WAMP (Windows Apache MySQL and PHP). This installs Apache and MySQL on your local computer and configures PHP to run on it. You do not essentially need WAMP to install this environment but WAMP does this easily for you on Windows boxes. The following contains a fuller list of packages that can create this environment for you on your Windows box:

http://en.wikipedia.org/wiki/Comparison_of_WAMPs

The following will provide a list of packages that can do the same for Linux, MAC and other platforms:

http://en.wikipedia.org/wiki/List_of_AMP_Packages

Once you have this environment working you can then install, test and configure your Geodesic installation on your local computer. Note that you cannot host your auction and classified installation for use over the Internet as this local environment built for local use only. This local environment is not "viewable" by others on the Internet as the above packages install on the 192.168.0.0 – 192.168.255.255 private IP block, which are local IP's, or to 127.0.0.1 which is the localhost1) IP. These IP's are not globally assigned over the Internet and so are not rout-able over the Internet.

When working on a local environment changes within that environment only affect the installation in that environment. So any changes you make within the admin tool, changes to Smarty templates or any changes within the PHP files will need to be duplicated within your "public" installation. If you are making changes "locally" before installing on a "public" Internet server you would need to move the installation to the Internet based server to move any of your changes. Even if the "local" environment installation is still used the public and local installations are not "tied" together so you will need to manually re-apply changes made in one installation to the other installation to have the installations "match" configurations.

  • You cannot use "localhost" when trying to access the local installation, the domain name must have at least one dot (.) in it, in order for browser cookies to work. You can use the IP address instead like 127.0.0.1. If you know how to properly update your computer's hosts file you may be able to create a "local domain" to use to access the software as long as it has at least one dot in the domain name, something like local.host. The problem with "localhost" is that a browser will not save a cookie to the "localhost" domain2), and cookies need to work to use the software.
  • Your license will need to be updated with the path for the local installation. With your license, you can install the classified and auction software to a "main location", and also to a secondary "test installation" such as installing it locally like we are describing here. The first time you install it, the license will automatically lock to the installation. For the secondary installation, you will need to contact [email protected] to add the second location to your license3).
  • All the URL settings in the auction and classified software will need to reference the IP address (or local domain) you use.
  • The most common URL to use for a local installation is 127.0.0.1
1)
Meaning "This computer"
2)
because of the lack of dots
3)
Unfortunately, at this time the second location is not able to be added automatically. We are working to find a solution to automate the process, for the time being though you need to contact us to manually add the second installation location to your license.
tutorials/server/local_installation.1272478306.txt.gz · Last modified: 2014/09/25 16:55 (external edit)