[Yanel-usage] Some Points About Experience While I Installed Yanel on Mac OS X
Darius Miliauskas
dariui.miliauskui at gmail.com
Tue Jun 11 13:22:21 CEST 2013
Dear Michael,
Thank you for your feedback! According your answer, some questions I need
to explain more.
1) Yes, I followed the instructions which is on
http://www.yanel.org/download/source-repository.html and
https://help.github.com/articles/set-up-git
To be more precise, instead I installed GitHub just added Yanel on my PC.
To make more convenient navigation, you can add the link from
http://www.yanel.org/download/source-repository.html
to http://www.yanel.org/en/getting-started/unix.html and
http://www.yanel.org/en/getting-started/windows.html.
2) I would add in the README.txt file. I would change, for example,
"2) Start Yanel by running
UNIX: ./yanel.sh start
Windows: yanel.bat start"
to
"2) Start Yanel by running
UNIX (Linux and Mac OS): ./yanel.sh start
Windows: yanel.bat start"
The same in the lines:
"1) Build Yanel by running
UNIX: ./build.sh quick-start
Windows: build.bat quick-start"
Did you get me?
3) Yanel was not correctly installed, therefore, I couldn't start and run
it. The last sentence just describe the practical pattern which the user
experiences. He open my browser ("Safari"), type "
http://127.0.0.1:8080/yanel/" in the address bar, and got the certain
message on his browser. I add the screen shot as the attachment to explain
what I meant.
Which improvement to describe in https://github.com/wyona/yanel/issues? Do
you mean the one with the message in the browser or the one when I mistyped
"./build.sh quick-start"? Or the one that "quick-start" does not precisely
carries the meaning of installing Yanel?
4) I was talking about some help for the user during he types in Terminal.
For example, type *./build.sh /?*
and get
*clean-all Clean a previous build
*
*quick-start Build Yanel by running
*
*start Start Yanel by running*
or type *./build.sh *help
and get that
Yanel is a great tool bla bla
The most commonly used Yanel commands are:
*clean-all Clean a previous build
*
*quick-start Build Yanel by running
*
*start Start Yanel by running*
*
*
5) You can use "yanel" command as, for example, "git" instead of typing "*
./build.sh*". I do not know whether such replacement is possible, and how
to make it. Do you get?
The last lines (4) and 5)) was just suggestions for a possible improvement.
Best Wishes,
Darius
2013/6/5 Michael Wechner <michael.wechner at wyona.com>
> 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
>
>
> *
> *
> *
> *
>
>
>
>
>
>
>
>
>
>
> --
> Yanel-usage mailing list Yanel-usage at wyona.com
> http://lists.wyona.org/cgi-bin/mailman/listinfo/yanel-usage
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.wyona.org/pipermail/yanel-usage/attachments/20130611/051db2b1/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: Screen Shot 2013-06-11 at 1.39.24 PM.png
Type: image/png
Size: 188184 bytes
Desc: not available
URL: <http://lists.wyona.org/pipermail/yanel-usage/attachments/20130611/051db2b1/attachment-0001.png>
More information about the Yanel-usage
mailing list