= Dolphin 6 Troubleshooter = For Dolphin 7 please go to [wiki:GenDol7TShooter Dolphin 7 Troubleshooter] ---- * '''[wiki:GenDolTShooter#IhaveapaidlicensebutmysitestillshowsBoonExAds.Whatisgoingonhere I have a paid license but my site still shows BoonEx Ads. What is going on here?]''' * '''[wiki:GenDolTShooter#MysiteshowsthemessageYouhavemanuallyremovedBoonExfooters...anddoesntwork My site shows the message "You have manually removed BoonEx footers..." and doesn't work]''' * '''[wiki:GenDolTShooter#IcantremembermyAdminloginandorpassword.HowcanIrestoreorchangeit I can't remember my Admin login and/or password. How can I restore or change it?]''' * '''[wiki:GenDolTShooter#Iseethiserroronsomeofmysitespages:Calltoundefinedfunction:mb_ereg_replaceinpath_to_dolphinincutils.inc.phponline120 I see this error on some of my site's pages: "Call to undefined function: mb_ereg_replace() in /path_to_dolphin/inc/utils.inc.php on line 120"]''' * '''[wiki:GenDolTShooter#WhenItrytoopenaNavigationMenulinkorsomebodysprofileIgetthispage:NotFound When I try to open a Navigation Menu link or somebody's profile, I get this page: "Not Found"]''' * '''[wiki:GenDolTShooter#IseethiserrorwhenIopenmysite:Warning:Missingargument1forTopMenuDesigncalledin...templatestmpl_...scriptsBxTemplMenu.phponline45anddefinedin...incmenu.inc.phponline250 I see this error when I open my site: "Warning: Missing argument 1 for TopMenuDesign(), called in ...templates\tmpl_...\scripts\BxTemplMenu.php on line 45 and defined in ...inc\menu.inc.php on line 250"]''' * '''[wiki:GenDolTShooter#Mysecurityimagedoesntshowup.Sonoonecanjoinmysite My security image doesn't show up. So no one can join my site]''' * '''[wiki:GenDolTShooter#Igetthiserrormessagethroughoutmysite:Fatalerror:Calltoundefinedfunction:mb_internal_encoding I get this error message throughout my site: Fatal error: Call to undefined function: mb_internal_encoding]''' * '''[wiki:GenDolTShooter#IreceivethiserrorwhenItrytoinstallDolphin:Theserverencounteredaninternalerrorormisconfigurationandwasunabletocompleteyourrequest I receive this error when I try to install Dolphin: "The server encountered an internal error or misconfiguration and was unable to complete your request"]''' * '''[wiki:GenDolTShooter#Iseethiserroronmysite:FatalError:Cannotapplylocalization I see this error on my site: Fatal Error: Cannot apply localization]''' * '''[wiki:GenDolTShooter#WhenItrytoaddanyfieldsintheFieldsBuilderittellsmeUnabletoaddNew_Item.CheckifNew_Itemisalreadyadded When I try to add any fields in the Fields Builder it tells me "Unable to add New_Item. Check if New_Item is already added"]''' * '''[wiki:GenDolTShooter#TheMemberLog-InLinkatthefarrightsideofmyhomepageheaderdoesnotwork The Member Log-In Link at the far right side of my homepage header does not work]''' * '''[wiki:GenDolTShooter#Iperiodicallygetthiserroronmysite:Goterror28fromstorageengine I periodically get this error on my site: "Got error 28 from storage engine"]''' * '''[wiki:GenDolTShooter#Igettheundefinederrorwhentryingtoregistermywidgets I get the "undefined" error when trying to register my widgets]''' * '''[wiki:GenDolTShooter#MyRMSwidgetsChatIMVideoRecorderendupinConnecting.WhatshouldIdo My RMS widgets (Chat, IM, Video Recorder) end up in "Connecting". What should I do?]''' * '''[wiki:GenDolTShooter#SomeofthewidgetsshowNotInstalledintheRaySuitePanelthoughIhavearegularDolphininstallation Some of the widgets show "Not Installed" in the Ray Suite Panel though I have a regular Dolphin installation]''' * '''[wiki:GenDolTShooter#MywidgetsresultinInvalidparameterserrorandmyRayBaseresultsinNotInstalled My widgets result in "Invalid parameters" error and my Ray Base results in "Not Installed"]''' * '''[wiki:GenDolTShooter#IgetUploadingfileerrororUndefinedwhenuploadingaudiovideofilesinRayMediaandVideoPlayers I get "Uploading file error" or "Undefined" when uploading audio/video files in Ray Media and Video Players]''' * '''[wiki:GenDolTShooter#MyFreeAd-Freelicensesdontworkresultinginwronglicensenumbermessage My Free/Ad-Free licenses don't work resulting in "wrong license number" message]''' * '''[wiki:GenDolTShooter#MyRaywidgetsshowNotRegisteredonuserendthoughtheyhavebeensuccessfullyregisteredonadminend My Ray widgets show "Not Registered" on user end though they have been successfully registered on admin end]''' * '''[wiki:GenDolTShooter#MyAudioVideowidgetsChatIMVideoRecorderandWhiteboardcantconnect My Audio/Video widgets (Chat, IM, Video Recorder and Whiteboard) can't connect]''' * '''[wiki:GenDolTShooter#Icantenternon-latincharactersinFlashApplications I can't enter non-latin characters in Flash Applications]''' * '''[wiki:GenDolTShooter#Ray3.1HotFix Ray 3.1 HotFix]''' * '''[wiki:GenDolTShooter#WhenIopenthevideorecorderitsconnectingforever.IntheadminpanelitopensupokbuthangswhenIclickonavideo When I open the video recorder, it's connecting forever. In the admin panel it opens up ok, but hangs when I click on a video]''' * '''[wiki:GenDolTShooter#Someorallofmywidgetskeeponloadinganddonotwork.IcantseesomebuttonsinFlashapplications. Some or all of my widgets keep on loading and do not work. I can't see some buttons in Flash applications.]''' * '''[wiki:GenDolTShooter#WhenaccessingOrcaIgeterrorWarning:fopen...orcaconfparams.conffunction.fopen:failedtoopenstream When accessing Orca, I get error "Warning: fopen(.../orca/conf/params.conf) function.fopen: failed to open stream"]''' * '''[wiki:GenDolTShooter#WhentryingtocompileOrcalanguagesIgeterrorLanguagefilescompilationhavebeenfailed When trying to compile Orca languages I get error "Language files compilation have been failed"]''' * '''[wiki:GenDolTShooter#IhaveproblemswithvideouploadandplayinDolphin7.0 I have problems with video upload and play in Dolphin 7.0]''' ---- == I have a paid license but my site still shows !BoonEx Ads. What is going on here? == 1) First of all, this can happen if you acquired the license but didn't register your site. Registration process is manual and here you can find out how you can do it: * Log into Dolphin Admin Dashboard. * If you did not register Dolphin previously, for example with a free license, then you will see notification asking you to register it. Just put the license code in there and press "Register". * If you already registered Dolphin with a different license (free or paid), you can change it by navigating to '''Settings -> Advanced Settings''' and specifying the new license code in the field '''Dolphin License Code'''. 2) In versions older than '''6.1.5''' this problem may happen even if you have taken all the steps above. This may happen when your site loses connection with boonex.com. Unfortunately, there's no way to avoid it in the version 6.1.4 or older but you can easily fix it by logging in '''Dolphin Admin Dashboard''' and logging out thus letting your license to be checked again. ---- == My site shows the message "You have manually removed !BoonEx footers..." and doesn't work == You must have installed a template which doesn't follow BoonEx requirement to show BoonEx footers or you have manually removed them. To restore the footers, you need to open the file '''templates/tmpl_TMPL/_footer.html''' and insert this line {{{ __boonex_footers__ }}} before the inclusion of the base footer: {{{ __includebase _footer.html__ }}} ''TMPL stands for the name of your template'' ---- == I can't remember my Admin login and/or password. How can I restore or change it? == You should empty the Admins table and create a new admin record there. The following script will allow you to do that. Place the script in the main directory of your Dolphin site, name it so its name would end with .php and run it in your browser, for example http://yoursite/admin_restore.php: {{{ Success"; ?> }}} where '''ADMIN_NAME''' and '''ADMIN_PASSWORD''' should be replaced with their real values. ---- == I see this error on some of my site's pages: ''Call to undefined function: mb_ereg_replace() in /path_to_dolphin/inc/utils.inc.php on line 120'' == This error and similar errors (yielding about functions starting with '''mb_''') refer to '''mbstring''' extension being absent from your PHP compilation. You should either re-compile it with '''--with-mbstring''' directive (under Linux) or uncomment '''extension=php_mbstring.dll''' in '''php.ini''' (under Windows). Then you should restart Apache web server. ---- == When I try to open a Navigation Menu link or somebody's profile, I get this page: ''Not Found'' == The problem is that your Apache server is not compiled with '''mod_rewrite''' module or you don't have rewrite instructions in your Dolphin's root .htaccess file. These instructions should be as follows: {{{ RewriteEngine on RewriteRule ^articles/{0,1}$ articles.php [QSA,L] RewriteRule ^articles/entry/([^/.]+)/{0,1}$ articles.php?action=viewarticle&articleUri=$1 [QSA,L] RewriteRule ^articles/entry/{0,1}$ articles.php?action=viewarticle&articleUri=$1 [QSA,L] RewriteRule ^articles/category/([^/.]+)/{0,1}$ articles.php?action=viewcategory&articleCatUri=$1 [QSA,L] RewriteRule ^news/{0,1}$ news.php [QSA,L] RewriteRule ^news/([^/.]+)/{0,1}$ news.php?newsUri=$1 [QSA,L] RewriteRule ^blogs/{0,1}$ blogs.php [QSA,L] RewriteRule ^blogs/all/([0-9]+)/([0-9]+)/{0,1}$ blogs.php?page=$2&per_page=$1 [QSA,L] RewriteRule ^blogs/top/{0,1}$ blogs.php?action=top_blogs [QSA,L] RewriteRule ^blogs/top/([0-9]+)/([0-9]+)/{0,1}$ blogs.php?action=top_blogs&page=$2&per_page=$1 [QSA,L] RewriteRule ^blogs/top_posts/{0,1}$ blogs.php?action=top_posts [QSA,L] RewriteRule ^blogs/tag/([^/.]+)/{0,1}$ blogs.php?action=search_by_tag&tagKey=$1 [QSA,L] RewriteRule ^blogs/tag/{0,1}$ blogs.php?action=search_by_tag&tagKey= [QSA,L] RewriteRule ^blogs/posts/([^/.]+)/tag/([^/.]+)/{0,1}$ blogs.php?action=search_by_tag&tagKey=$2&ownerName=$1 [QSA,L] RewriteRule ^blogs/posts/([^/.]+)/category/([^/.]+)/{0,1}$ blogs.php?action=show_member_blog&ownerName=$1&categoryUri=$2 [QSA,L] RewriteRule ^blogs/entry/([^/.]+)/{0,1}$ blogs.php?action=show_member_post&postUri=$1 [QSA,L] RewriteRule ^blogs/entry/{0,1}$ blogs.php?action=show_member_post&postUri= [QSA,L] RewriteRule ^blogs/posts/([^/.]+)/{0,1}$ blogs.php?action=show_member_blog&ownerName=$1 [QSA,L] RewriteRule ^blogs/posts/{0,1}$ blogs.php?action=show_member_blog&ownerName= [QSA,L] RewriteRule ^blogs/posts/([^/.]+)/([0-9]+)/([0-9]+)/{0,1}$ blogs.php?action=show_member_blog&ownerName=$1&page=$3&per_page=$2 [QSA,L] RewriteRule ^blogs/posts/([^/.]+)/category/([^/.]+)/([0-9]+)/([0-9]+)/{0,1}$ blogs.php?action=show_member_blog&ownerName=$1&categoryUri=$2&page=$4&per_page=$3 [QSA,L] RewriteRule ^events/{0,1}$ events.php?show_events=all&action=show [QSA,L] RewriteRule ^events/all/([0-9]+)/([0-9]+)/{0,1}$ events.php?show_events=all&action=show&page=$2&per_page=$1 [QSA,L] RewriteRule ^events/part/{0,1}$ events.php?show_events=all&action=show [QSA,L] RewriteRule ^events/search/{0,1}$ events.php?action=search [QSA,L] RewriteRule ^events/search/([^/.]+)/{0,1}$ events.php?action=search_by_tag&tagKey=$1 [QSA,L] RewriteRule ^events/my/{0,1}$ events.php?action=show&show_events=my [QSA,L] RewriteRule ^events/new/{0,1}$ events.php?action=new [QSA,L] RewriteRule ^events/entry/([^/.]+)/{0,1}$ events.php?action=show_info&eventUri=$1 [QSA,L] RewriteRule ^events/part/([^/.]+)/{0,1}$ events.php?action=show_part&eventUri=$1 [QSA,L] RewriteRule ^ads/{0,1}$ classifieds.php?Browse=1 [QSA,L] RewriteRule ^ads/search/{0,1}$ classifieds.php?SearchForm=1 [QSA,L] RewriteRule ^ads/my/{0,1}$ classifiedsmy.php?MyAds=1 [QSA,L] RewriteRule ^ads/new/{0,1}$ classifiedsmy.php?PostAd=1 [QSA,L] RewriteRule ^ads/cat/([^/.]+)/{0,1}$ classifieds.php?catUri=$1 [QSA,L] RewriteRule ^ads/all/cat/([0-9]+)/([0-9]+)/([^/.]+)/{0,1}$ classifieds.php?catUri=$3&page=$2&per_page=$1 [QSA,L] RewriteRule ^ads/subcat/([^/.]+)/{0,1}$ classifieds.php?scatUri=$1 [QSA,L] RewriteRule ^ads/all/subcat/([0-9]+)/([0-9]+)/([^/.]+)/{0,1}$ classifieds.php?scatUri=$3&page=$2&per_page=$1 [QSA,L] RewriteRule ^ads/entry/([^/.]+)/{0,1}$ classifieds.php?entryUri=$1 [QSA,L] RewriteRule ^ads/tag/([^/.]+)/{0,1}$ classifieds_tags.php?tag=$1 [QSA,L] RewriteRule ^photo/all/([0-9]+)/([0-9]+)/{0,1}$ browsePhoto.php?page=$2&per_page=$1 [QSA,L] RewriteRule ^photo/gallery_top/{0,1}$ browsePhoto.php?rate=top [QSA,L] RewriteRule ^photo/gallery_top/([0-9]+)/([0-9]+)/{0,1}$ browsePhoto.php?rate=top&page=$2&per_page=$1 [QSA,L] RewriteRule ^photo/gallery_top/([0-9]+)/([0-9]+)/{0,1}$ browsePhoto.php?rate=top&page=$2&per_page=$1 [QSA,L] RewriteRule ^photo/gallery_tag/([^/.]+)/([0-9]+)/([0-9]+)/{0,1}$ browsePhoto.php?tag=$1&page=$3&per_page=$2 [QSA,L] RewriteRule ^photo/gallery_tag/([^/.]+)/([0-9]+)/([0-9]+)/$ browsePhoto.php?tag=$1&page=$3&per_page=$2 [QSA,L] RewriteRule ^photo/gallery_tag/([^/.]+)/{0,1}$ browsePhoto.php?tag=$1 [QSA,L] RewriteRule ^photo/gallery/all/([^/.]+)/([0-9]+)/([0-9]+)$ browsePhoto.php?ownerName=$1&page=$3&per_page=$2 [QSA,L] RewriteRule ^photo/gallery/all/([^/.]+)/([0-9]+)/([0-9]+)/$ browsePhoto.php?ownerName=$1&page=$3&per_page=$2 [QSA,L] RewriteRule ^photo/gallery/all/([^/.]+)/{0,1}$ browsePhoto.php?ownerName=$1 [QSA,L] RewriteRule ^photo/gallery/([^/.]+)/{0,1}$ viewPhoto.php?fileUri=$1 [QSA,L] RewriteRule ^photo/gallery/{0,1}$ viewPhoto.php?fileUri=$1 [QSA,L] RewriteRule ^music/all/([0-9]+)/([0-9]+)/{0,1}$ browseMusic.php?page=$2&per_page=$1 [QSA,L] RewriteRule ^music/gallery_top/{0,1}$ browseMusic.php?rate=top [QSA,L] RewriteRule ^music/gallery_top/([0-9]+)/([0-9]+)/{0,1}$ browseMusic.php?rate=top&page=$2&per_page=$1 [QSA,L] RewriteRule ^music/gallery_top/([0-9]+)/([0-9]+)/{0,1}$ browseMusic.php?rate=top&page=$2&per_page=$1 [QSA,L] RewriteRule ^music/gallery_tag/([^/.]+)/([0-9]+)/([0-9]+)/{0,1}$ browseMusic.php?tag=$1&page=$3&per_page=$2 [QSA,L] RewriteRule ^music/gallery_tag/([^/.]+)/([0-9]+)/([0-9]+)/$ browseMusic.php?tag=$1&page=$3&per_page=$2 [QSA,L] RewriteRule ^music/gallery_tag/([^/.]+)/{0,1}$ browseMusic.php?tag=$1 [QSA,L] RewriteRule ^music/gallery/all/([^/.]+)/([0-9]+)/([0-9]+)$ browseMusic.php?ownerName=$1&page=$3&per_page=$2 [QSA,L] RewriteRule ^music/gallery/all/([^/.]+)/([0-9]+)/([0-9]+)/$ browseMusic.php?ownerName=$1&page=$3&per_page=$2 [QSA,L] RewriteRule ^music/gallery/all/([^/.]+)/{0,1}$ browseMusic.php?ownerName=$1 [QSA,L] RewriteRule ^music/gallery/([^/.]+)/{0,1}$ viewMusic.php?fileUri=$1 [QSA,L] RewriteRule ^music/gallery/{0,1}$ viewMusic.php?fileUri=$1 [QSA,L] RewriteRule ^video/all/([0-9]+)/([0-9]+)/{0,1}$ browseVideo.php?page=$2&per_page=$1 [QSA,L] RewriteRule ^video/gallery_top/{0,1}$ browseVideo.php?rate=top [QSA,L] RewriteRule ^video/gallery_top/([0-9]+)/([0-9]+)/{0,1}$ browseVideo.php?rate=top&page=$2&per_page=$1 [QSA,L] RewriteRule ^video/gallery_top/([0-9]+)/([0-9]+)/{0,1}$ browseVideo.php?rate=top&page=$2&per_page=$1 [QSA,L] RewriteRule ^video/gallery_tag/([^/.]+)/([0-9]+)/([0-9]+)/{0,1}$ browseVideo.php?tag=$1&page=$3&per_page=$2 [QSA,L] RewriteRule ^video/gallery_tag/([^/.]+)/([0-9]+)/([0-9]+)/$ browseVideo.php?tag=$1&page=$3&per_page=$2 [QSA,L] RewriteRule ^video/gallery_tag/([^/.]+)/{0,1}$ browseVideo.php?tag=$1 [QSA,L] RewriteRule ^video/gallery/all/([^/.]+)/([0-9]+)/([0-9]+)$ browseVideo.php?ownerName=$1&page=$3&per_page=$2 [QSA,L] RewriteRule ^video/gallery/all/([^/.]+)/([0-9]+)/([0-9]+)/$ browseVideo.php?ownerName=$1&page=$3&per_page=$2 [QSA,L] RewriteRule ^video/gallery/all/([^/.]+)/{0,1}$ browseVideo.php?ownerName=$1 [QSA,L] RewriteRule ^video/gallery/([^/.]+)/{0,1}$ viewVideo.php?fileUri=$1 [QSA,L] RewriteRule ^video/gallery/{0,1}$ viewVideo.php?fileUri=$1 [QSA,L] RewriteRule ^groups/all/{0,1}$ grp.php [QSA,L] RewriteRule ^groups/entry/([^/.]+)/{0,1}$ grp.php?action=group&groupUri=$1 [QSA,L] RewriteRule ^groups/category/([^/.]+)/{0,1}$ grp.php?action=categ&categUri=$1 [QSA,L] RewriteRule ^groups/keyword/([^/.]+)/{0,1}$ grp.php?action=categ&keyword=$1 [QSA,L] RewriteRule ^search/tag/([^/.]+)/{0,1}$ search.php?Tags=$1 [QSA,L] RewriteRule ^New\sPage$ viewPage.php?ID=New+Page [QSA,L] RewriteCond %{REQUEST_FILENAME} -f [OR] RewriteCond %{REQUEST_FILENAME} -d RewriteRule .+ - [L] RewriteRule ^([A-Za-z0-9_-]+)$ profile.php?ID=$1 [QSA,L] }}} If you can't solve these problems, you can disable '''Friendly profile permalinks''' in '''Settings -> Permalinks'''. After disabling permalinks you need to recompile Navigation Menu Builder in '''Admin Panel -> Builders -> Navigation Menu Builder''' by moving any block here. ---- == I see this error when I open my site: ''Warning: Missing argument 1 for !TopMenuDesign(), called in ...templates\tmpl_...\scripts\!BxTemplMenu.php on line 45 and defined in ...inc\menu.inc.php on line 250'' == Templates created for versions under 6.0.0004 will generate this error. But it can be fixed the following way: '''1)''' open '''templates/tmpl_TEMPLATE-NAME/scripts/BxTemplMenu.php''' '''2)''' replace {{{ $ret .= TopMenuDesign( ... ); }}} with {{{ $ret .= TopMenuDesign( (int)getParam('topmenu_items_perline'), '' ); }}} This should solve the problem. ---- == My security image doesn't show up. So no one can join my site == This may be caused by a few reasons: 1) You either don't have '''GD library''' or '''!ImageMagick''' installed. 2) If you still have GD library installed it may be not compiled with !TrueType fonts. 3) Another reason for this problem may be unchecked '''Use GD library for image processing''' in '''Settings -> Advanced Settings'''. 4) And at last, if you're using !ImageMagick, not GD library, you may have incorrect paths to its applications in '''inc/header.inc.php'''. In this case you should check the paths to '''$MOGRIFY''', '''$CONVERT''' and '''$COMPOSITE'''. If all this doesn't help, you can just disable security image in '''Settings -> Advanced Settings -> Enable security image on join page'''. ---- == I get this error message throughout my site: ''Fatal error: Call to undefined function: mb_internal_encoding'' == The default PHP installation does not always have the mb_string extension enabled, but the program requires that you run the PHP multibyte-string extension which is not enabled by default. In brief, in order to do this you will need to (in Windows): * uncomment out the line {{{ extension=php_mbstring.dll }}} in the '''php.ini''' file * ensure that the path to this file is set correctly, again in php.ini, for example: {{{ extension_dir = "./ext" }}} * Note that you can ensure that this file is correctly loaded by setting in php.ini: {{{ display_errors = on }}} * Restart your webserver, e.g. restart Apache * You can check via phpinfo() that '''mbstring''' appears within the information page * Here's how to do it in UNIX-based systems: http://php.net/mb_string ---- == I receive this error when I try to install Dolphin: ''The server encountered an internal error or misconfiguration and was unable to complete your request'' == 1) This is most probably caused by some '''.htaccess''' instructions which your server refuses to handle. These instructions usually are {{{ php_flag register_globals Off }}} in the .htaccess file of the main Dolphin folder and {{{ Options -Indexes }}} in the .htaccess files of the subfolders Comment out these statements, for example: {{{ # Options -Indexes }}} and try to run installation again. 2) This problem can also be caused by inappropriate permissions if your PHP is installed as CGI (common gateway interface). To check the mode your PHP is running in, create the file '''phpinfo.php''' with the following contents: {{{ }}} and upload it to the Dolphin installation directory. Then open this file in a browser. When you're sure that your PHP is running in CGI mode, you should set the permissions of all folders to 755 and files to 644. To do this quickly, you can run the following commands when you're in the Dolphin installation folder under your SSH account: {{{ find ./ -type d -exec chmod 755 {} \; find ./ -type f -exec chmod 644 {} \; }}} The file '''ray/modules/global/app/ffmpeg.exe''' (prior to 7.0 version) or '''flash/modules/global/app/ffmpeg.exe''' (since 7.0 version) should be set to 755 as well. {{{ chmod 755 ray/modules/global/app/ffmpeg.exe; }}} or {{{ chmod 755 flash/modules/global/app/ffmpeg.exe; }}} * The following instructions are to be applied only by those running '''Dolphin 6.1.4''' Now you need to let Ray determine your new permissions properly. To do so, open the file '''ray/modules/global/inc/function.inc.php''' and insert these lines of code: {{{ $sResult = ""; $bDir = is_dir($sFilePath); if(is_readable($sFilePath)) $sResult = $bDir ? "755" : "644"; if(is_writable($sFilePath)) $sResult = $bDir ? "777" : "666"; if(!$bDir && is_executable($sFilePath)) $sResult = "777"; }}} before the line {{{ return $sResult; }}} in the function '''checkPermissions($sFileName)'''. ---- == I see this error on my site: Fatal Error: Cannot apply localization == * Check that the '''langs''' folder have 777 permissions. * If your default language is not English, run thw following query in phpMyAdmin: {{{ UPDATE `GlParams` SET `Value` = 'your_lang_name' WHERE `Name` = 'lang_default' }}} where ''your_lang_name'' is the name of your default language as it is stated in the '''Name''' field of the '''!LocalizationLanguages''' table. ---- == When I try to add any fields in the Fields Builder it tells me "Unable to add New_Item. Check if New_Item is already added" == Enter phpMyAdmin (or a different database manager), open the structure of the table '''Profiles''' and remove the column '''NEW_ITEM''' (it is usually the last column in this table). Try to create a new field again. ---- == The Member Log-In Link at the far right side of my homepage header does not work == This is connected with some relocation settings on your server. To fix it, open the file '''templates/tmpl_uni/scripts/functions.php''' and replace {{{ }}} with {{{ }}} ---- == I periodically get this error on my site: "Got error 28 from storage engine" == The error comes when MySQL doesn't have any free hard disk space to write to. Check your '''tmp''' directory or delete older backups. ---- == I get the "undefined" error when trying to register my widgets == As soon as Adobe has made some changes in the base XML class of their latest Flash Player, it has become incompatible with Ray.[[BR]] So, you need to make sure that your Flash Player version is 8 or 9. If you have upgraded Flash Player to the 10th version, you should downgrade it to 8 or 9 version. ---- == My RMS widgets (Chat, IM, Video Recorder) end up in "Connecting". What should I do? == '''Use RMS''' is enabled in '''Plugins -> Ray Suite -> Base Settings''' but: 1) your RMS is not installed or not properly installed (refer to [http://www.boonex.com/trac/ray/wiki/RayServerInstall RMS installation manual]) 2) you are using Ad-Free widgets and your RMS is not properly specified in Plugins -> Ray Suite -> Base Settings (refer to [http://www.boonex.com/trac/ray/wiki/RayServerInstall RMS installation manual]) 3) you are using Free widgets and !BoonEx RMS is not properly specified in '''Plugins -> Ray Suite -> Base Settings''' (refer to [http://www.boonex.com/trac/dolphin/wiki/DetailedInstall#Step5:FinalStep Dolphin install: Final step]) 4) you have specified !BoonEx RMS but you're using Ad-Free widgets; in this case you're not eligible to use !BoonEx RMS so you should install your own one (refer to the 1) step) '''Note''': If you somehow still can't make RMS work, you can disable it by unticking the '''Use RMS''' checkbox. But in this case you won't be able to use audio/video streaming features in Ray widgets. ---- == Some of the widgets show "Not Installed" in the Ray Suite Panel though I have a regular Dolphin installation == This is typically caused by the wrong permissions on some XML files inside the '''ray/modules''' directory. Check if the following files have '''666''' permissions: {{{ ./ray/modules/global/xml/config.xml ./ray/modules/global/xml/main.xml ./ray/modules/board/xml/config.xml ./ray/modules/board/xml/langs.xml ./ray/modules/board/xml/main.xml ./ray/modules/board/xml/skins.xml ./ray/modules/chat/xml/config.xml ./ray/modules/chat/xml/langs.xml ./ray/modules/chat/xml/main.xml ./ray/modules/chat/xml/skins.xml ./ray/modules/im/xml/config.xml ./ray/modules/im/xml/langs.xml ./ray/modules/im/xml/main.xml ./ray/modules/im/xml/skins.xml ./ray/modules/presence/xml/config.xml ./ray/modules/presence/xml/langs.xml ./ray/modules/presence/xml/main.xml ./ray/modules/presence/xml/skins.xml ./ray/modules/video/xml/config.xml ./ray/modules/video/xml/langs.xml ./ray/modules/video/xml/main.xml ./ray/modules/video/xml/skins.xml ./ray/modules/mp3/xml/config.xml ./ray/modules/mp3/xml/langs.xml ./ray/modules/mp3/xml/main.xml ./ray/modules/mp3/xml/skins.xml ./ray/modules/movie/xml/config.xml ./ray/modules/movie/xml/langs.xml ./ray/modules/movie/xml/main.xml ./ray/modules/movie/xml/skins.xml ./ray/modules/music/xml/config.xml ./ray/modules/music/xml/langs.xml ./ray/modules/music/xml/main.xml ./ray/modules/music/xml/skins.xml ./ray/modules/desktop/xml/config.xml ./ray/modules/desktop/xml/langs.xml ./ray/modules/desktop/xml/main.xml ./ray/modules/desktop/xml/skins.xml ./ray/modules/shoutbox/xml/config.xml ./ray/modules/shoutbox/xml/langs.xml ./ray/modules/shoutbox/xml/main.xml ./ray/modules/shoutbox/xml/skins.xml }}} and if the permissions are wrong set them using SSH or FTP's '''chmod''' command, for example: {{{ chmod 666 ./ray/modules/global/xml/config.xml ./ray/modules/global/xml/main.xml ./ray/modules/board/xml/config.xml ./ray/modules/board/xml/langs.xml ./ray/modules/board/xml/main.xml ./ray/modules/board/xml/skins.xml ./ray/modules/chat/xml/config.xml ./ray/modules/chat/xml/langs.xml ./ray/modules/chat/xml/main.xml ./ray/modules/chat/xml/skins.xml ./ray/modules/im/xml/config.xml ./ray/modules/im/xml/langs.xml ./ray/modules/im/xml/main.xml ./ray/modules/im/xml/skins.xml ./ray/modules/presence/xml/config.xml ./ray/modules/presence/xml/langs.xml ./ray/modules/presence/xml/main.xml ./ray/modules/presence/xml/skins.xml ./ray/modules/video/xml/config.xml ./ray/modules/video/xml/langs.xml ./ray/modules/video/xml/main.xml ./ray/modules/video/xml/skins.xml ./ray/modules/mp3/xml/config.xml ./ray/modules/mp3/xml/langs.xml ./ray/modules/mp3/xml/main.xml ./ray/modules/mp3/xml/skins.xml ./ray/modules/movie/xml/config.xml ./ray/modules/movie/xml/langs.xml ./ray/modules/movie/xml/main.xml ./ray/modules/movie/xml/skins.xml ./ray/modules/music/xml/config.xml ./ray/modules/music/xml/langs.xml ./ray/modules/music/xml/main.xml ./ray/modules/music/xml/skins.xml ./ray/modules/desktop/xml/config.xml ./ray/modules/desktop/xml/langs.xml ./ray/modules/desktop/xml/main.xml ./ray/modules/desktop/xml/skins.xml ./ray/modules/shoutbox/xml/config.xml ./ray/modules/shoutbox/xml/langs.xml ./ray/modules/shoutbox/xml/main.xml ./ray/modules/shoutbox/xml/skins.xml }}} ---- == I get ''Uploading file error'' or ''Undefined'' when uploading audio/video files in Ray Media and Video Players == '''1)''' This is a common problem and most of the time it is caused by the following reasons: 1) You're trying to upload files bigger than 2 Megabytes which is the default value for PHP configuration. To fix it, edit '''php.ini''' file which is used as a configuration file by your PHP processor. You have to find two variables: '''upload_max_filesize''' and '''post_max_size''' and assign bigger values to them. 2) You don't have .htaccess or have it corrupted in the '''ray''' folder. Here's the code that this file must contain: {{{ SecFilterEngine off }}} 3) You have the correct .htaccess file but it gets overridden by other Apache settings on your server. You should contact your hosting provider in this case. 4) You don't have the proper '''ffmpeg.exe''' in '''ray/modules/global/app''' or it doesn't have '''777''' permissions (readable, writable, executable). In this case change the permissions and make sure the ffmpeg.exe file is applicable to your operating system: Linux (provided with Dolphin), [http://www.boonex.com/ffmpeg_win.zip Windows] or [http://www.boonex.com/ffmpeg_freebsd62.tgz FreeBSD]. 5) You have incorrect permissions for the following folders: '''ray/modules/mp3/files/''', '''ray/modules/movie/files''' and '''ray/modules/music/files''' These folders must have '''777''' permissions. 6) You have PHP '''exec()''' function disabled on your server. Advise with your hosting provider in order to figure this out. '''2)''' If you still can't make it work, please follow this diagnostic procedure: * To determine the reason of such problems, create a php file with the following contents, upload it in your Dolphin's root directory and run it in your browser window: {{{ echo "
PHP INI settings
"; echo "
safe mode = ".ini_get('safe_mode'); echo "
disabled functions = ".ini_get('disable_functions'); echo "
max execution time = ".ini_get('max_execution_time'); echo "
post_max_size = ".ini_get('post_max_size'); echo "
upload max filesize = ".ini_get('upload_max_filesize'); echo "

ffmpeg output
";
$s = realpath("ray/modules/global/app/ffmpeg.exe");
echo `$s -version 2>&1`;
}}}

'''Output analysis:'''

''safe_mode ='' if this variable has non-empty value then ffmpeg will not be able to execute; in this case advise with your hosting about disabling safe mode.

''disabled_functions ='' if this variable contains '''exec''' then this function is forbidden by hosting and thus your script won't be able to run ffmpeg.

''max_execution_time, max_input_time ='' it's usually set to 30 seconds; you should increase its value several times.

''post_max_size ='' the size of POST data that PHP can handle; it's usually set at 2M; you should increase its value up to 8M or more.

''upload_max_filesize ='' the size limit of uploaded files; it's usually set at 2M; you should increase its value up to 8M or more.

''ffmpeg output:'' - this command will result in a message like this:

{{{
FFmpeg version SVN-r9115, Copyright (c) 2000-2007 Fabrice Bellard, et al.
  configuration: --enable-libmp3lame --enable-xvid --enable-x264 --enable-gpl --enable-libvorbis --enable-libogg --enable-libtheora --enable-liba52 --enable-libamr-nb --enable-libamr-wb --enable-libfaad --enable-libfaac --enable-pthreads --disable-shared --enable-static
  libavutil version: 49.4.0
  libavcodec version: 51.40.4
  libavformat version: 51.12.1
  built on Aug 14 2007 18:26:46, gcc: 3.4.5 (Gentoo 3.4.5, ssp-3.4.5-1.0, pie-8.7.9)
ffmpeg      SVN-r9115
libavutil   3212288
libavcodec  3352580
libavformat 3345409
}}}

If you didn't see anything like this your hosting doesn't allow your web script to run '''exe''' files (this can be the result of safe_mode and disabled_functions values, see above).

== Possible ways to fix this problem: ==

        * '''safe_mode''' and '''disabled_functions''' issues can be resolved only by hosting provider.

        * Make sure you have set appropriate PHP settings for uploading media files.

        a) If PHP on your server is running in CGI mode, you need to create a '''php.ini''' file with the following contents:
        {{{
upload_max_filesize=300M
post_max_size=300M
max_input_time=3000
max_execution_time=3000
memory_limit=128M

        }}}

        Then copy this file to the ray/modules/movie/files subfolder

        b) If PHP on your server is running as Apache module, place this code in the '''.htaccess''' file which resides in the main Dolphin directory:
        {{{
php_value upload_max_filesize 300M
php_value post_max_size 300M
php_value max_input_time 3000
php_value max_execution_time 3000
php_value memory_limit 128M

        }}}

        * You can also change some MySQL settings to prevent connection timeouts when uploading big files:
        Open the file '''ray/modules/global/inc/db.inc.php''' and insert the following commands
        {{{
mysql_query ("SET @@local.wait_timeout=9000;");
mysql_query ("SET @@wait_timeout=9000;");
mysql_query ("SET @@local.interactive_timeout=9000;");
mysql_query ("SET @@interactive_timeout=9000;");
mysql_query ("SET @@local.connect_timeout=9000;");
mysql_query ("SET @@connect_timeout=9000;");

        }}}

        after the line
        {{{
@mysql_select_db($this->sDb, $this->rLink);
        }}}

----

== My widgets result in "Invalid parameters" error and my Ray Base results in "Not Installed" ==



  * This problem is mostly caused by unsuccessful integration of Ray widgets.[[BR]]
  In this case refer to [http://www.boonex.com/trac/ray/wiki/RayIntegration Ray Integration Manual].

  * Referring to Dolphin, it can be caused by efforts to replace the '''ray''' folder with that from the Ray package and install it which is obviously not needed because Ray is already integrated into Dolphin.[[BR]]
  Here are the steps of fixing it in this case:[[BR]][[BR]]
    * Backup the media files if they already have been uploaded by your members. They reside in the folders '''ray/modules/WIDGET_NAME/files''', where '''WIDGET_NAME''' stands for the name of the widget ('''chat''', '''im''', etc.)[[BR]][[BR]]
    * Replace the whole '''ray''' folder with that from your original Dolphin package (for example Dolphin 6.1.4 [http://get.boonex.com/Dolphin-v.6.1-Free Free] or [http://get.boonex.com/Dolphin-v.6.1-AdFree AdFree])[[BR]][[BR]]
    * Set the following permissions using an FTP or SSH client
    {{{
chmod 777 ./ray/modules/board/files ./ray/modules/chat/files ./ray/modules/im/files ./ray/modules/movie/files ./ray/modules/mp3/files ./ray/modules/music/files ./ray/modules/global/app/ffmpeg.exe

chmod 666 ./ray/modules/board/xml/config.xml ./ray/modules/board/xml/langs.xml ./ray/modules/board/xml/main.xml ./ray/modules/board/xml/skins.xml ./ray/modules/chat/xml/config.xml ./ray/modules/chat/xml/langs.xml ./ray/modules/chat/xml/main.xml ./ray/modules/chat/xml/skins.xml ./ray/modules/desktop/xml/config.xml ./ray/modules/desktop/xml/langs.xml ./ray/modules/desktop/xml/main.xml ./ray/modules/desktop/xml/skins.xml ./ray/modules/global/data/integration.dat ./ray/modules/global/inc/cron.inc.php ./ray/modules/global/inc/header.inc.php ./ray/modules/global/xml/config.xml ./ray/modules/global/xml/main.xml ./ray/modules/im/xml/config.xml ./ray/modules/im/xml/langs.xml ./ray/modules/im/xml/main.xml ./ray/modules/im/xml/skins.xml ./ray/modules/movie/xml/config.xml ./ray/modules/movie/xml/langs.xml ./ray/modules/movie/xml/main.xml ./ray/modules/movie/xml/skins.xml ./ray/modules/mp3/xml/config.xml ./ray/modules/mp3/xml/langs.xml ./ray/modules/mp3/xml/main.xml ./ray/modules/mp3/xml/skins.xml ./ray/modules/music/xml/config.xml ./ray/modules/music/xml/langs.xml ./ray/modules/music/xml/main.xml ./ray/modules/music/xml/skins.xml ./ray/modules/presence/xml/config.xml ./ray/modules/presence/xml/langs.xml ./ray/modules/presence/xml/main.xml ./ray/modules/presence/xml/skins.xml ./ray/modules/shoutbox/xml/config.xml ./ray/modules/shoutbox/xml/langs.xml ./ray/modules/shoutbox/xml/main.xml ./ray/modules/shoutbox/xml/skins.xml ./ray/modules/video/xml/config.xml ./ray/modules/video/xml/langs.xml ./ray/modules/video/xml/main.xml ./ray/modules/video/xml/skins.xml

    }}}
    * Open the file '''ray/modules/global/inc/header.inc.php''' and replace  * '''[path_to]''' with the server path to Dolphin's folder, for example '''/home/user/community/ * '''[[BR]][[BR]]
    * Log into Dolphin's Admin Panel and navigate to '''Plugins -> Ray Suite'''. Register all your widgets and specify your RMS in '''Base Settings'''. Please refer to [http://www.boonex.com/trac/dolphin/wiki/DetailedInstall#Step5:FinalStep Dolphin Installation Manual].[[BR]][[BR]]
    * Restore the media files from backup placing them into the same folders where they used to be.

----

== My Free/Ad-Free licenses don't work resulting in "wrong license number" message ==

    * The most common reason for this is that you're trying to apply your licenses on incompatible package, i.e. you're trying to register Free Ray widgets with Ad-Free licenses or vice versa. To check the version of your widgets, open the following file inside each widget's folder:

    {{{
    inc/constants.inc.php
    }}}

    Search for the version number which looks like this: 

    {{{
    'code' => "chat_3.0.0000_free" or
    }}}

    {{{
    'code' => "chat_3.0.0000"
    }}}

    The Free widgets contain '''_free''' wording in these lines, while the Ad-Free ones don't.

    To replace the current Ray package in Dolphin with the appropriate one, please refer to [wiki:GenDolFAQs#HowcanIreplaceFreeRaywidgetswithAd-Freeonesandviceversa Ray FAQ].

----

== My Ray widgets show "Not Registered" on user end though they have been successfully registered on admin end ==

	* You're probably using the wrong license number. In order to check it out, open '''ray/modules/module_name/xml/main.xml''' and replace '''CDATA[enabled]''' with '''CDATA[not registered]'''. Then try to register your widgets again and you will probably encounter a problem mentioned in the previous paragraph.
	
	* If there's no problem registering the widget again, but it still appears to be unregistered on users end, you have most probably installed 3.1 widgets together with 3.0. In this case you need to install all widgets of the same verson.


----

== My Audio/Video widgets (Chat, IM, Video Recorder and Whiteboard) can't connect ==

	
	* You need to [http://www.boonex.com/trac/ray/wiki/RayServerInstall install RMS], enable it and specify its IP address in '''Admin Panel -> Plugins -> Ray Suite -> Base Settings'''.

    Set the following ports: '''RMS Port: 1935''', '''RMS HTTP Port: 5080'''.

    If you still experience RMS connection problem with Free widgets, please contact [mailto:support@boonex.com BoonEx Support Department] and provide your site's full URL.

----

== I can't enter non-latin characters in Flash Applications ==

If you're going to use non-latin characters in Flash Applications, you will have to disable the transparent mode by unticking the corresponding checkbox in Flash Appplications Settings: '''Admin Panel -> Plugins -> Ray Suite -> Settings -> Send Flash applications backward (will support only english language)'''.

But you should be aware that doing so will make other objects on your web pages unable to overlap Flash applications.

----

== Ray 3.1 !HotFix == 

Ray 3.1 !HotFix. Download [http://get.boonex.com/Ray-v.3.1-HotFix-Free Free] or [http://get.boonex.com/Ray-v.3.1-HotFix-AdFree AdFree] version.
 
This Hotfix is with a minor fixes in Ray modules. They are:

    * Problem with version check in Ray Base
    * Corrections of buttons representation in VPlayer abd VRecorder
    * Minor bugs in Chat and IM interface

The archives contain only '''''.swf''''' files. This !HotFix does not require any specific instruction on how to apply it. You should just upload '''''.swf''''' files according to their location in Ray modules and that's all.

----

== When I open the video recorder, it's connecting forever. In the admin panel it opens up ok, but hangs when I click on a video == 

You have recorded a corrupted video file.

You need now to delete the folder that belongs to the member and is located in the '''rms_path/webapps/video/streams''' folder.

Then you need to delete a few lines of code from the file '''rms_folder/webapps/video/streams/config.xml'''

The lines look like these:
{{{
   
    boonex.us_7577
    
     boonex.us_7577
     tazmaster776
     http://www.boonex.us/tazmaster776
     0
     0
    
    
}}}

----

== Some or all of my widgets keep on loading and do not work. I can't see some buttons in Flash applications. ==

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 '''admin/phpinfo.php'''.

To fix it, you will need to set all folders permissions to 755 and all files to 644. The file '''ray/modules/global/app/ffmpeg.exe''' should be also set to 755.

Now, if you have Dolphin 6.1.4 version, you need to let Ray determine your new permissions properly. To do so, open the file '''ray/modules/global/inc/function.inc.php''' and insert these lines of code:
{{{
$sResult = "";
$bDir = is_dir($sFilePath);
if(is_readable($sFilePath)) $sResult = $bDir ? "755" : "644";
if(is_writable($sFilePath)) $sResult = $bDir ? "777" : "666";
if(!$bDir && is_executable($sFilePath)) $sResult = "777";

}}}
before the line
{{{
return $sResult;

}}}
in the function '''checkPermissions($sFileName)'''.

2) This problem can 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 '''ray/modules/MODULE_NAME/skins/index.php and replace the line
{{{
$sFile = $aResult['current'] . "." . $aResult['extension'];
}}}
with
{{{
$sFile = "default.swf";
}}}

