<div dir="ltr">Dear All,<div><br></div><div>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.</div>
<div><br></div><div>1) I downloaded/installed GitHub (<a href="https://help.github.com/articles/set-up-git" target="_blank">https://help.github.com/articles/set-up-git</a>), before I was required to create my account there.</div>
<div>First of all, I needed to open Terminal.<br></div><div>I made a directory with the command: mkdir src;</div><div>Then I put the following line: git clone <a href="https://github.com/wyona/yanel.git" target="_blank">https://github.com/wyona/yanel.git</a></div>
<div>However, I got an error:</div><div><br></div><div><i>-bash: git:command not found</i></div><div><i><br></i>That was the first serious issue I met. <b>The same issue the other users found with Mac OS X (Lion) system</b>: <a href="http://www.hongkiat.com/blog/mountain-lion-git-fix/" target="_blank">http://www.hongkiat.com/blog/mountain-lion-git-fix/</a>.<br>
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.<br>After the installation I needed to install he Command Line Tool via the preferences of Xcode.</div>
<div>Finally, it worked.</div><div>2) I followed the instructions, 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)</div>
<div>a) the command "quick-start" is used to build Yanel on the PC, not just start Yanel.</div><div>So, it is definitely required to build the code before to run Yanel on your PC.</div><div>b) <i style="font-weight:bold;font-style:normal;color:rgb(68,68,68);font-family:arial,sans-serif;line-height:16px">Mac</i><span style="color:rgb(68,68,68);font-family:arial,sans-serif;line-height:16px"> OS X, is a series of </span><i style="font-weight:bold;font-style:normal;color:rgb(68,68,68);font-family:arial,sans-serif;line-height:16px">Unix</i><span style="color:rgb(68,68,68);font-family:arial,sans-serif;line-height:16px">-</span><i style="font-weight:bold;font-style:normal;color:rgb(68,68,68);font-family:arial,sans-serif;line-height:16px">based</i><span style="color:rgb(68,68,68);font-family:arial,sans-serif;line-height:16px"> graphical interface operating systems. Not everybody knows it. In the README.txt <b>I will add a line like *for Mac OS X use UNIX.</b></span></div>
<div><font color="#444444" face="arial, sans-serif"><span style="line-height:16px">3) The process of build&run was the following:</span></font></div><div><font color="#444444" face="arial, sans-serif"><span style="line-height:16px">make sure you are on the directory of Yanel, for example, in my case: </span></font></div>
<div><font color="#444444" face="arial, sans-serif"><span style="line-height:16px"><br></span></font></div><div><i>new-host:yanel kristinaslekyte$</i></div><div><br></div><div>kristinaslekyte is a name for the PC (the owner is Kristina Slekyte).</div>
<div><br></div><div>so, it should be:</div><div> </div><div><i>new-host:yanel YourPC$</i><br></div><div><br></div><div>so I put the following commands:</div><div><br></div><div>
<div><i>export JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Home</i></div><div><i>echo $JAVA_HOME</i></div><div><i>./build.sh quick-start</i><br></div><div><br></div><div>the line with export is required to avoid "ERROR: No JAVA_HOME set!"</div>
<div>echo just justify that the command export worked out.</div><div>In the case you want to terminate processes in Terminal, click "control+C".</div><div>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:</div>
<div><br></div><div><div><i>BUILD FAILED</i></div><div><i>/Users/kristinaslekyte/src/yanel/src/build/targets/cruise-control/continuous-integration.xml:25: The following error occurred while executing this line:</i></div>
<div><i>/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 (<a href="https://github.com/wyona/yanel" target="_blank">https://github.com/wyona/yanel</a>).</i></div>
<div><br></div><div>So, finally, I built it, and I could run with the line:</div><div><br></div><div><i>./yanel.sh start</i><br></div><div><br></div><div>Then open my browser ("Safari"), and I put "<a href="http://127.0.0.1:8080/yanel/" target="_blank">http://127.0.0.1:8080/yanel/</a>" in the address bar. I got the page instead the message that the page cannot be opened.</div>
<div><br></div><div>BRAVO, Yanel is running on my PC.</div><div><br></div><div>4) <b>Actually, it would be nice to get know what commands I can use with Yanel in terminal, like</b></div><div>
<br></div><div><i>./yanel.sh ?</i><br></div><div><br></div><div>? stands for "start".</div><div><br></div><div>Perhaps, I can put just yanel, and get the lines what I can do like I got when I typed "git":</div>
<div><br></div><div><div><i>The most commonly used git commands are:</i></div><div><i> add Add file contents to the index</i></div><div><i> bisect Find by binary search the change that introduced a bug</i></div>
<div><i> branch List, create, or delete branches</i></div><div><i> checkout Checkout a branch or paths to the working tree</i></div><div><i> clone Clone a repository into a new directory</i></div><div><i> commit Record changes to the repository</i></div>
<div><i> diff Show changes between commits, commit and working tree, etc</i></div><div><i> fetch Download objects and refs from another repository</i></div><div><i> grep Print lines matching a pattern</i></div>
<div><i> init Create an empty git repository or reinitialize an existing one</i></div><div><i> log Show commit logs</i></div><div><i> merge Join two or more development histories together</i></div>
<div><i> mv Move or rename a file, a directory, or a symlink</i></div><div><i> pull Fetch from and merge with another repository or a local branch</i></div><div><i> push Update remote refs along with associated objects</i></div>
<div><i> rebase Forward-port local commits to the updated upstream head</i></div><div><i> reset Reset current HEAD to the specified state</i></div><div><i> rm Remove files from the working tree and from the index</i></div>
<div><i> show Show various types of objects</i></div><div><i> status Show the working tree status</i></div><div><i> tag Create, list, delete or verify a tag object signed with GPG</i></div></div><div>
<br></div><div><b>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.</b></div><div>Thirdly, is it possible just to type like yanel build or yanel start?</div>
<div><br></div><div>I learnt a lot while I installed Yanel on the PC.</div><div><br></div><div> </div><div>All the Best,</div><div><br></div><div>Darius Miliauskas</div><div>
Lithuania</div><div><br></div><div>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.</div><div><br>
</div><div><i><br></i></div><div><i><br></i></div><div><br></div><div> </div></div></div><div><br>
</div><div><br></div><div><br></div><div> </div></div>