Post by kpgalligan on Feb 18, 2008 15:17:25 GMT 7
I bought the thecus without knowing all these modules were available. I was very excited to find there was an svn module, and that the box essentially ran linux, which I work in daily, so its like I'm right at home.
The svn module rules, but I had a really hard time setting it up. As I am myself an on again/off again open source contributor I know the one thing I rarely do is write documentation. The module is excellent. The docs are pretty good. I figure I'll throw in what I did and if you're having trouble, maybe you can cobble together the install.
Requirements:
SVN Module
www.onbeat.dk/thecus/index.php/N2100_Module:_SVN
SSH Module (you may not need this. I'll explain)
www.onbeat.dk/thecus/index.php/N2100_Module:_SSH
Downloaded those modules? Great. Open your browser config panel and log in. Go to "System > Module Mgnt".
Install, then enable SVN. Optionally SSH.
*SSH Module* I installed this. I logged in to the machine, and created a directory called '/raid/svndata'. This is the dir that will hold the repositories. *If you don't want to install SSH*, go to "Storage > Folder". Create a folder. That folder will actually map to '/raid/[folder name]'. So, if you made a folder called 'awesomedir', it would actually map to the path '/raid/awesomedir'.
I don't know how the paths work when you're doing jbod or single disk. You'll have to figure that out. In that case, I'd highly suggest installing SSH and seeing what's happening under the hood. Anyway...
So, now, you should have SVN installed and enabled, and a directory into which repositories will be put. We'll say '/raid/svndata' from now on.
Go back to "System > Module Mgnt", and click "[Thecus] SVN". We're going to set up one repository and get it working. After that, you'll have to figure out the rest.
*svnserve settings*
Go to the part called "svnserve settings". For "Listen port" type in 3690. Its the default (you can use what you want, but humor me and just type that in). In "Listen host", type in the IP address of your Thecus box. If you don't know how to get this you probably shouldn't be installing a version control system. Finally, in "Root path", type in the directory we created above. The *FULL* directory, as in '/raid/svndata'. Make sure the directory exists, and you type in the full path. You will not get an error if you do this stuff wrong. Click Apply.
*Users*
In the "Users" section, type in a name in "Name" and a password in "Password". "Name" is a username, so use something normal for now (no spaces or funky characters. In fact, to make things easy, type in 'newuser', and password 'password1'. Make it better later). Click "Add/Change".
*Repository management*
Here is where you *actually* make the repository. Type in a repository name in "Name". For now, try 'svn'. Click 'Add'. If you have SSH installed, do an 'ls' on your repository directory (mine is '/raid/svndata'). You should see a folder for your new repository. If you don't have SSH, try opening that folder you made with the browser tool. If you don't see a repository in the directory, you did something wrong and need to fix it before you move on.
*Authorization settings*
Select your new user and "Read and write". Click Add.
OK. You should have a new repository and whatnot. Here's where I ran into a problem on my first run. It just didn't work. What I did was reboot the thecus box. "System > Reboot & Shutdown". You *probably* don't need to do this, but I'd suggest it. It worked for me.
Anyway, after a reboot (or not. Just do it). Try to get to the repository with your favorite svn client. I'd suggest the command line, just for ease of explaining it...
svn ls svn://[your ip address]/[your repository]
Say the IP is 192.168.2.10, and the repository is 'svn', the call would be...
svn ls svn://192.168.2.10/svn
This should not return an error of any kind. You can also try...
svn info svn://192.168.2.10/svn
OK! Lets assume that went to plan. You should be able to use svn now. What if you have an existing repository?
*Importing*
You will need SSH for this. Go to your existing repository. use 'svnadmin dump' to output a dump file. Scp, or sftp your dump file to the thecus. I'd suggest your svn repository directory, so '/raid/svndata' for me.
Log in there with ssh. There is a copy of svnadmin installed with the module. Use this to inflate your repository. Say you use 'svn' from above, and the same paths I used. Your repository should be at '/raid/svndata/svn'. You are logged in, as root, to '/raid/svndata'. Your uncompressed dump file is called 'myrepo.dump', in this dir.
Run the following...
/raid/module/SVN/system/bin/svnadmin load svn < myrepo.dump
You'll see all sorts of messages floating by. After its done, you should be all set.
Thats it. Good luck.
The svn module rules, but I had a really hard time setting it up. As I am myself an on again/off again open source contributor I know the one thing I rarely do is write documentation. The module is excellent. The docs are pretty good. I figure I'll throw in what I did and if you're having trouble, maybe you can cobble together the install.
Requirements:
SVN Module
www.onbeat.dk/thecus/index.php/N2100_Module:_SVN
SSH Module (you may not need this. I'll explain)
www.onbeat.dk/thecus/index.php/N2100_Module:_SSH
Downloaded those modules? Great. Open your browser config panel and log in. Go to "System > Module Mgnt".
Install, then enable SVN. Optionally SSH.
*SSH Module* I installed this. I logged in to the machine, and created a directory called '/raid/svndata'. This is the dir that will hold the repositories. *If you don't want to install SSH*, go to "Storage > Folder". Create a folder. That folder will actually map to '/raid/[folder name]'. So, if you made a folder called 'awesomedir', it would actually map to the path '/raid/awesomedir'.
I don't know how the paths work when you're doing jbod or single disk. You'll have to figure that out. In that case, I'd highly suggest installing SSH and seeing what's happening under the hood. Anyway...
So, now, you should have SVN installed and enabled, and a directory into which repositories will be put. We'll say '/raid/svndata' from now on.
Go back to "System > Module Mgnt", and click "[Thecus] SVN". We're going to set up one repository and get it working. After that, you'll have to figure out the rest.
*svnserve settings*
Go to the part called "svnserve settings". For "Listen port" type in 3690. Its the default (you can use what you want, but humor me and just type that in). In "Listen host", type in the IP address of your Thecus box. If you don't know how to get this you probably shouldn't be installing a version control system. Finally, in "Root path", type in the directory we created above. The *FULL* directory, as in '/raid/svndata'. Make sure the directory exists, and you type in the full path. You will not get an error if you do this stuff wrong. Click Apply.
*Users*
In the "Users" section, type in a name in "Name" and a password in "Password". "Name" is a username, so use something normal for now (no spaces or funky characters. In fact, to make things easy, type in 'newuser', and password 'password1'. Make it better later). Click "Add/Change".
*Repository management*
Here is where you *actually* make the repository. Type in a repository name in "Name". For now, try 'svn'. Click 'Add'. If you have SSH installed, do an 'ls' on your repository directory (mine is '/raid/svndata'). You should see a folder for your new repository. If you don't have SSH, try opening that folder you made with the browser tool. If you don't see a repository in the directory, you did something wrong and need to fix it before you move on.
*Authorization settings*
Select your new user and "Read and write". Click Add.
OK. You should have a new repository and whatnot. Here's where I ran into a problem on my first run. It just didn't work. What I did was reboot the thecus box. "System > Reboot & Shutdown". You *probably* don't need to do this, but I'd suggest it. It worked for me.
Anyway, after a reboot (or not. Just do it). Try to get to the repository with your favorite svn client. I'd suggest the command line, just for ease of explaining it...
svn ls svn://[your ip address]/[your repository]
Say the IP is 192.168.2.10, and the repository is 'svn', the call would be...
svn ls svn://192.168.2.10/svn
This should not return an error of any kind. You can also try...
svn info svn://192.168.2.10/svn
OK! Lets assume that went to plan. You should be able to use svn now. What if you have an existing repository?
*Importing*
You will need SSH for this. Go to your existing repository. use 'svnadmin dump' to output a dump file. Scp, or sftp your dump file to the thecus. I'd suggest your svn repository directory, so '/raid/svndata' for me.
Log in there with ssh. There is a copy of svnadmin installed with the module. Use this to inflate your repository. Say you use 'svn' from above, and the same paths I used. Your repository should be at '/raid/svndata/svn'. You are logged in, as root, to '/raid/svndata'. Your uncompressed dump file is called 'myrepo.dump', in this dir.
Run the following...
/raid/module/SVN/system/bin/svnadmin load svn < myrepo.dump
You'll see all sorts of messages floating by. After its done, you should be all set.
Thats it. Good luck.
