Skip to content

Latest commit

 

History

History
84 lines (66 loc) · 4.2 KB

SETUPMYMAC.md

File metadata and controls

84 lines (66 loc) · 4.2 KB

Automatically Setup Your macOS Environment

If you have a MacBook you undoubtedly have never used LDAP on it, have a version of the Ruby programming language installed that you also haven't used much, and the Apache httpd web server is disabled. Why not put them to use?

Simple Whimsy.Local Installation

It is easy, run the following two commands:

git clone [email protected]:apache/whimsy.git
whimsy/config/setupmymac

This will prompt you for your password a few times, and if you are running macOS Catalina will even require you to reboot your machine at one point.

Once complete, you will have a virtual host defined as whimsy.local that you can access in your web browser. The whole process should take about five minutes, possibly less if you already have things like brew installed.

Simple Whimsy.Local Installation With docker

Don't want to install things on your machine? If you have Docker installed, you can use that instead, simply pass --docker to the setupmymac command above and you will have a Docker image created. This will take longer, require more disk space, runs slower, and is less convenient, but is more secure, more closely matches how the production whimsy server is configured, and can easily be removed when done. Once complete, you start the Docker server with the following commands:

cd /srv/whimsy
rake docker:up

When running on Docker, you will access the whimsy server using http://localhost:1999. You can edit your source code on your Mac machine using your favorite IDE. If you need to "shell" into the Docker container (perhaps to view a log file?), you can do so:

cd /srv/whimsy
rake docker:exec

The Docker configuration is new and hasn't been heavily tested, so there likely will be some problems. Join us on [email protected], or even better, provide a pull request!

You can even switch back and forth (using the same checked out svn files and whimsy source code) by rerunning setupmymac again with a different option. Once you have both configurations set up running this command again will change permissions on a few files, but generally will leave everything else is the same. If you want to update more (say, to get a new version of passenger), there are options to do that, enter whimsy/config/setupmymac --help for details. Pass --update-all to update everything.

Setupmymac Command Line Reference

Command Description
setupmymac Ensure that everything is installed, checked out, cloned
setupmymac --svn Ensure that everything is installed, update svn
setupmymac --update-all Ensure that everything is up to date
setupmymac --update-all --no-svn Ensure that everything is up to date, except for svn
setupmymac --all Ensure that everything is up to date and launched
setupmymac --no-ws Stop board agenda websocket daemon
setupmymac --docker Configure for docker usage
setupmymac --docker --prune Clean start container
setupmymac --clean Reset /srv/whimsy - danger may cause lost changes
setupmymac --user Set up webserver to run under your user id
setupmymac --dry-run show what commands would have been issued

Setupmymac notes

  • Two long running daemons (toucher and websocket) can be started with this and these daemons will continue to run and will restart on system restart until explicitly stopped.
  • Cleaning /srv/whimsy may be needed if you change your version of Ruby or Gems.
  • Running the web server under your user is, in general, not recommended but may be handy if you are running in to file permission problems setting up a test. Just remember to reset these file permissions by running setupmymac again.
  • Dry run may not be accurate as running commands may change the state of the system, affecting what subsequent commands are necessary.

If you want to know what is going on under the covers with the setupmymac scripts, visit either of the detailed step-by-step macOS or Docker instructions.