YetiShare - Installation Script

If you've just completed a new install and you're still seeing this page, ensure you delete the /install folder on your host. Then try again.


Use these pages to install or upgrade the script. For new installations you can use the wizard below to automatically setup the script. For upgrades you'll need to manually apply the changes. Select your installation type below to start.

Upgrade Existing Install - Your Current Version 4.x

Use this method if you are currently using YetiShare and on a version in the v4.x range.


[top]

Step 1. Backup Existing Code & Database.


VERY IMPORTANT! - Before you do any changes to the code at all, ensure you've taken a backup copy of the site, files & database.

Move all your current code and files into a temporary folder on your hosting. We create a new folder called "_OLD_SITE" and move the files into there.


[top]

Step 2. Uncompress Downloaded Zip File.


Open the downloaded zip file on your computer and extract the files into a new folder on your desktop. If you can't open zip files you may need to download a zip client such as WinZip.


[top]

Step 3. Import Database Patches.


Within your hosting control panel, load phpMyAdmin and select your new database. In the right-hand section click on 'import'. Attach the the relevant sql patches from the directory `/install/resources/upgrade_sql_statements/` and submit the form. Choose the patches between your current script version number and the latest, ensuring you do them in version number order.


[top]

Step 4. Upload Files.


Using an FTP client such as FileZilla, upload all the files to your webroot (normally public_html folder) apart from the '/install' folder. Important This should NOT be over the top of your existing code as it was moved in step 1. There are significant changes in this release and the code structure has completely changed.


[top]

Step 5. Restore Existing Cache, Logs and Files folders.


From your "_OLD_SITE" backup, copy the following folders into their new location - these have changed in the new release.

  • /_OLD_SITE/files/ => /files/
  • /_OLD_SITE/core/cache/ => /cache/
  • /_OLD_SITE/core/logs/ => /logs/


[top]

Step 6. Set Folder Permissions.


Using your FTP client, set permissions to CHMOD 755 on the following folders: '/files', '/logs', '/cache' & '/plugins'.


[top]

Step 7. Setup Cron Tasks.


The path to cron files has been amended in this release, details of these are below. You can leave these until later if you want to test the upgrade first. See here for more information on cron tasks.

  • 0 0 * * * php /home/rapidfire/public_html/app/tasks/auto_prune.cron.php >> /dev/null 2>&1
  • 0 0 * * * php /home/rapidfire/public_html/app/tasks/create_internal_notifications.cron.php >> /dev/null 2>&1
  • 0 * * * * php /home/rapidfire/public_html/app/tasks/delete_redundant_files.cron.php >> /dev/null 2>&1
  • 0 0 * * * php /home/rapidfire/public_html/app/tasks/downgrade_accounts.cron.php >> /dev/null 2>&1
  • */5 * * * * php /home/rapidfire/public_html/app/tasks/process_file_queue.cron.php >> /dev/null 2>&1
  • 0 1 * * * php /home/rapidfire/public_html/app/tasks/create_email_notifications.cron.php >> /dev/null 2>&1


[top]

Step 8. Update The Config File.


Populate the credentials in the _config.inc.php file. You can find these in /_OLD_SITE/_config.inc.php.


[top]

Step 9. Nginx Users - Update Rewrite Rules.


- If you're using Nginx, ensure you remove any rewrite rules starting with: (alternatively see ___NGINX_RULES.txt in the code root for the full rules)

  • rewrite ^/app/
  • rewrite ^/api/


Congratulations, you now completed the upgrade. Feel free to contact us or post of our forum if you have any problems.

Manual Installation: (New Install)


[top]

Step 1. Uncompress Downloaded Zip File.


Open the downloaded zip file on your computer and extract the files into a new folder on your desktop. If you can't open zip files you may need to download a zip client such as WinZip.

In addition, make sure that the .htaccess file in the root of the zip file is also extracted. Some operating systems hide files starting a dot by default. This file is needed for the mod_rewrite rules in the script and it wont work without it. You may need to amend your OS settings to show these files if you can't see it in the zip archive.


[top]

Step 2. Create Database.


Using your hosting control panel, login and create a new MySQL database. Then create a database user and assign full privileges for the user on the database. Note the details for the next stage.


[top]

Step 3. Import Database Structure.


Within your hosting control panel, load phpMyAdmin and select your new database. In the right-hand section click on 'import'. Attach the .sql file located at /install/resources/database.sql and submit the form. Your database should now be ready.


[top]

Step 4. Update Config File.


