-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
* Watch My Domains Server v5.0 Demo / Standard / Professional Edition
* Installation and setup
* Copyright 2010-2022, Softnik Technologies.
* https://softnik.com/
*
* User guide is available at
* https://domainpunch.com/sed/guidev5/
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

System Requirements
-------------------

Linux / Windows / Mac OS X System

SSH (Secure Shell) access or Cron job management

Web Server (Apache is recommended)

PHP 7.1 +

Currently PHP 8.0 + is support available only in the Professional edition.

Database: MariaDB / MySQL 5.6 +, SQLite 3. Professional Edition supports 
MS SQL, Oracle and PostgreSQL.

ionCube Loader 10.2 or greater installed on server (only for demo and Standard 
Editions, not required for Professional Edition)

Basic knowledge of Linux, SSH, crontab, server installation, etc.


-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
If you are updating an earlier installation of the same major version.
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

Overwrite the existing files by unzipping / uploading into the same folder.

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
If you are upgrading from an earlier major version (2 or 3)
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

Install separately to a different folder and use different database. You can
import data from v3 into v4.


-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
QUICK 2 Minute Installation
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=



Step-1
Unpack the ZIP into your web folder
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

Unpack the contents of the wmdsed_xxx_xxxxxx.zip into a folder on your web server. 
Make sure that the folder is web-accessible.

You should have access to a MySQL / Oracle / MS SQL / PostgreSQL database along 
with the database name, a valid user name and a password. You can also use 
SQLite 3 by just specifying the full path to a writeable file that will be used 
for SQLite storage. There is no need to specify user name or password if you use 
SQLite.

MS SQL, PostgreSQL and Oracle are supported only in demo and Professional editions. 
So if you don't intend to purchase the professional edition you should use MySQL/ 
MariaDB or SQLite.


Step-2
Edit config.php
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

If you are installing for the first time, copy or rename the file 
config-sample.php to config.php.

Open config.php at the root of the base folder and add the database name, user 
name and password. 

Specify a setup user name and password. Remember this so that you can login to
the application.

Save the config file.


Step-3
Run and Test the application
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

At this point you should be able to see the application interface at

http://yourdomain/your-install-folder/

You can click the '+" button to add domains.
 


Step-4
Add a cron entry for processing the lookup queue
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

The application processes the lookup queue using the cron.php script. So this 
should be executed at periodic intervals. You can do this using a cron job.

Here is a sample crontab entry.

* * * * * php /home/softnik/public_html/wmdsed50/cron.php >/dev/null 2>&1

OR

* * * * * wget -q -O /dev/null "http://www.example.com/wmdsed50/cron.php?key=xxxx" >/dev/null 2>&1

Note: You can use PHP cli (as in the example directly above) or use wget / lynx etc
to run the cron script. If you are using PHP, remember to set the correct path to 
the script.

If you use wget or lynx you should also specify a CLI authentication key (CLI Key).

Go to

http://yourdomain/your-install-folder/admin.php

Look under the 'Security' tab in 'Settings'. Replace the xxxx in the example above 
with your CLI key. This is not required when you use PHP command line.

Please note that the above entry executes the script every minute. This is important
because the queue processor needs frequent control to prevent doing too many and / 
or too less lookups. Every time you execute the above script it will only do very 
small number of optimized lookups and exit quickly. If you set the cron to run once
an hour the application will not be able to process even 300 lookups in a day. So
make sure that the cron executes every minute.

If the installation folder is password protected using htaccess, use the following 
(required only for wget / lynx)

* * * * * wget -q -O /dev/null --user xxxxxxx --password 'xxxxxx' "http://www.example.com/wmdsed50/cron.php?key=xxxx" >/dev/null 2>&1

Make sure that you insert the url, username and password accurately.

Here is a crontab entry that uses Lynx instead of wget...

* * * * * lynx -dump http://www.example.com/wmdsed50/cron.php?key=xxxx >/dev/null 2>&1

