[Yanel-usage] Some Points About Experience While I Installed Yanel on Mac OS X
Michael Wechner
michael.wechner at wyona.com
Wed Jun 12 11:50:23 CEST 2013
Dear Darius
Am 11.06.13 13:22, schrieb Darius Miliauskas:
> 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.
I am still not sure I understand, because these pages already cross-link
each other.
Can you send a patch of the XHTML in order to show what changes you
would made?
The XHTML of the Yanel documentation/website can be found at
YANEL_SOURCE/src/realms/yanel-website/data-repo/data/
hence for example http://www.yanel.org/download/source-repository.html
corresponds with
YANEL_SOURCE/src/realms/yanel-website/data-repo/data/download/source-repository.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?
yes, I have changed it now and already pushed to github (please do a
"git pull")
>
> 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.
but from the screenshot it seems like you didn't enter the port 8080 and
the yanel prefix
>
> 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?
that if someone is typing build.sh or yanel.sh without any arguments,
that then these shell scripts will tell you which arguments are possible
and what they are used for
>
> 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/
this improvement you should add to
https://github.com/wyona/yanel/issues
also see 3)
> /
> /
> 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?
no, I don't understand. Do you mean that there is only one shell script
called yanel.sh instead build.sh and yanel.sh ?
>
> The last lines (4) and 5)) was just suggestions for a possible
> improvement.
that's why you should add them as enhancements to
https://github.com/wyona/yanel/issues
Thanks
Michael
>
>
> Best Wishes,
>
> Darius
>
>
>
>
> 2013/6/5 Michael Wechner <michael.wechner at wyona.com
> <mailto: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
> <mailto: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/20130612/e75e339d/attachment-0001.html>
More information about the Yanel-usage
mailing list