Hotaru CMS Via Subversion

**Nick** · 08-02-2009, 12:38 PM

If you would prefer to use Subversion, the Hotaru CMS project is hosted at Assembla, here:

http://www.assembla.com/spaces/HotaruCMS

The SVN url is:

http://my-svn.assembla.com/svn/HotaruCMS/trunk/

If you'd like to help update the SVN with bug fixes and new features, please read this.

**shibuya246** · 01-24-2010, 03:51 PM

cant figure out how to use SVN. any hints? i see this page http://my-svn.assembla.com/svn/HotaruCMS/trunk/ but dont know how to get those onto my computer

**Nick** · 01-24-2010, 04:08 PM

These steps should help:

Originally Posted by Nick

1. Download TortoiseSVN, install it, restart your computer
2. Right-click on the desktop and make a folder called "hotaru"
3. Right-click the folder and click "SVN Checkout" and put http://my-svn.assembla.com/svn/HotaruCMS/trunk/ in the "URL of repository" and click OK.
4. Hotaru will be downloaded to the folder.
5. Whenever there's a new commit in the Event Stream, right-click the folder and click "SVN Update" to include the latest changes.

One thing to note: It will take you ages to upload that folder to the web because of all the .svn folders in it. I suggest you right-click the folder, click Tortoise SVN -> Export... and export all versioned files to another folder. That will give you a copy without all the little green circles and .svn folders.

Originally Posted by Jason

For anyone that really hates rebooting, you don't technically need to do it. TortoiseSVN will work just fine after it's been installed. The restart requirement might have been a throwback to the good ol' days of Windows shell integration (a la Win98).

**shibuya246** · 04-20-2010, 03:22 AM

Ok, I think I found the answer. For those that want to install hotaru using svn directly to your apache machine, here are the instructions.

Command Line Steps
Login to your server using a command line editor like PuTTy. (Make sure you are logged in as the correct user and don't issues the "su -" command or it will change the ownership of the files you bring in from svn to the admin group. This may lead to owner/permission problems and make files inaccessible from the web.)

Type the following at your command prompt, starting from the directory where you want to install Hotaru.

and then check out (Subversion command "co"), or extract from the repository (Subversion command "export"), the latest "trunk" version of WordPress.

Code:

svn co http://my-svn.assembla.com/svn/HotaruCMS/trunk/ .

Note the "co" command after "svn". This means checkout. The other alternative is "export" for export.

Code:

svn export http://my-svn.assembla.com/svn/HotaruCMS/trunk/ .

Also, the trailing slash on the URL, and the dot "." at the end of the command, are important. They make sure the downloaded files from svn end up in the current directory. If you leave off the dot it would create a totally new installation directory (a "trunk"), which is not what you want if the current directory is the intended installation directory.

root folder installation

If you are installing to your root folder (recommended), e.g. "public_html" instead of a subfolder, then you may need to use the "--force" command as well. This will occur if there are already files or folders in the "public_html" folder.

Code:

svn co --force http://my-svn.assembla.com/svn/HotaruCMS/trunk/ .

or

Code:

svn export --force http://my-svn.assembla.com/svn/HotaruCMS/trunk/ .

"checkout" v. "export"
If you only want to install once and then not use svn for updating later I recommend the "export" command as it will not copy the ".svn" files across from every folder. This will be quicker.

If you want to use the svn command to keep your version of Hotaru up-to-date then the slower "co" method is required.

Final Steps
After you have completed the download, you will need to copy hotaru_settings_default.php to hotaru_settings.php and edit that file to include your database username/pwd settings. If you have not created a database for Hotaru you can do that now, then edit the files.

Once complete you can run the install.php script in your web browser

Code:

http://yoursitename.com/install/install.php

Note: this is for a new install of Hotaru not an upgrade.

Later, when you want to upgrade you can log into the command line of your server again, go to the directory you have Hotaru installed on and run the following svn update command:

Code:

svn up

This will overwrite all changed Hotaru files, but should not affect any themes modifications or other customized files in your themes folder.
Note: To be safe you should always make a backup first, just in case.

I used the

Code:

svn export --force http://my-svn.assembla.com/svn/HotaruCMS/trunk/ .

command myself and was able to have all the files downloaded in about 5 seconds. The "co" command would take longer, maybe a few minutes at max.

Good luck