Redmine. Install - Redmine. This is the installation documentation for Redmine 3. You can still read the document for older versions: 1. Requirements¶Operating system¶Redmine should run on most Unix, Linux, mac. OS, mac. OS Server and Windows systems as long as Ruby is available on this platform. Note: For Ruby 1.8 you must require 'rubygems' before requiring any gems. Once you’ve required ap, RubyGems automatically places its lib directory on the $LOAD_PATH. Extract JRuby into a directory. Add that directory's bin subdirectory to the end of your path. Test it: jruby -v; Detailed instructions →. See specific installation How. Tos here. Ruby interpreter¶The required Ruby versions for a given Redmine version is: Redmine version. Supported Ruby versions Rails version used. Rails 5. 1 3. How To Test Ruby Installation Path Not WriteableRails 4. 2 3. Rails 4. 2 3. Rails 4. 2 Support for Ruby 1. Ruby community. https: //www. Redmine 3. 2 or lower does not support Ruby 2. Redmine 3. 3 supports Ruby 2. Redmine does not support JRuby because some gems do not support Rails 4. Supported database back- ends¶Postgre. SQL 8. 2 or higher. ISO (Postgresql default setting). You can set it using: ALTER DATABASE "redmine_db" SET datestyle="ISO,MDY"; some bugs in Postgre. SQL 8. 4. 0 and 8. Redmine behavior (#4. Postgre. SQL 8. 4. SQLite 3 (not for multi- user production use!)Optional components¶SCM binaries (eg. PATH). See Redmine. Repositories for SCM compatibility and requirements. Image. Magick (to enable Gantt export to PNG image and thumbnails generation). Ruby Open. ID Library (to enable Open. ID support). Redmine Version¶It is recommended that the majority of users install the proper point releases of redmine. Redmine currently releases a new version every 6 months, and these releases are considered very usable and stable. It is not recommended to install redmine from trunk, unless you are deeply familiar with Ruby on Rails and keep up with the changes - Trunk does break from time- to- time. Installation procedure¶Step 1 - Redmine application¶Get the Redmine source code by either downloading a packaged release or checking out the code repository. See the download page for details. Step 2 - Create an empty database and accompanying user¶Redmine database user will be named redmine hereafter but it can be changed to anything else. My. SQL¶CREATEDATABASE redmine CHARACTER SET utf. CREATE USER 'redmine'@'localhost' IDENTIFIED BY'my_password'. GRANTALL PRIVILEGES ON redmine.* TO'redmine'@'localhost'. For versions of My. SQL prior to 5. 0. CREATE USER' step and instead: GRANTALL PRIVILEGES ON redmine.* TO'redmine'@'localhost' IDENTIFIED BY'my_password'. Postgre. SQL¶CREATE ROLE redmine LOGIN ENCRYPTED PASSWORD 'my_password' NOINHERIT VALID UNTIL 'infinity'. CREATEDATABASE redmine WITH ENCODING='UTF8' OWNER=redmine. SQL Server¶The database, login and user can be created within SQL Server Management Studio with a few clicks.
If you prefer the command line option with SQLCMD, here's some basic example: Show SQLHide SQLUSE [master]. CREATEDATABASE [REDMINE]. CREATE LOGIN [REDMINE] WITH PASSWORD=N'redminepassword', DEFAULT_DATABASE=[REDMINE], CHECK_EXPIRATION=OFF, CHECK_POLICY=OFF. CREATE USER [REDMINE] FOR LOGIN [REDMINE]. EXEC sp_addrolemember N'db_datareader', N'REDMINE'. EXEC sp_addrolemember N'db_datawriter', N'REDMINE'. Step 3 - Database connection configuration¶Copy config/database. Example for a My. SQL database (default port): production. If your server is not running on the standard port (3. Example for a Postgre. SQL database (default port): production. Example for a SQL Server database (default host localhost, default port 1. Step 4 - Dependencies installation¶Redmine uses Bundler to manage gems dependencies. You need to install Bundler first: gem install bundler. Then you can install all the gems required by Redmine using the following command: bundle install - -without development test. Optional dependencies¶RMagick (allows the use of Image. Magick to manipulate images for PDF and PNG export)¶If Image. Magick is not installed on your system, you should skip the installation of the rmagick gem using: bundle install - -without development test rmagick. If you have trouble installing rmagick on Windows, refer to this How. To. Database adapters¶Redmine automatically installs the adapter gems required by your database configuration by reading it from the config/database. Don't forget to re- run bundle install - -without development test .. Additional dependencies (Gemfile. If you need to load gems that are not required by Redmine core (eg. Puma, fcgi), create a file named Gemfile. It will be loaded automatically when running bundle install. Example. # Gemfile. Step 5 - Session store secret generation¶This step generates a random key used by Rails to encode cookies storing session data thus preventing their tampering. Generating a new secret token invalidates all existing sessions after restart. Alternatively, you can store this secret in config/secrets. Step 6 - Database schema objects creation¶Create the database structure, by running the following command under the application root directory. RAILS_ENV=production bundle exec rake db: migrate. Windows syntax. set RAILS_ENV=production. It will create tables by running all migrations one by one then create the set of the permissions and the application administrator account, named admin. Ubuntu troubleshooting: If you get this error with Ubuntu. Then you need to install libopenssl- ruby. Step 7 - Database default data set¶Insert default configuration data in database, by running the following command: RAILS_ENV=production bundle exec rake redmine: load_default_data. Redmine will prompt you for the data set language that should be loaded; you can also define the REDMINE_LANG environment variable before running the command to a value which will be automatically and silently picked up by the task. E. g.: Unices: RAILS_ENV=production REDMINE_LANG=fr bundle exec rake redmine: load_default_data. Windows. set RAILS_ENV=production. REDMINE_LANG=fr. bundle exec rake redmine: load_default_data. Step 8 - File system permissions¶NB: Windows users can skip this section. The user account running the application must have write permission on the following subdirectories: files (storage of attachments)log (application log file production. PDF documents among other things)public/plugin_assets (assets of plugins)E. R redmine: redmine files log tmp public/plugin_assets. R 7. 55 files log tmp public/plugin_assets. Step 9 - Test the installation¶Test the installation by running WEBrick web server. Once WEBrick has started, point your browser to http: //localhost: 3. You should now see the application welcome page. Note: Webrick is not suitable for production use, please only use webrick for testing that the installation up to this point is functional. Use one of the many other guides in this wiki to setup redmine to use either Passenger (aka mod_rails), FCGI or a Rack server (Unicorn, Thin, Puma, hellip; ) to serve up your redmine. Step 1. 0 - Logging into the application¶Use default administrator account to log in: login: adminpassword: admin. You can go to Administration menu and choose Settings to modify most of the application settings. Configuration¶Redmine settings are defined in a file named config/configuration. If you need to override default application settings, simply copy config/configuration. These settings may be defined per Rails environment (production/development/test). Important : don't forget to restart the application after any change. Email / SMTP server settings¶Email configuration is described in a dedicated page. SCM settings¶. This configuration section allows you to. SCM binaries present in the PATH variable doesn't use the standard name (Windows . Examples (with Subversion): Command name override: scm_subversion_command: "svn_replacement. Absolute path: scm_subversion_command: "C: \Program Files\Subversion\bin\svn. Attachment storage settings¶You can set a path where Redmine attachments will be stored which is different from the default 'files' directory of your Redmine instance using the attachments_storage_path setting. Examples: attachments_storage_path: /var/redmine/filesattachments_storage_path: D: /redmine/files. Logging configuration¶Redmine defaults to a log level of : info, writing to the log subdirectory. Depending on site usage, this can be a lot of data so to avoid the contents of the logfile growing without bound, consider rotating them, either through a system utility like logrotate or via the config/additional_environment. To use the latter, copy config/additional_environment. Note that the new logger defaults to a high log level and hence has to be explicitly set to info. Logger. new('/path/to/logfile. Logger: :INFOBackups¶. Redmine backups should include.
0 Comments
Leave a Reply. |
AuthorWrite something about yourself. No need to be fancy, just an overview. Archives
November 2017
Categories |