[Yanel-usage] Some Points About Experience While I Installed Yanel on Mac OS X

[Michael Wechner]

Dear Darius

Thanks very much for your feedback. Please find my comments/questions 
inline below

Am 04.06.13 22:34, schrieb Darius Miliauskas:
> Dear All,
>
> I have some questions/suggestions regarding the experience which I had 
> trying to install Yanel on the PC (Apple MacBook). The PC runs Mac OS 
> X (Version 10.7.5). The important suggestions were marked as bold, not 
> to make you lost in such a long text.
>
> 1) I downloaded/installed GitHub 
> (https://help.github.com/articles/set-up-git), before I was required 
> to create my account there.
> First of all, I needed to open Terminal.
> I made a directory with the command: mkdir src;
> Then I put the following line: git clone 
> https://github.com/wyona/yanel.git
> However, I got an error:
>
> /-bash: git:command not found/
> /
> /That was the first serious issue I met. *The same issue the other 
> users found with Mac OS X (Lion) system*: 
> http://www.hongkiat.com/blog/mountain-lion-git-fix/.
> In order to solve the issue, I needed to find on AppleStore and 
> install Xcode. It is a gratis software used to code the applications 
> for MAC.
> After the installation I needed to install he Command Line Tool via 
> the preferences of Xcode.
> Finally, it worked.
> 2) I followed the instructions,

which instructions exactly did you follow? Was it

http://www.yanel.org/download/source-repository.html

?
> and put Yanel on my PC. However, I was not sure how to build and run 
> it. I open README.txt file in the directory Yanel (command line: open 
> README.txt)

do you think we should add a link/note to

http://www.yanel.org/download/source-repository.html

pointing to

http://www.yanel.org/en/getting-started/unix.html
(or http://www.yanel.org/en/getting-started/windows.html)

?

> a) the command "quick-start" is used to build Yanel on the PC, not 
> just start Yanel.
> So, it is definitely required to build the code before to run Yanel on 
> your PC.
> b) /Mac/ OS X, is a series of /Unix/-/based/ graphical interface 
> operating systems. Not everybody knows it. In the README.txt *I will 
> add a line like *for Mac OS X use UNIX.*

where exactly would you add this line?
Can you send a patch?

> 3) The process of build&run was the following:
> make sure you are on the directory of Yanel, for example, in my case:
>
> /new-host:yanel kristinaslekyte$/
>
> kristinaslekyte is a name for the PC (the owner is Kristina Slekyte).
>
> so, it should be:
> /new-host:yanel YourPC$/
>
> so I put the following commands:
>
> /export JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Home/
> /echo $JAVA_HOME/
> /./build.sh quick-start/
>
> the line with export is required to avoid "ERROR: No JAVA_HOME set!"
> echo just justify that the command export worked out.
> In the case you want to terminate processes in Terminal, click 
> "control+C".
> In order to build it is important to put "./build.sh quick-start" 
> without any mistypes, otherwise, even the build successful you will 
> get the following error when you run Yanel:
>
> /BUILD FAILED/
> //Users/kristinaslekyte/src/yanel/src/build/targets/cruise-control/continuous-integration.xml:25: 
> The following error occurred while executing this line:/
> //Users/kristinaslekyte/src/yanel/src/build/targets/cruise-control/continuous-integration.xml:59: 
> No Tomcat is set inside local.build.properties! Please note that if 
> you build Yanel from scratch, then you should use the 'quick-start' 
> target (https://github.com/wyona/yanel)./
>
> So, finally, I built it, and I could run with the line:
>
> /./yanel.sh start/
>
> Then open my browser ("Safari"), and I put 
> "http://127.0.0.1:8080/yanel/" in the address bar. I got the page 
> instead the message that the page cannot be opened.

Can you explain your last setence here what you mean exactly?
>
> BRAVO, Yanel is running on my PC.
>
> 4) *Actually, it would be nice to get know what commands I can use 
> with Yanel in terminal, like*
>
> /./yanel.sh ?/
>
> ? stands for "start".
>
> Perhaps, I can put just yanel, and get the lines what I can do like I 
> got when I typed "git":
>
> /The most commonly used git commands are:/
> /   add        Add file contents to the index/
> /   bisect     Find by binary search the change that introduced a bug/
> /   branch     List, create, or delete branches/
> /   checkout   Checkout a branch or paths to the working tree/
> /   clone      Clone a repository into a new directory/
> /   commit     Record changes to the repository/
> /   diff       Show changes between commits, commit and working tree, etc/
> /   fetch      Download objects and refs from another repository/
> /   grep       Print lines matching a pattern/
> /   init       Create an empty git repository or reinitialize an 
> existing one/
> /   log        Show commit logs/
> /   merge      Join two or more development histories together/
> /   mv         Move or rename a file, a directory, or a symlink/
> /   pull       Fetch from and merge with another repository or a local 
> branch/
> /   push       Update remote refs along with associated objects/
> /   rebase     Forward-port local commits to the updated upstream head/
> /   reset      Reset current HEAD to the specified state/
> /   rm         Remove files from the working tree and from the index/
> /   show       Show various types of objects/
> /   status     Show the working tree status/
> /   tag        Create, list, delete or verify a tag object signed with 
> GPG/

yes, I think that would be nice.

Can you open an issue on github and describe this improvement:

https://github.com/wyona/yanel/issues
>
> *Secondly, the user would enjoy if he can just get help immediately in 
> Terminal, and put question mark to get the lines with the suggestions 
> what to use further.*

I am not sure I understand, can you make an example?

> Thirdly, is it possible just to type like yanel build or yanel start?

I am not sure I understand this either. Can you also explain a bit more?
>
> I learnt a lot while I installed Yanel on the PC.
>
> All the Best,
>
> Darius Miliauskas
> Lithuania
>
> p. s. I am thankful for my girlfriend Kristina Slekyte (her Apple I 
> used), and for Michael Wechner (Wyona), his assistance was tremendous 
> while I went through the issues.

Thank you very much for sharing your experiences. I think it helps us a 
lot to improve Yanel.

Best wishes

Michael
>
> /
> /
> /
> /
>
>
>
>
>
>

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.wyona.org/pipermail/yanel-usage/attachments/20130605/baf0328a/attachment.html>