|
Installation ProcedureInstalling zoglair is not any different than installing most web applications. If you have done it before, the following procedure will be familiar to you:
Please notice that if you are installing on a local Windows PC, you might be able to jump from 1 to 5, depending on your configuration. Details will be given in the following sections. Unpack archive to your document rootIt is recommended that you first try out and evaluate zoglair at the comfort of your local computer. As soon as you are happy with it, you can either upload your working directory to your public server or upload the compressed archive and unpack it via a telnet session. Zoglair can be unpacked to either your document root or any directory underneath. When you open the archive you will find three files in its root (.htaccess, index.php and license.txt) and a folder (zoglair) containing the rest of its code base. If you are installing on your local PC and especially if you are a web developer, then it is more than likely that you have other applications installed too, each one on its own directory. It makes sense to do the same with zoglair and access it via a URL like the following:
If, however, your are installing on your live server and zoglair is your only or main CMS, then you should unpack it directly under your document root. It is worth mentioning that zoglair generates and stores relative URLs, stripping it's installation directory (no matter how deep) whenever applicable. This makes it location agnostic, which means that you can relocate it or move it between servers, and all links will still be valid. Make var/domain folder writable If you are installing on a local Windows PC, you may skip this step as everything is writable by default. Generally, you should use the chmod command to change permissions of the var/domain folder to either 755 or 777, depending on how PHP is configured to run on your server. If it runs under your account (the same one you are using for FTP or shell access), then 755 is just fine. If it runs under another, non-privileged account (such as nobody, apache, web, www), then 777 is needed. Edit core/zoglair.cfg.php If you are installing on a local Windows PC, you might not need to change anything.
You may refer to zoglair.cfg.php for a full explanation of the available options but for now all that is needed is to make sure that the database, username and password values are the correct ones. Create a database If you are installing on a local Windows PC, you may let zoglair create it for you. You may either use an existing database, shared with other applications, or create a new one. If the database is shared, zoglair will be able to identify its own tables by prefixing them (see option in the previous step). Zoglair will attempt to create a database for you, if none is found. You should know, however, that database creation is a privilege needed only once and normally it comes with other - more serious - privileges, such as database deletion! It is not a good idea to give zoglair such power, unless you are installing on your local PC. Run the setup scriptYou are now ready to proceed with setting up your domain. Point your browser to the installation folder:
If everything is done correctly, you will prompted with the Domain Setup screen from which you can create your first domain by answering a few simple questions. If, however, there is a configuration error, you will see a BSoD, telling you what went wrong. If this happens, please don't panic! Just read about the BSoD to find out how to solve your problem. |