Windows installation documentation

This commit is contained in:
Tibo Vanheule 2018-12-12 23:00:21 +01:00
parent 6db0a41f9d
commit 7e1c533f98
5 changed files with 59 additions and 0 deletions

1
.gitignore vendored
View file

@ -24,3 +24,4 @@ public/system/users
.project
/coverage

View file

@ -83,3 +83,6 @@ gem 'delayed_job', '~> 4.0'
gem 'delayed_job_active_record'
gem 'httparty', '0.13.7'
# windows support (linux timezone directory is used in the project)
gem 'tzinfo-data', platforms: [:mingw, :mswin, :x64_mingw]

View file

@ -7,3 +7,7 @@ Yes. We have to drink. But we also have to pay. This is the drinking part.
2. Run `bundle update` and `bundle install`
3. Migrate the db using `bundle exec rake db:migrate`
4. Start Tap by running `bundle exec rails s`
## Windows installation
[klik hier](README_WINDOWS.md)

51
README_WINDOWS.md Normal file
View file

@ -0,0 +1,51 @@
# Windows installation
This project can't be run with the latest ruby version. With rbenv you can install multiple ruby versions on your pc.
## Rbenv install
This is a very simple install, just run the cmd bat script as administrator from https://gist.github.com/nak1114/7ea63204203883c5884d
Now in a new in a new command prompt run the following commands:
```
`rbenv rehash`
```
Note: 7z can ask you to extract an archive, simple click extract
## SSL problem
Sometimes rbenv doesn't install the root certificate, so you can't download any gems.
follow these steps for the fix https://bundler.io/v1.16/guides/rubygems_tls_ssl_troubleshooting_guide.html#updating-ca-certificates
## Use the ruby interpreter in ruby mine ide
Go to file->settings
Under "Ruby SDK and gems", click on the plus sign to add a new local.
The path shouled something of the following. (copy the path first in windows explorer, then the %USERPROFILE% gets automatically replaced)
```
%USERPROFILE%\.rbenv-win\versions\2.3.3-x64\bin
```
now select the ruby.exe and set the interpreter on for the project.
![event log ](event_log.png)
Ruby mine, will detect it has some uninstalled gems, click on install. Then click on "ok", "install". Now ruby Mine will install Bundler and all the gems specified in the gem file.
you will get a warning about bundle.bat, just ignore it.
Now "views"->"tool windows"->"terminal" will open a terminal, run the following command `rake db:migrate` .
Now you can just run the project (shift + F10)
## References
https://bundler.io/v1.16/guides/rubygems_tls_ssl_troubleshooting_guide.html#updating-ca-certificates
https://github.com/nak1114/rbenv-win

BIN
event_log.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 23 KiB