'''''MODULE_NAME''''' stands for '''board''', '''chat''', '''im''', '''movie''', '''mp3''', '''music''', '''presence''', '''shoutbox''' or '''video'''.


----

== When accessing Orca, I get error "Warning: fopen(.../orca/conf/params.conf) [function.fopen]: failed to open stream" ==

This problem occurs only on those sites where PHP is running as an Apache module. On such sites, the files created by scripts (such as Dolphin or Orca), don't belong to the owner of the script's directory. That's why they sometimes become inaccessible after some actions on the site. This can be overriden by placing 666 permissions on such scripts:

  1) FIX:
  * Create a script in Dolphin's home directory with the following contents:
  {{{

  }}}

  * Name the script with the '''.php''' extension, for example: '''orca_fix.php'''

  * Run the script in a browser, for example: '''!http://dolphin_url/orca_fix.php'''

  2) If you still get this error, try to do the following:
     1) Delete the folders '''orca/classes/en''', '''orca/js/en''', '''orca/layout/base_en''', '''orca/layout/uni_en''' and the file '''orca/conf/params.conf''' (the subfolder '''en''' corresponds to the English language, while your subfolder may be named '''fr''' or '''de''' depending on what language you installed).

     2) Compile [http://www.boonex.com/trac/orca/wiki/OrcaBeta2PostInstall Orca languages].

     3) Apply the above FIX. 

