SkyBlueCanvas Installation Instructions
June 16, 2008
NOTE
If you are upgrading from an earlier version of SkyBlueCanvas, please refer to the article on Upgrading SkyBlueCanvas.
What You Will Need (System Requirements)
- PHP v4-5.x running on Linux, Unix, FreeBSD, OpenBSD or MacOS X
Sorry, Windows servers are not supported at this time - A FTP Client (Get FileZilla from Mozilla for free)
- mod_rewrite enabled (optional but recommended)
- JavaScript enabled in your web browser
FTP Installation
- Download the SkyBlueCanvas ZIP or TAR file and extract the contents into a folder on your compter.
- Connect to your web server using your FTP client and upload the SkyBlueCanvas code.
- Change the file permissions of the entire skyblue folder to 755 (some servers may require 775). Apply the changes recursively to all directories and files in the skyblue folder.
- Rename the file /skyblue/htaccess.txt to .htaccess (dot htaccess) to enable SEF
URLs - Point your web browser to http://yourdomain.com/ or if you have installed SkyBlueCanvas in a sub-directory of your main domain, http://yourdomain.com/sub_directory_where_skyblue_is_installed/.
- Follow the instructions that appear on your screen. This will be a simple form you need to fill in.
- When you log in to the Admin Control Panel, go to Admin > Settings > Default Info, and enter the info in the form.
- That’s it.
Command-line Installation (Advanced Users)
- Download the tar file and place it in the root of your new website.
- Unpack the tarball (tar -zxf skyblue.tar.gz)
- Rename the file /skyblue/htaccess.txt to .htaccess (dot htaccess) to enable SEF
URLs - Change the owner/group of the directory contents (chown -R www:www `*`)
- Change the file permissions of the entire skyblue folder to 755 (some servers may require 775). Apply the changes recursively to all directories and files in the skyblue folder.
- Point your web browser to http://yourdomain.com/ or if you have installed SkyBlueCanvas in a sub-directory of your main domain, http://yourdomain.com/sub_directory_where_skyblue_is_installed/.
- Follow the instructions that appear on your screen. This will be a simple form you need to fill in.
- When you log in to the Admin Control Panel, go to Admin > Settings > Default Info, and enter the info in the form. This will enable emailing through your site and will set the full URL so that RSS feeds will point to your site pages.
- That’s it.
Trouble Shooting
If you get an error when you point your browser to the Setup Wizard, try setting the permissions of the /skyblue/ directory to 777. It is not recommended that you leave the permissions set to 777. The first screen of the Setup Wizard will suggest the proper settings. Once you have completed the installation, you can change the file permissions to the correct setting. If you continue to have trouble, check your hosting provider’s documentation or contact their Support Center and ask for “the correct settings for their server to allow web software to read and write files”.
You are now ready to start adding your site’s content. You can log into the SkyBlueCanvas admin control panel by going to http://www.yourdomain.com/admin.php.
Enjoy!
Discussion
Post a comment
- SkyBlueCanvas CMS
40 Articles
- Installation and Setup
1 Article
- Skins and Templates
2 Articles
- Plugins
7 Articles
- Fragments
4 Articles
- Extensions
12 Articles
- Installation and Setup
- Press Releases
2 Articles
Hi,
Methinks I would be helpful to list upfront, the requirements for use of this CMS. I searched, did not find the info and departed the site.
Miguel | August 4, 2008, 2:37 pmMiguel,
Thanks for pointing out my oversight. Can’t believe I forgot to include that. The installation instructions have been updated.
Scott
admin | August 4, 2008, 2:49 pmI’ve installed it over xampp running in windows xp, it works fine for me except when I try to access media manager, it says that maximum execution time has been reached, I think it’s a problem with some apache script path, any idea?. Thanks in advance
anestesiador | August 22, 2008, 12:00 amI’ve tried installing using both methods and I’m still having problems. Using the FTP installation method, I ran into permissions issues and couldn’t complete the install as directed. Using the shell install, I couldn’t get the chown command to take, getting an “Operation Not Permitted” reply on each file.
The FTP installation got me closer, but I still had problems. Is there a more detailed description of what the permissions should be for each subdirectory? Please advise. Thanks.
Joel S. | August 27, 2008, 3:15 pmanestesiador,
I am not familiar at all with Windows and have never installed SBC on Windows. My first guess would be that I have used the wrong directory seperators (forward slash rather than back-slash). Try posting your issue to the forum (http://forum.skybluecanvas.com) and maybe someone there can help.
Scott
admin | August 28, 2008, 9:19 amJoel,
The permissions should be 755 for all directories and files. With some shared hosting server configurations we have found that 775 is required.
The `chown` will not work on a shared hosting environment because you probably don’t have sufficient privileges to change the owner of a file/dir. However, you can try doing:
chmod -R 775 skyblue_root_dir_name
Hope this helps,
Scott
admin | August 28, 2008, 9:22 amHey there!
I get this when I try to access the folder right off the bat:
Parse error: syntax error, unexpected T_STRING, expecting T_OLD_FUNCTION or T_FUNCTION or T_VAR or ‘}’ in /nfs/c02/h02/mnt/22794/domains/f6designlogic.com/html/clients/ilmercato/includes/router.php on line 32
Most of the includes (when I try to go to /setup/ etc) have errors like this. Is there something I missed during the install?
Humanv3 | November 26, 2008, 12:23 amI seem to be having the same problems as Humanv3. I’ve changed all the file permissions to 0755 (0775 won’t run as group writing is not allowed on my host server) and I’m getting a similar error:
Parse error: parse error, unexpected T_STRING, expecting T_OLD_FUNCTION or T_FUNCTION or T_VAR or ‘}’ in /share/storage/01/ar/arthurassociates/skyblue/includes/request.php on line 9
I’m currently running CMSimple which works just fine, so I’m thinking it must be something quite simple that’s stopping the admin script from running.
Hope someone can help as I really like the look of Skybluecanvas.
Andy A. | November 27, 2008, 9:20 amAndy,
The issue is related to PHP4. Two of the classes in SBC use PHP5-only constructs that I overlooked when I posted the build you have. I have fixed the problem in the latest build RC1-r156. If you download the latest build it should work fine.
Thanks,
Scott
admin | November 27, 2008, 10:11 amScott,
Many thanks, will give it a try later. I’m very much looking forward to getting it running.
Andy
Andy A. | November 28, 2008, 3:42 amScott,
Wiped the files from the webserver, downloaded latest build and reinstalled, but still no luck, exactly the same error message. Can you think of anything else to try?
Andy A.
Andy A. | November 28, 2008, 11:14 amAndy,
Sorry about that. It appears I overlooked one of the classes when removing the PHP5 keywords. I have posted a new build (RC1-r157).
Scott
admin | November 28, 2008, 11:38 amScott,
Success! I’m at the setup stage. Many thanks.
Andy
Andy A. | November 28, 2008, 2:42 pmDuring Sky Blue setup my web site URL cannot be saved.
Sky Blue start correctly as ‘http://acer9100.org/skyblue’ works fine and return admin page which then ask my URL address but all my tries are refused, ie.http://acer9100.org
So which web site address should I enter to fullfil Skye Blue installation ?
Regards.
Bye,
Bruno
Bruno Costacurta | November 29, 2008, 4:04 pmPlease cancel previous post.
I forgot ‘chown -R www-data:www-data’ on skyblue directory.
It works now.
Bye,
Bruno
Bruno Costacurta | November 29, 2008, 4:19 pmBruno,
Be sure to set the URL to http://acer9100.org/skyblue - including the subdirectory. Don’t worry if you have already gone through the setup. You can change this setting in Admin > Settings > Default Info.
Cheers,
Scott
admin | November 29, 2008, 6:33 pmI get the following error when I try to install skybluecanvas:
Fatal error: Call to undefined function posix_getegid() in /home/content/j/o/h/*******/html/skyblue/includes/filesystem.php on line 480
This is after having uploaded the SBC file to my web server, and then pointing my browser to http://mydomain.com/skyblue/
I am using Godaddy as my webhost with Linux and PHP 5.x and have tried both 755 and 775 as permissions for the skyblue folder.
How do I solve this issue?
johann | December 17, 2008, 1:18 amI should add that I’m using the latest SBC v1.1RC build dated Sun Dec 7 00:36:43 EST 2008 downloaded from your website an hour ago.
I’m using FileZilla FTP on Mac OS X Leopard with Safari.
johann | December 17, 2008, 1:26 amApparently GoDaddy has the Posix extension for PHP disabled. There is a thread on our forum that explains a simple workaround. You can find the information at http://forum.skybluecanvas.com/viewtopic.php?f=3&t=221&p=1050&hilit=posix#p1050
Thanks,
Scott
admin | December 17, 2008, 8:00 amI have uploaded a new build (r201) to fix the Posix Disabled error.
admin | December 17, 2008, 8:49 amScott,
Thank you for the new build. It gets us a bit further: the configuration screen does appear in my web browser and all settings appear green, except for one: Posix Library > Current Value: Off > Expected Value: Enabled.
How do I enable it?
Also, the following warning appears at the top of the screen:
“Warning!
Due to your server configuration, SkyBlueCanvas is unable to accurately determine the exact file permissions needed to run the software. You can still install the software but may need to set your file permissions to 777. You can contact your hosting provider to ask about the possible implications of doing so.”
My current permissions are set to 775, which agrees with the expected permissions.
Thanks,
Johann
johann | December 17, 2008, 6:34 pmI guess I could improve the wording of the warning message a bit. But the answer to your question is that you cannot enable the Posix Library. It has to be compiled into the PHP engine by your hosting provider. They probably have it disabled for supposed security reasons.
The reason the permissions say you meet the expected permissions but you still get the warning is that without the Posix Library there is no way to accurately determine what the correct “expected” values are. I chose 775 as the default expected values because on a properly configured web server, 775 would be what one would expect. However, a lot of shared hosting providers do not have their servers configured the way I would consider to be correct.
You can go ahead with the install. It should work without trouble. If the installation does not work, follow the instructions I posted on the forum (http://forum.skybluecanvas.com/viewtopic.php?f=3&t=221&p=1050&hilit=posix#p1050).
The only thing the Install Wizard does, really, is creates the password file, sets the site URL and tries to verify the file permissions. If the file permissions portion doesn’t work, chance are the system will still run anyway.
Scott
scott | December 17, 2008, 6:47 pmI was using Joomla and found that too intense for my liking and wanted something a bit easier I just installed the blue sky software and had the site up in no time. Thanks a lot for your efforts.
Fred | January 4, 2009, 3:16 pmCool. I’m glad you like it.
scott | January 5, 2009, 1:17 pmFor Ubuntu users - instead of:
chown -R www:www `*`
try:
chown -R www-data:www-data bluesky/
where ‘bluesky/’ is the directory you installed everything to.
However, I am experiencing a different issue. When I go to the main/home page, all is well. When I click on the main menu to go to any other page, I get the 404 Not Found error.
I see that the files appear to be in the /var/www/skyblue/data/stories directory, but for some reason the engine can’t see them. I’ve verified that permissions are correct.
Any thoughts on what might be happening? FWIW, in the setup, I’ve tried both ‘localhost’ as well as the canonical name of the machine (which happens to be ‘ubuntuhh32′). Same result both ways.
Greg | February 5, 2009, 1:54 pmThanks for the tip regarding Ubuntu. I’ll add a note to the instructions as soon as I have time.
Regarding the menu links error, it appears that you have an old .htaccess file in your web root. You’ll need to update this file with the htaccess.txt file included with SBC.
Scott
scott | February 5, 2009, 1:58 pmWell, just to make sure - I re-invoked the .htaccess again. I re-copied over from the ’skyblue_v1.1-Stable-r237.zip’ archive. I restarted Apache - still no joy. Here’s what is in the .htaccess I have:
RewriteEngine on
ErrorDocument 404 404-page-not-found
RewriteRule xml/(.*)\.xml$ index.php?route=404-page-not-found
RewriteRule email/(.*)$ index.php?route=404-page-not-found
RewriteRule ads/(.*)$ index.php?route=404-page-not-found
RewriteRule gadgets/(.*)$ index.php?route=404-page-not-found
RewriteRule metrics/(.*)$ index.php?route=404-page-not-found
RewriteRule modules/(.*)$ index.php?route=404-page-not-found
RewriteRule data/plugins/(.*)$ index.php?route=404-page-not-found
RewriteRule tmp/(.*)$ index.php?route=404-page-not-found
RewriteRule stories/(.*)$ index.php?route=404-page-not-found
RewriteRule (.*)data/(.*)$ data/$2
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php?route=$1 [L,QSA]
Is there something else I’m missing? BTW, I get the same result on my Ubuntu 8.04 server as well as Mac OS 10.4 (Tiger).
Greg | February 8, 2009, 4:33 pmAre you sure you have AllowOverrides enabled in your httpd.conf file? It sounds like the htaccess over-rides are just being ignored altogether. If I am not mistaken, the AllowOverrides conig setting is not enabled in a default install of Apache, so you need to enable it explicitly.
Scott | February 8, 2009, 4:42 pmScott - you were correct. I’ve changed that an now all is well. Actually, I had to have a directory directive to AllowOverrides in the httpd.conf file, and then everything just worked. I actually stumbled over this while setting up another CMS, but checked back here to update my comments.
Greg | February 9, 2009, 3:43 pmScott,
I want to install a local test environment for SBC development. Windows/Apache (I see that some folks have it running on window). Are there any special instructions for this…
Everything seems to be running properly, however I cannot seem to load/access the index.php file? (Yes, I have configured Apache’s httpd.conf - ru)
I search you discussion, but did not find this topic…
Charles
Charles | June 14, 2009, 1:33 pm