Installer.txt
上传用户:netsea168
上传日期:2022-07-22
资源大小:4652k
文件大小:6k
源码类别:

Ajax

开发平台:

Others

  1. How to use the Typo Rails installer
  2. ===================================
  3. Typo 4.4 includes an installer that makes it easy to install Typo.
  4. Quick Start
  5. -----------
  6. Here's the short version:
  7.   $ gem install typo
  8.   $ typo install /var/www/my_typo_site
  9. Prerequisites
  10. -------------
  11. You'll need the following software installed on your system:
  12. 1.  Ruby 1.8.6 or greater
  13. 2.  RubyGems (http://www.rubygems.org)
  14. 3.  SWIG (http://www.swig.org)
  15. 4.  MySQL, PostgreSQL or SQLite 3
  16. Most modern Unix systems should have all four of these easily available in
  17. pre-built form.
  18. Installing Typo
  19. ---------------
  20. 1. Install the Typo GEM.
  21.    Run 'gem install typo'.  This will install the current version of Typo
  22.    along with all dependencies.
  23. 2. Create a working Typo installation in a directory somewhere.
  24.    Run 'typo install DIRECTORY'.  Replace DIRECTORY with the name of the
  25.    directory that you want Typo to live in.  This will copy all of Typo's
  26.    files into DIRECTORY, create a new database for Typo to use, and start
  27.    Typo running on a random port number.
  28. 3. Verify that Typo works for you.  The installer will print a URL at the end
  29.    of the installation process; load it in a browser to test out Typo.
  30. 4. Once you're happy with Typo's configuration, follow the directions in
  31.    installer/apache.conf.example to run your Typo installation under Apache.
  32. Upgrading Typo
  33. --------------
  34. The Typo installer can upgrade an existing installer-created Typo install by 
  35. simple running 'typo install DIRECTORY'.  The installer will automatically
  36. detect that it's upgrading an existing install and will attempt to preserve
  37. the existing configuration as much as possible.
  38. Starting and Stopping Typo
  39. --------------------------
  40. To stop Typo from running, run `typo stop /path/to/typo`. To restart it, run
  41. `typo start /path/to/typo`. Since this Typo install uses Mongrel, not FastCGI,
  42. you can't depend on your web server restarting it automatically on reboot.
  43. You'll need to either create an init script or cron reboot entry to restart
  44. it, depending on your host and/or privilege level.
  45. Ask your hosting provider or the Typo mailing list (typo-list@rubyforge.org)
  46. if you need help with this.
  47. Configuration Variables
  48. -----------------------
  49. Each Typo installation maintains a list of configuration variables.  To see
  50. the list for an existing install, run 'typo config DIRECTORY'.  You can change
  51. them via 'typo config DIRECTORY name1=value1 name2=value2...'  For example:
  52.   typo config /var/www/typo web-server=mongrel_cluster
  53. Here's a list of available configuration variables in Typo 4.0.0:
  54. ### bind-address
  55. The `bind-address` controls which IP address(es) Mongrel uses. By default,
  56. Mongrel listens for connections on all IP addresses that are in use on the
  57. server. You can restrict this by setting `bind-address`. The most useful
  58. setting is probably `bind-address=127.0.0.1`, which will tell Mongrel to only
  59. listen to connections from the local server.
  60. ### database
  61. The `database` variable controls which Database driver Typo uses. By default,
  62. this is `sqlite`. Setting it to any other value will supress SQLite-specific
  63. upgrade and maintenance commands.
  64. ### port-number
  65. The `port-number` variable controls which TCP port Mongrel uses. By default,
  66. it's a random number between 4000 and 5000.
  67. ### rails-environment
  68. This controls which Rails environment Typo uses. This defaults to
  69. `production`; the other usable value is `development`.
  70. ### threads
  71. The `threads` variable controls how many copies of Mongrel are used when using
  72. the `mongrel_cluster` web server. Each thread listens on its own port number,
  73. so setting `threads=2` while `port-number` is 4000 will make mongrel-cluster
  74. run two copies of Mongrel, one listening on port 4000 and one on 4001.
  75. ### url-prefix
  76. The `url-prefix` variable is used to tell Typo to run in a subdirectory
  77. instead of the root of a specific URL hostname. For example, if you want Typo
  78. to live at http://blog.example.com/blog instead of http://blog.example.com/,
  79. then you'd need to set `url-prefix=/blog`.
  80. ### web-server
  81. The `web-server` variable controls which server Typo uses. By default,
  82. `web-server` is `mongrel`, but you can change it to `mongrel-cluster` or
  83. `external`. If you use `external`, then 'typo PATH start` won't start a web
  84. server of its own, and you'll have to provide your own web server. This is the
  85. easiest way to use Typo with FastCGI--just set `web-server=external` and then
  86. tweak `.htaccess`.
  87. Troubleshooting
  88. ---------------
  89. ### Tests fail with ID=0
  90. You didn't install Swig before installing `sqlite3-ruby`. Uninstall the SQLite
  91. driver, install Swig, and then re-install `sqlite3-ruby`.
  92. ### SQLite dies with "unsupported file format"
  93. You have multiple versions of SQLite3 installed, and you're using the command-line tool from one with the library from the other.  Most likely this is on OS X with Darwinports.  Make sure that `/opt/local/bin` is ahead of `/usr/bin` in your path.
  94. ### MySQL fails with timeout errors
  95. Install the MySQL GEM. It's faster then Rails' default MySQL driver, and it
  96. works substantially better.
  97. ### Typo crashes randomly
  98. First, try running Typo under Webrick in the foreground to see if you can
  99. reproduce the problem. Run `RAILS_ENV=production ./script/server webrick` from
  100. your Typo directory and then see if you can get it to crash. If it dies, then
  101. open a Trac ticket (http://typosphere.org/trac) describing the problem and
  102. include the crash message along with any relevant information from the logs.
  103. Also include which version of Ruby (ruby -v), Rails, and Typo, and which OS
  104. you're using.
  105. Generally, if Typo suddenly exiting, it's probably caused by a bad Ruby
  106. interpreter on your system.