----

== When trying to compile Orca languages I get error "Language files compilation have been failed" ==

See the [wiki:GenDolTShooter#WhenaccessingOrcaIgeterrorWarning:fopen...orcaconfparams.conffunction.fopen:failedtoopenstream previous solution]

----

== I have problems with video upload and play in Dolphin 7.0 ==

Well, first of all, I would like to tell you about one very important hosting setting - it is the mod_security module. It causes uploads result in '''403 error'''. But BoonEx still predicted such possible hindrance and put some instructions in the file '''flash -> .htaccess'''. But these instructions will not work in some cases, especially if your server has '''mod_security2''' installed. So, you need to contact your hosting provider and ask them disable '''mod_security''' for your hosting account.

The other problem is not visible right away unlike the previous one. This problem is caused by improper crons setup or inability to run '''ffmpeg.exe'''

1) the crons can be set up at any time after or during Dolphin installation, but only when they are set up and running, your video files will start to get processed. You can find how to set up your crons [http://www.boonex.com/trac/dolphin/wiki/DetailedInstall70#SettingupCronjobs here].

Here's how the crons work:

   1) The cron '''bx_videos''' runs every 5 minutes; but when processing is not completed (for example there are 20 new videos, but only 2 are processed) it will process the other videos every time the main '''cron.php''' runs (by default every minute). So, basically if there are many videos, they will be processed every minute after the first 5 minutes have passed.

   2) Only 2 videos are processed during the process I described above. But this value can be easily changed in '''Administration -> Modules -> Flash Apps -> Video Player -> Settings -> Maximum number of processing files'''. Just increase this value and your videos will be processed faster.

   3) Now the most interesting part - even the 5-minute interval can be changed. You will need to do that in your database (basically phpMyAdmin). You need the table '''sys_cron_jobs''' where you will find the 5th row, whose name is '''bx_videos'''. You will need to change the value for the '''time''' column of this row. By default it shows '''*/5''' which means '''every 5 minutes'''. You can change this to '''*/10''' to run it every 10 minutes or to '''*/60''' to run it every hour.
   After making these changes, you will necessarily need to clean the cache in your Administration panel. You may only clean the db cache.

   4) Processing time of every video depends on its size and free server resources. Big videos (100 megabytes or more) may be processed during a minute or more.


2) the file ffmpeg.exe resides in the '''flash -> modules -> global -> app''' folder and it needs to have executable permissions, that is 777 on Apache-module servers and 755 on CGI servers. This file should be also compatible with your operating system.

3) your hosting should allow executable files, otherwise you will not be able to run ffmpeg.exe

4) until your video files are not processed, you should not approve them in '''Administration -> Modules -> Videos'''. Approved videos will not be ever processed. So, you need to allow some time to pass by and then approve the videos. If you still did this before they got processed, you can change their statuses back to pending in the table '''RayVideoFiles'''. You even can refresh the contents of this table to see the current statuses of all uploaded files. It is amazing but the processed files will acquire the failed status (indicating that they were not yet approved). So if you see such statuses, you can approve those files. In the next versions BoonEx will make this process more human-friendly.