I understand neighbourhoods can be used for grouping similar projects. By default I can see 3 neighbourhoods created by default : Adobe, Projects and Users.
Is it possible to create new neighbourhood?
Also, I see Clustering, Communications and Database tabs on the left of the home page which are empty. Are these similar to neighbourhoods? If so, can I create new ones here?
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
The Clustering, etc categories on the home page are not used by anything any more, and are due for removal. Most Allura instances customize their index page.
The Evict option under neighborhood moderation is not a commonly used feature, but I tested it just now and it worked fine. If you still get that error, can you provide more details about the steps you took, which project and neighborhood, etc?
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
I could create new neighborhoods using the pastor command. Thanks :)
Is it possible to delete existing neighborhoods and projects? I did not see any commands for that..
You mentioned customizing the index page, how can I do that?
After I restarted the server, the Evict seems to be working fine, so I do not know what was the issue earlier. Whenever I Evict, the project gets evicted to the 'Projects' neighborhood. Is this the expected behavior?
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
Thanks :)
I am now trying to setup git connection for a project. I created a dummy project and want to try adding a sample code file to it. I followed the steps mentioned in 'First time using Git'. If you look at the attachment, you'll see that the status says 'Repo status: initializing...'. What do I need to do to see the file in repo?
Yep, that is the error. You will need to set permissions so the allura webapp and taskd processes can read & write to that directory. Or change that directory with the scm.repos.root setting and scm.host.file.git setting in the .ini config file (and restart services).
You'll probably want to make a new code repo after that, to make sure it gets initialized correctly.
And then you should do a checkout of the repo, not commit directly in the /srv/git path.
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
Everything is saved to mongodb, so restarts wont' lose anything. With the docker setup, you can restart with: docker-compose restart taskd and docker-compose restart web
With step-by-step installation you basically just stop the process and then start it again. (In a production-ready setup you'd want to create a service to manage it). So something like:
pkill -f gunicorn and then gunicorn --reload --paste development.ini again
pkill "^taskd"; and then nohup paster taskd development.ini >> /var/log/allura/taskd.log 2>&1 & again
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
I would want to setup a development environment and to try out some customizations (like changing the css). Also, I'd want to try creating new plugins. How do I get started ? Is there a developer guide available?
Hello Dave,
In sourceforge for each project there is possibility to provide user reviews and to view the number of downloads. Are these features part of Allura? Or are there plugins available that I can integrate?
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
It is not in a released version yet. But it is on the "master" branch of allura, so if you are using a git checkout of Allura you can update to the latest and use it.
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
In the step of installing virtualenv, i get the below exception.
~$ sudo pip install virtualenv
Collecting virtualenv
Exception:
Traceback (most recent call last):
File "/usr/lib/python2.7/dist-packages/pip/basecommand.py", line 209, in main
status = self.run(options, args)
File "/usr/lib/python2.7/dist-packages/pip/commands/install.py", line 317, in run
requirement_set.prepare_files(finder)
File "/usr/lib/python2.7/dist-packages/pip/req/req_set.py", line 360, in prepare_files
ignore_dependencies=self.ignore_dependencies))
Complete exception is available in the attached Expn.txt
There is not currently a way to make it responsive. Essentially every page would need its HTML & CSS to be rewritten. We would like to have it be responsive at some point, but it would be a lot of work. There is a ticket for it: [#8093] It might be possible to have certain pages be responsive before others, but still would require a lot of changes to get started.
Also, I see Clustering, Communications and Database tabs on the left of the home page which are empty. Are these similar to neighbourhoods? If so, can I create new ones here?
When I tried an 'Evict' of a project from a neighbourhood, it gives the error 'AttributeError: 'NoneType' object has no attribute '_id''
Yes, you can create more neighborhoods with the
create-neighborhoodcommand. https://forge-allura.apache.org/docs/getting_started/administration.htmlThe Clustering, etc categories on the home page are not used by anything any more, and are due for removal. Most Allura instances customize their index page.
The Evict option under neighborhood moderation is not a commonly used feature, but I tested it just now and it worked fine. If you still get that error, can you provide more details about the steps you took, which project and neighborhood, etc?
I could create new neighborhoods using the pastor command. Thanks :)
Is it possible to delete existing neighborhoods and projects? I did not see any commands for that..
You mentioned customizing the index page, how can I do that?
After I restarted the server, the Evict seems to be working fine, so I do not know what was the issue earlier. Whenever I Evict, the project gets evicted to the 'Projects' neighborhood. Is this the expected behavior?
There's not exactly a way to delete a neighborhood, but you can create the initial database without the example neighborhoods. See the
setup-appnote at https://forge-allura.apache.org/docs/getting_started/installation.html Otherwise you can go into the mongodb shell to remove things, see: https://www.mail-archive.com/allura-dev@incubator.apache.org/msg02260.htmlYou could modify the
templates/neighborhood_list.htmlfile directly. A little cleaner but more work is to make a new python package and set up template overrides. Docs for that are at https://forge-allura.apache.org/docs/api/lib/package_path_loader.html#overriding-dotted-notationAnd yes, evicting is meant to send a project to the "Projects" neighborhood. The Projects neighborhood is the main default neighborhood.
Thanks :)
I am now trying to setup git connection for a project. I created a dummy project and want to try adding a sample code file to it. I followed the steps mentioned in 'First time using Git'. If you look at the attachment, you'll see that the status says 'Repo status: initializing...'. What do I need to do to see the file in repo?
Is the
taskdprocess running? That is an allura command that runs background processes like initializing repositories. With the docker setup it is just one of the containers. If you are running without docker, https://forge-allura.apache.org/docs/getting_started/install_each_step.html#allura-task-processing has the basic command to run it.Yes. taskd had been running. I checked the taskd.log and see a 'Permission denied' error. Could this be the problem? Taskd log attached here.
08:24:49,480 ERROR [allura.model.monq_model] Error "[Errno 13] Permission denied: '/srv/git/USS/artodbc/code.git'" on job <MonQTask 5b21d8f82fcfd70add915c24="" (busy)="" P:10="" allura.tasks.repo_tasks.init="" BMH1104243="" pid="" 2747="" project:="" USS="" artodbc="" app:code="" user:admin1="">
Traceback (most recent call last):
. . .
. . .
OSError: [Errno 13] Permission denied: '/srv/git/USS/artodbc/code.git'
When I had to run the git commands via terminal to add and push files into the repository, I had to use sudo always.
Last edit: Vrinda A 2018-06-14
Yep, that is the error. You will need to set permissions so the allura webapp and taskd processes can read & write to that directory. Or change that directory with the
scm.repos.rootsetting andscm.host.file.gitsetting in the.iniconfig file (and restart services).You'll probably want to make a new code repo after that, to make sure it gets initialized correctly.
And then you should do a checkout of the repo, not commit directly in the /srv/git path.
I set read/write permissions to /srv/git folder and created new code repo. Now I am able to see the repo file in the browser. Thanks :)
What is the command to restart the services - without losing the neighborhood and projects created?
Everything is saved to mongodb, so restarts wont' lose anything. With the docker setup, you can restart with:
docker-compose restart taskdanddocker-compose restart webWith step-by-step installation you basically just stop the process and then start it again. (In a production-ready setup you'd want to create a service to manage it). So something like:
pkill -f gunicornand thengunicorn --reload --paste development.iniagainpkill "^taskd";and thennohup paster taskd development.ini >> /var/log/allura/taskd.log 2>&1 &againI was also running the command
ALLURA_TEST_DATA=False paster setup-app development.ini
This was recreating the mongodb maybe?
Without this, after the restart I can see the projects persisted.
I would want to setup a development environment and to try out some customizations (like changing the css). Also, I'd want to try creating new plugins. How do I get started ? Is there a developer guide available?
I found one Sourceforge documentation on creating a new plugin :
https://sourceforge.net/u/vansteenburgh/allura-plugin-development/2013/06/part-1-getting-started/
Could this be a starting point?
Yes that is one good resource. The official docs also have a whole section on it: https://forge-allura.apache.org/docs/development/index.html
Last edit: 小融 2018-06-25
Hello Dave,
In sourceforge for each project there is possibility to provide user reviews and to view the number of downloads. Are these features part of Allura? Or are there plugins available that I can integrate?
Those are not part of the open source Allura, sorry
I see some recent tickets on creating a personalized dashboard. Is this already part of Allura? If so, how can I get this into my ubuntu installation?
It is not in a released version yet. But it is on the "master" branch of allura, so if you are using a git checkout of Allura you can update to the latest and use it.
Thanks :) Will try a git update.
I am also trying to install Allura on a Ubuntu subsytem in Windows and have been following the steps in https://forge-allura.apache.org/docs/getting_started/install_each_step.html
In the step of installing virtualenv, i get the below exception.
~$ sudo pip install virtualenv
Collecting virtualenv
Exception:
Traceback (most recent call last):
File "/usr/lib/python2.7/dist-packages/pip/basecommand.py", line 209, in main
status = self.run(options, args)
File "/usr/lib/python2.7/dist-packages/pip/commands/install.py", line 317, in run
requirement_set.prepare_files(finder)
File "/usr/lib/python2.7/dist-packages/pip/req/req_set.py", line 360, in prepare_files
ignore_dependencies=self.ignore_dependencies))
Complete exception is available in the attached Expn.txt
Okay, the exception in my previous comment was due to my company proxy. I've now resolved by using the --proxy option.
I was trying to change the look and feel of the pages. Can you please guide me if there are existing themes available to experiment with the UI?
Also, I couldn't find any reference where I can make the UI responsive. Have you come across any reference in order to start on the same?
Hi,
https://forge-allura.apache.org/p/allura/wiki/Themes%20in%20Allura/ has some documentation about it. Depending on what you want to do may be more or less work.
There is not currently a way to make it responsive. Essentially every page would need its HTML & CSS to be rewritten. We would like to have it be responsive at some point, but it would be a lot of work. There is a ticket for it: [#8093] It might be possible to have certain pages be responsive before others, but still would require a lot of changes to get started.
Related
Tickets: #8093
For more questions, please open a new issue or contact us on the mailing list: https://lists.apache.org/list.html?dev@allura.apache.org
Thanks!
Last edit: Dave Brondsema 2018-10-12