Installing or Upgrading osDate

Go down

Installing or Upgrading osDate

Post  Johannesburg on Mon Mar 08, 2010 2:48 am

osDate comes with an advanced installation wizard, to help guide you through the process. Please follow these steps. You can also use these steps to upgrade your current osDate installation.

1) Upload

Using an FTP client, like WS_FTP, AbsoluteFTP, or CuteFTP or other FTP program, upload the entire osDate system to your server, or to a sub-folder on your server. My personal favorite Windows-based FTP program is AbsoluteFTP, from

Please ensure that all files and folder have been uploaded. A common problem for users is that they get a connection time-out while uploading, then skip a file or two when attempting to re-upload. Your web host should provide you with the Hostname, Username, and Password to connect to your web server. Your website's IP address often works for the Hostname parameter.

Please note that you only should upload the files in the "public_html" folder which comes with osDate. Furthermore, index.php should be set as the default index file for your website. If you have an "index.html" file already present, for example, you may wish to remove or rename it to something else.

You may also upload osDate to a sub-folder on your server, instead of to the server root. During installation, osDate will attempt to detect the folder that it is sitting in, and make the appropriate adjustments to config.php, the osDate configuration file.

Thus, after uploading, you will probably have something that looks like this. I have a folder called "httpdocs" where all of my website's public files go. This might be "htdocs" or "public_html" or something else, depending on the type of server that you have. So, I uploaded the contents of the osDate's "public_html" folder to the "httpdocs" folder on my server.

2) Start the Installer


One of the files that I uploaded is "install.php". If you don't see this file, then there is something wrong. You should open this file using a web browser (preferably Mozilla Firefox), by accessing this URL:

Of course, substitute "" with your actual website domain name. If you uploaded osDate to a sub-folder, then you may have to access:

In either case, you should be presented with a screen that looks like this:

If one or more of the values on the right-side of the screen says "No" instead of "Yes", then obviously you will have to make some corrections. osDate uses an advanced template system known as Smarty, which requires write access to some files and folders. osDate itself makes changes to files and folders during normal operation, which also requires write access.

To make a folder writable in AbsoluteFTP, right click on the file or folder, then click on the Properties option, and set the appropriate attributes. Changing the permissions of files and folders is also called "CHMODing" after the UNIX command that accomplishes the same thing. A CHMOD value of 644 works for most servers, but some require 666.

You should also have the "GD" libraries installed with PHP. GD is a set of tools that allow PHP to perform image manipulation. Several parts of osDate involve modifying uploaded images "on the fly", and thus require GD.

After making a change to your read/write settings, you should refresh the first page of the installer so that osDate can detect your change. When all items show "Yes", click "Continue" to continue to step 2.

STEP 2/3

In this step, you should specify your MySQL login settings. If you do not know what these are, or if you do not know if you have a MySQL database available, you should contact your website administrator or hosting company.

The "Document Root" should remain "/" if you have uploaded osDate to your website's root folder (httpdocs, htdocs, or public_html). If you uploaded this to a sub-folder, then it should read "/your_folder/", where "your_folder" is the name of the folder that you uploaded osDate.

The "Host" value is usually "localhost", but not always. This is NOT the same as your domain name! Although several Database Types are provided in the combo list, osDate currently only works with MySQL. Efforts are underway to make osDate fully compatible with all database types listed in this combo box.

You should leave the Table Prefix at "osdate". This is the text string which will be appended to every table that osDate creates, except for phpBB tables, which have the phpbb prefix by default. When Step 2 is completed, you will have a list of new tables looking something like this (you can check this using phpMyAdmin or phpFlashMyAdmin).

If you observe any errors after clicking Continue in Step 2, then you will need to correct them before continuing.

If you are upgrading osDate from a previous version, be sure to backup your database and web files completely before continuing! Then, click on the "This is an upgrade for my current osDate installation..." option in Step 2, and check both of the boxes below it.

The upgrader will scan your database, and add any missing osdate tables and fields, and any table indices. It will not, however, modify any phpBB tables. Upgrading phpBB is your responsibility. The upgrader will not remove any tables or fields. It will also add any global settings that are missing from your current osDate configuration, and add any payment modules or module constants that were added since your previous installation. The upgrader will add any additional table keys, and change any existing field types to new field types, too. For example, if a previous version of osDate used a varchar(255) field for field X of table Y, and the new version of osDate uses a "text" field type for field X of table Y, then the upgrader will change the old field type to the new field type.

It is also important to remember that the upgrader is a database upgrader only. It does not modify any PHP, TPL, or other files.


This step is optional, and allows you to specify particular mail server settings. For example, if you would like to use an SMTP server to send mail from instead of the usual sendmail, you can do this here. For example, I use my Yahoo account to send mail using settings similar to these. If you skip this step, osDate will use the PHP mail() function, which usually uses sendmail. This will work properly on the majority of web servers.

3) Cleanup

All done! Be sure to remove the "install.php" file, and the "install_files" folder, from your server before using osDate in a production environment.

Immediately after installation, you should access the osDate Admin panel, at -

Or, if you installed osDate in a sub-folder on your server -

The default login is "admin" for the username, and "pass" for the password (without quotes). If you do not change these immediately after installation of osDate, your system will be vulnerable to malicious users who happen to know that you're using osDate for your dating system. So, PLEASE change these after installation to something that only you know. Be sure that you do not forget this login, however, since the password is encrypted in the database using a one-way hash encryption (MD5).

Now, if you forget your admin login, there is something that you can do without re-installing. Open phpMyAdmin (or better: phpFlashMyAdmin!), and locate the osdate_admins table.

The "password" field contains a long string of seemingly random characters. This is actually an encrypted password, using something known as "MD5" encryption. MD5 is one-way encryption, which means that that you cannot de-crypt MD5 after it is encrypted. Edit this row of your osdate_admins table, and then change the password to this:


This string is the word "pass" in MD5. After you make this change, you should be able to again login to the osDate admin panel using admin / pass, after which time you can change the password to something more secure.

For Advanced Users... In case you're wondering how this password was actually generated in PHP, open a new text file, called "password.php", and paste the following contents to it:


echo md5( 'pass' );


Then, open this file using a web browser. You will see this string in your browser screen (see how easy that is!).

Enjoy osDate!



Posts : 5
Points : 15
Join date : 2010-03-08

View user profile

Back to top Go down

Back to top

- Similar topics

Permissions in this forum:
You cannot reply to topics in this forum