Update "_config.inc.php" in your extract script code with your site url and the full path to the root of the script. In most instances, this will be your domain name (for _CONFIG_SITE_HOST_URL & _CONFIG_SITE_FULL_URL) in the format www.mydomain.com. Don't include the http:// or the trailing forward slash.

Set your database connection details in the same file. (host, user, password & db name)


[top]

Step 5. Upload Files.


Using an FTP client such as FileZilla, upload all the files to your webroot (normally public_html folder) apart from the 'install' folder.


[top]

Step 6. Set Folder Permissions.


Using your FTP client, set permissions to CHMOD 755 on the following folders: '/files', '/logs', '/cache' & '/plugins'.


[top]

Step 7. Setup Cron Tasks.


YetiShare uses a number of cron (background) tasks to ensure redundant files are deleted, accounts are auto downgraded etc. Details of these are below. You can leave these until later if you want to test the installation first. See here for more information on cron tasks.

  • 0 0 * * * php /home/rapidfire/public_html/app/tasks/auto_prune.cron.php >> /dev/null 2>&1
  • 0 0 * * * php /home/rapidfire/public_html/app/tasks/create_internal_notifications.cron.php >> /dev/null 2>&1
  • 0 * * * * php /home/rapidfire/public_html/app/tasks/delete_redundant_files.cron.php >> /dev/null 2>&1
  • 0 0 * * * php /home/rapidfire/public_html/app/tasks/downgrade_accounts.cron.php >> /dev/null 2>&1
  • */5 * * * * php /home/rapidfire/public_html/app/tasks/process_file_queue.cron.php >> /dev/null 2>&1
  • 0 1 * * * php /home/rapidfire/public_html/app/tasks/create_email_notifications.cron.php >> /dev/null 2>&1


[top]

Step 8. Admin Area Access Details.


The admin area can be accessed by adding "/admin/" onto the domain - i.e. yourdomain.com/admin/

Admin area access details:
- user: admin
- pass: password

We'd recommend that you change the admin password to something more secure on first login.


Congratulations, you now completed the installation. Feel free to contact us or post of our forum if you have any problems.

Upgrade Existing Install - Your Current Version 5.x

Use this method if you are currently using YetiShare and on a version in the v5.x range.


[top]

Step 1. Backup Existing Code & Database.


VERY IMPORTANT! - Before you do any changes to the code at all, ensure you've taken a backup copy of the site, files & database.


[top]

Step 2. Uncompress Downloaded Zip File.


Open the downloaded zip file on your computer and extract the files into a new folder on your desktop. If you can't open zip files you may need to download a zip client such as WinZip.


[top]

Step 3. Import Database Patches.


Within your hosting control panel, load phpMyAdmin and select your new database. In the right-hand section click on 'import'. Attach the the relevant sql patches from the directory `/install/resources/upgrade_sql_statements/` and submit the form. Choose the patches between your current script version number and the latest, ensuring you do them in version number order.


[top]

Step 4. Upload Files.


Using an FTP client such as FileZilla, upload the files from /app, /plugins & /themes to your install.


[top]

Step 5. Set Folder Permissions.


Using your FTP client, ensure CHMOD 755 permissions are set on the following folders: '/files', '/logs', '/cache' & '/plugins'.


[top]

Step 6. Purge Script Application Cache.


Login to your script admin area. Go to "Site Configuration" => "System Tools" => "Purge Cache" and click "Purge Now".


[top]

Step 7. Ensure Cron Tasks Are Setup.


YetiShare uses a number of cron (background) tasks to ensure redundant files are deleted, accounts are auto downgraded etc. Details of these are below. You can leave these until later if you want to test the upgrade first. See here for more information on cron tasks.

0 0 * * * php /home/rapidfire/public_html/app/tasks/auto_prune.cron.php >> /dev/null 2>&1 0 0 * * * php /home/rapidfire/public_html/app/tasks/create_internal_notifications.cron.php >> /dev/null 2>&1 0 * * * * php /home/rapidfire/public_html/app/tasks/delete_redundant_files.cron.php >> /dev/null 2>&1 0 0 * * * php /home/rapidfire/public_html/app/tasks/downgrade_accounts.cron.php >> /dev/null 2>&1 */5 * * * * php /home/rapidfire/public_html/app/tasks/process_file_queue.cron.php >> /dev/null 2>&1 0 1 * * * php /home/rapidfire/public_html/app/tasks/create_email_notifications.cron.php >> /dev/null 2>&1


[top]

Finished!


Congratulations, you've completed the upgrade! Feel free to contact us or post on our forum if you have any problems.