After installing this software, you may need to carry out some of these configuration steps, depending on your tasks.
Your installation comes with no geographic data loaded. You can either create new data using one of the editors (Potlatch 2, iD, JOSM etc) or by loading an OSM extract.
After installing but before creating any users or data, import an extract with Osmosis and the --write-apidb
task.
osmosis --read-pbf greater-london-latest.osm.pbf \
--write-apidb host="localhost" database="openstreetmap" \
user="openstreetmap" password="" validateSchemaVersion="no"
Loading an apidb database with Osmosis is about twenty times slower than loading the equivalent data with osm2pgsql into a rendering database. --log-progress
may be desirable for status updates.
To be able to edit the data you have loaded, you will need to use this yet-to-be-written script.
If you create a user by signing up to your local website, you need to confirm the user before you can log in, which normally happens by clicking a link sent via email. If don't want to set up your development box to send emails to public email addresses then you can create the user as normal and then confirm it manually through the Rails console:
$ bundle exec rails console
>> user = User.find_by_display_name("My New User Name")
=> #[ ... ]
>> user.status = "active"
=> "active"
>> user.save!
=> true
>> quit
To give administrator or moderator permissions:
$ bundle exec rails console
>> user = User.find_by_display_name("My New User Name")
=> #[ ... ]
>> user.roles.create(:role => "administrator", :granter_id => user.id)
=> #[ ... ]
>> user.roles.create(:role => "moderator", :granter_id => user.id)
=> #[ ... ]
>> user.save!
=> true
>> quit
Three of the built-in applications communicate via the API, and therefore need OAuth consumer keys configured. These are:
For example, to use the Potlatch 2 editor you need to register it as an OAuth application.
Do the following:
An example excerpt from application.yml:
# Default editor
default_editor: "potlatch2"
# OAuth consumer key for Potlatch 2
potlatch2_key: "8lFmZPsagHV4l3rkAHq0hWY5vV3Ctl3oEFY1aXth"
Follow the same process for registering and configuring iD (id_key
) and the website/Notes (oauth_key
), or to save time, simply reuse the same consumer key for each.
Rails has its own log. To inspect the log, do this:
tail -f log/development.log
If you have more problems, please ask on the rails-dev@openstreetmap.org mailing list or on the #osm-dev IRC Channel
If your installation stops working for some reason:
Sometimes gem dependencies change. To update go to your rails_port directory and run ''bundle install'' as root.
The OSM database schema is changed periodically and you need to keep up with these improvements. Go to your rails_port directory and run:
bundle exec rake db:migrate
For example, after developing a patch for the rails_port, you might want to demonstrate it to others or ask for comments and testing. To do this one can set up an instance of the rails_port on the dev server in ones user directory.
For information on contributing changes to the codes, see CONTRIBUTING.md
If you want to deploy The Rails Port for production use, you'll need to make a few changes.
rails server
in production. Our recommended approach is to use Phusion Passenger. Instructions are available for setting it up with most web servers.RAILS_ENV=production rake assets:precompile
tmp/
.此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。