= Dolphin 7 Troubleshooter = If your web-server complies with [wiki:DolTech Dolphin Hosting Requirements] and you carefully followed al the steps described in [wiki:DetailedInstall Dolphin 7 Installation Guide], your site should work just fine. In some (rare) cases, you may encounter a problem. In this document we gather the most common known issues and their possible solutions.[[BR]] ---- '''[http://www.boonex.com/trac/dolphin/wiki/GenFAQ#IseeablankpageintheplaceofmyDolphinHomepage. I see a blank page in the place of my Dolphin Home page.]''' ---- == I see a blank page in the place of my Dolphin Home page. == Your server probably refuses to use relative paths, so that ''PHP''s' '''require_once''' instructions can't find the files specified. To resolve the problem you should add the following string as the first instruction in ''index.php'', ''inc/design.inc.php'' and ''admin/index.php''. {{{ ini_set("include_path", "path_to_script"); }}} You should replace "path_to_script" with the absolute path to your script's folder. ---- == My page comes out gibberish. When I look at the source I see a lot of '''''' tags. == If the '''''' tags are being sent to the browser, it means your ''PHP'' is not working properly. All ''PHP'' code is supposed to be executed before the server sends the resulting ''HTML'' to your web browser. Make sure your web server meets the [wiki:DolTech requirements] to run Dolphin, that ''PHP'' is installed and configured properly, or contact your hosting provider or system administrator for assistance. ---- == After install my home page displays "Internal error 500". == Your server probably doesn't accept '''.htaccess''' files (folder configuration files). In this case, delete '''.htaccess''' file from the folder that doesn't open or refer to your hosting provider for a reference what it should be replaced with. ---- == I keep getting ''Database activation failed'' but I'm sure my configuration is correct. == Try resetting your ''MySQL'' password manually. If you have access to ''MySQL'' via shell, try issuing: {{{ SET PASSWORD FOR 'dolphinusername'@'hostname' = OLD_PASSWORD('password'); }}} If you are using a version of ''MySQL'' prior to 4.1, use PASSWORD instead of OLD_PASSWORD. If you do not have shell access, you should be able to simply enter the above into an ''SQL query'' in ''phpMyAdmin''. Failing that, you may need to use your host's control panel to reset the password for your database user. ---- == My security image doesn't show up on join_form.php. == Check if you have [http://www.boutell.com/gd/ GD library] installed and if it's compiled with ''Free Type fonts'' library. If GD library is not installed, you should install the latest version of [http://www.imagemagick.org ImageMagick] and disable '''Use GD library for image processing in '''Admin panel -> Settings -> Advanced Settings'''. ---- == My image/MP3/video uploads don't work. == Most probably, you have not set correct permissions for ''media/images/profile/'', ''media/sound/'' and ''media/video/''. These folders should have 777 permissions (readable, writable, executable). Your ''PHP'' may be also configured to upload files under specific limit. In this case, check ''php.ini'' (PHP configuration file) and edit the settings for ''"upload_max_filesize"'' statement. ---- == Forum displays a blank page == Check if ''PHP'' is compiled with '''DOMXML''' and '''XSLT''' support. ---- == My Dolphin site shows 500 internal server error == First, you need to investigate your webserver error log file, for the exact error message, but most common problems are listed below: 1) Try to remove the '''Options -!MultiViews''' from the file '''.htaccess'''. Also remove any '''php_value''' and '''php_admin_value''' instructions from it. 2) Another problem causing this may be incorrect permissions on some files or folders. All folders should have 755 permissions, and all files should have 644 permissions (except for '''flash/modules/global/app/ffmpeg.exe''' which should have 755 permissions). 3) All Dolphin files and folders should have your FTP user as their owner. If it is not so, this can be another reason of the problem. ---- == Some or all of my Flash apps keep on loading and do not work. == 1) This problem usually happens when there are writable permissions on folders and files when PHP is running in CGI mode. To check the mode your PHP is running in, log into your Dolphin's Admin Panel and then open the page '''administration/phpinfo.php'''. To fix it, you will need to set all folders permissions to 755 and all files to 644. The file '''flash/modules/global/app/ffmpeg.exe''' should be also set to 755. 2) This problem may also be caused by script's inability to open widgets' default skins. You can try the following tweak which will be harmless for the rest of the script functionality: open the file '''flash/modules/MODULE_NAME/skins/index.php and replace the line {{{ $sFile = $aResult['current'] . "." . $aResult['extension']; }}} with {{{ $sFile = "default.swf"; }}} You can also try to comment out these lines if you still experience the problem: {{{ /* - comment start require_once("../../../../inc/header.inc.php"); require_once($sIncPath . "functions.inc.php"); require_once($sIncPath . "apiFunctions.inc.php"); require_once($sIncPath . "xml.inc.php"); $aPathParts = explode("/", $_SERVER['PHP_SELF']); $iPartsCount = count($aPathParts); $aResult = getExtraFiles($aPathParts[$iPartsCount-3], $aPathParts[$iPartsCount-2]); comment end - */ }}} '''''MODULE_NAME''''' stands for '''board''', '''chat''', '''desktop''', '''im''', '''mp3''', '''photo''', '''video''' or '''video_comments'''. ---- == When I upload a video it always says "video is being processed" == 1) Check if the crons are installed and running properly. You can check your bug report email for messaged from the crons and if they contain any problem messages. 2) Check if ffmpeg.exe is executable and produces any output. This can be checked in ''Admin Panel -> Tools -> Host Tools -> Host Params'' 3) Your server may not support H264 codec and thus can't process videos. In this case, the codec should be disabled in "Admin Panel -> Modules -> Flash Apps -> Video Player -> Settings". ---- == I have installed/created a new template for Dolphin and the Forum stopped to work == When you create or install a new template, you should consider that the same template should be created for the forum too. Templates for Orca Forum should be placed in the folder '''modules/boonex/forum/layout/''' where you can find your default template '''uni''' and the '''base''' folder whose settings all other templates will inherit. If you didn't create a template for Orca but you would like to use it with the default UNI template, you will need to tweak it: rename the '''uni''' folder to your custom template's name, for example, if your template's folder name is called '''tmpl_cucu''', rename the '''uni''' folder to '''cucu'''; go to the '''cucu''' folder and open the file '''params.php'''; rename all instances of the '''uni''' folder to '''cucu''' and save the file; now you only need to go to '''Admin Panel -> Modules -> Orca Forum -> Manage Forum''' and recompile your languages. ---- == I get "allowed memory size exhausted error" == This error comes from unsufficient PHP settings. I will show you how to change some PHP settings to prevent this kind of error and some other errors, too. 1) If PHP is running as an Apache module. Open the file ".htaccess" in Dolphin installation directory and add these at the very end of it: {{{ php_flag allow_url_include Off php_value upload_max_filesize 128M php_value post_max_size 256M php_value memory_limit 128M php_value max_input_time 3000 php_value max_execution_time 3000 php_flag magic_quotes_gpc Off php_flag short_open_tag On }}} 2) If PHP is running as CGI or FastCGI application. Open the file "php.ini" in Dolphin installation directory or create a new one. Add these lines at the very end of the file: {{{ magic_quotes_gpc = Off safe_mode = Off allow_url_include = Off allow_url_fopen = On register_globals = Off upload_max_filesize = 128M post_max_size = 256M memory_limit = 128M max_input_time = 3000 max_execution_time = 3000 short_open_tag = On }}} You need to place this file in every sub-directory of your Dolphin folder. This can be done by running the following command in your SSH shell: {{{ cd dolphin_dir find ./ -type d -exec cp php.ini {} \; rm -rf ./flash/modules/*/skins/php.ini ./flash/modules/*/langs/php.ini ./modules/boonex/forum/install/langs/php.ini ./modules/boonex/forum/integrations/base/langs/php.ini }}} '''dolphin_dir''' should be replaced by the full path to Dolphin directory, for example "/home/user/public_html/"