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

[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, 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)
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.*
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.

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*

*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.*
Thirdly, is it possible just to type like yanel build or yanel start?

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.

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