#5943 Post-setup instructions

v1.3.1
closed
General
2015-08-10
2013-03-08
No

After README, there are a lot of things to do to really get started, which aren't explained:

  • what neighborhoods are
  • how to get to a nbhd admin page and configure stuff
  • remove default users: db.user.update({username:/test/}, {$set: {disabled:true}}, false, true);db.user.update({username:/root/}, {$set: {disabled:true}}, false, true);db.user.update({username:/admin/}, {$set: {disabled:true}}, false, true);
  • remove adobe nbhd: db.neighborhood.remove({url_prefix:'/adobe/'})
  • remove test project: db.project.remove({shortname:'test'}) // may need to add a neighborhood_id
    parameter if the project name exists in more than one nbhd.
  • change [handler_console] in the ini file to use allura.lib.utils.CustomWatchedFileHandler so that it goes to a file and gets task info included
  • change beaker.session.secret and beaker.session.validate_key in the .ini file to new values (first used for simple cookies, latter used for encrypted cookies)

Several of these are explained in default wiki content now.

docs/installation.rst has some post-setup content which should be freshened, and enhanced to include more.

Related

Tickets: #4646
Tickets: #7308

Discussion

  • Dave Brondsema

    Dave Brondsema - 2013-03-22
    • Milestone: pycon2013 --> forge-backlog
     
  • Dave Brondsema

    Dave Brondsema - 2013-03-26
    • Description has changed:

    Diff:

    --- old
    +++ new
    @@ -4,6 +4,4 @@
     * how to get to a nbhd admin page and configure stuff
     * remove default users: `db.user.update({username:/test/}, {$set: {disabled:true}}, false, true);db.user.update({username:/root/}, {$set: {disabled:true}}, false, true);db.user.update({username:/admin/}, {$set: {disabled:true}}, false, true);`
     * remove adobe nbhd
    -* change /p/wiki/Home/ to include a link to
    -registering a new project and listing the current projects - this could be set in bootstrap.py by default
     * how to deploy svn, hg, or git backend services and integrate them with Allura auth
    
     
  • Dave Brondsema

    Dave Brondsema - 2013-03-26

    [#6007] for the default nbhd wiki content

     

    Related

    Tickets: #6007

  • Dave Brondsema

    Dave Brondsema - 2013-06-18
    • Description has changed:

    Diff:

    --- old
    +++ new
    @@ -5,3 +5,9 @@
     * remove default users: `db.user.update({username:/test/}, {$set: {disabled:true}}, false, true);db.user.update({username:/root/}, {$set: {disabled:true}}, false, true);db.user.update({username:/admin/}, {$set: {disabled:true}}, false, true);`
     * remove adobe nbhd
     * how to deploy svn, hg, or git backend services and integrate them with Allura auth
    +
    +
    +Several of these are explained in default wiki content now.
    +
    +
    +docs/installation.rst has some post-setup content which should be freshened, and enhanced to include more.
    
     
  • Dave Brondsema

    Dave Brondsema - 2013-06-18
    • Description has changed:

    Diff:

    --- old
    +++ new
    @@ -5,6 +5,7 @@
     * remove default users: `db.user.update({username:/test/}, {$set: {disabled:true}}, false, true);db.user.update({username:/root/}, {$set: {disabled:true}}, false, true);db.user.update({username:/admin/}, {$set: {disabled:true}}, false, true);`
     * remove adobe nbhd
     * how to deploy svn, hg, or git backend services and integrate them with Allura auth
    +* change `[handler_console]` in the ini file to use `allura.lib.utils.CustomWatchedFileHandler` so that it goes to a file and gets task info included
    
     Several of these are explained in default wiki content now.
    
     
  • Dave Brondsema

    Dave Brondsema - 2013-12-03
    • Description has changed:

    Diff:

    --- old
    +++ new
    @@ -4,7 +4,7 @@
     * how to get to a nbhd admin page and configure stuff
     * remove default users: `db.user.update({username:/test/}, {$set: {disabled:true}}, false, true);db.user.update({username:/root/}, {$set: {disabled:true}}, false, true);db.user.update({username:/admin/}, {$set: {disabled:true}}, false, true);`
     * remove adobe nbhd
    -* how to deploy svn, hg, or git backend services and integrate them with Allura auth
    +* how to deploy svn, hg, or git backend services and integrate them with Allura auth [#5424]
     * change `[handler_console]` in the ini file to use `allura.lib.utils.CustomWatchedFileHandler` so that it goes to a file and gets task info included
    
     

    Related

    Tickets: #5424

  • Dave Brondsema

    Dave Brondsema - 2014-01-07
    • Labels: docs --> docs, bitesize
     
  • Dave Brondsema

    Dave Brondsema - 2014-01-28
    • Size: --> 1
     
  • Dave Brondsema

    Dave Brondsema - 2014-04-03
    • labels: docs, bitesize --> docs, bitesize, getting-started
    • Description has changed:

    Diff:

    --- old
    +++ new
    @@ -3,7 +3,9 @@
     * what neighborhoods are
     * how to get to a nbhd admin page and configure stuff
     * remove default users: `db.user.update({username:/test/}, {$set: {disabled:true}}, false, true);db.user.update({username:/root/}, {$set: {disabled:true}}, false, true);db.user.update({username:/admin/}, {$set: {disabled:true}}, false, true);`
    -* remove adobe nbhd
    +* remove adobe nbhd: `db.neighborhood.remove({url_prefix:'/adobe/'})`
    +* remove test project:  `db.project.remove({shortname:'test'})    // may need to add a neighborhood_id`
    +parameter if the project name exists in more than one nbhd.
     * how to deploy svn, hg, or git backend services and integrate them with Allura auth [#5424]
     * change `[handler_console]` in the ini file to use `allura.lib.utils.CustomWatchedFileHandler` so that it goes to a file and gets task info included
    
    • Size: 1 --> 1
     

    Related

    Tickets: #5424

  • Dave Brondsema

    Dave Brondsema - 2014-04-14
    • Description has changed:

    Diff:

    --- old
    +++ new
    @@ -8,6 +8,7 @@
     parameter if the project name exists in more than one nbhd.
     * how to deploy svn, hg, or git backend services and integrate them with Allura auth [#5424]
     * change `[handler_console]` in the ini file to use `allura.lib.utils.CustomWatchedFileHandler` so that it goes to a file and gets task info included
    +* change `beaker.session.secret` and `beaker.session.validate_key` in the `.ini` file to new values (first used for simple cookies, latter used for encrypted cookies)
    
     Several of these are explained in default wiki content now.
    
     

    Related

    Tickets: #5424

  • Dave Brondsema

    Dave Brondsema - 2015-06-29
    • labels: docs, bitesize, getting-started, sf-1 --> docs, bitesize, getting-started, sf-current, sf-4
    • Description has changed:

    Diff:

    --- old
    +++ new
    @@ -6,7 +6,6 @@
     * remove adobe nbhd: `db.neighborhood.remove({url_prefix:'/adobe/'})`
     * remove test project:  `db.project.remove({shortname:'test'})    // may need to add a neighborhood_id`
     parameter if the project name exists in more than one nbhd.
    -* how to deploy svn, hg, or git backend services and integrate them with Allura auth [#5424]
     * change `[handler_console]` in the ini file to use `allura.lib.utils.CustomWatchedFileHandler` so that it goes to a file and gets task info included
     * change `beaker.session.secret` and `beaker.session.validate_key` in the `.ini` file to new values (first used for simple cookies, latter used for encrypted cookies)
    
     

    Related

    Tickets: #5424

  • Igor Bondarenko - 2015-07-07
    • status: open --> in-progress
    • assigned_to: Igor Bondarenko
     
  • Dave Brondsema

    Dave Brondsema - 2015-07-08

    Hey Igor,

    Not sure how far you've gotten with this, but Heith and I were talking about it a few days ago and had an idea. Instead of telling people how to delete the test content, maybe we want 2 different ways to run setup-app (bootstrap.py). One with sample content and one without.

     
    • Igor Bondarenko - 2015-07-09

      I didn't start it yet. I'm planning to work on it today. That sounds like a good idea, I'll give it a try!

       
  • Igor Bondarenko - 2015-07-10
    • status: in-progress --> review
     
  • Igor Bondarenko - 2015-07-10

    Closed #815. ib/5943

    QA:

    • checkout branch
    • run ALLURA_TEST_DATA=False paster setup-app development.ini (change db settings first, if you don't want to rewrite existing data)
    • make sure there's no test users, projects, adobe neighborhood, etc
    • cd Allura/docs && make html
    • review "Installation -> Post-setup instructions" and "Using Allura -> What are neighborhoods?" sections
       

    English is not my native language, so there's definitely some silly mistakes. Feel free to fix them :)

     

    Last edit: Igor Bondarenko 2015-07-10
  • Dave Brondsema

    Dave Brondsema - 2015-07-13
    • labels: docs, bitesize, getting-started, sf-current, sf-4 --> docs, bitesize, getting-started, sf-4
     
  • Dave Brondsema

    Dave Brondsema - 2015-07-13
    • status: review --> closed
    • Reviewer: Dave Brondsema
     
  • Dave Brondsema

    Dave Brondsema - 2015-08-10
    • Milestone: unreleased --> v1.3.1
     

Log in to post a comment.