summaryrefslogtreecommitdiff
path: root/PKG_WINDOWS.md
blob: c22c0f86ab776454b26b78158090e193e353d1cd (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
# Build RabbitMQ Windows Package using Windows

## Environment

Windows 8.1 using this `Vagrantfile`:

```
Vagrant.configure("2") do |config|
  config.vm.box = "inclusivedesign/windows81-eval-x64"
  config.vm.provider "virtualbox" do |v|
    v.gui = true
  end
end
```

Note that these steps should work on more recent versions of Windows as well.
If you have issues using a newer version of Windows, please provide full
details in a message to the
[`rabbitmq-users`](https://groups.google.com/forum/#!forum/rabbitmq-users)
mailing list.

## Initial Steps

Bring up the VM and go through the process of updating Windows and (optionall)
VirtualBox tools. You'll notice that the evaluation license is expired. Re-arm
it by running this command via an administrative prompt:

```
slmgr -rearm
```

This part of the process will take a while as Windows is updated. Go make some
coffee and check your email.

## Install Erlang and Elixir

Using Chocolatey is the easiest method to install the most recent version of
Erlang and Elixir. Install Chocolatey [using these
instructions](https://chocolatey.org/install#installing-chocolatey)
([link](https://chocolatey.org/install#installing-chocolatey)), then install
both Erlang and Elixir using this command from an *administrative* `cmd.exe` or
Powershell terminal:

```
choco install elixir which
```

To confirm installation, open a new command prompt and run the following:

```
erl -version
elixir -v
which erl
which elixir
```

## Install MSYS2 and NSIS

Chocolatey is also an easy way to install `msys2` and the NSIS install script
builder. Run the following from an *administrative* command prompt:

```
choco install msys2 nsis
```

As a bonus, it will update your `msys2` installation for you during the initial
install process.

## Install MSYS2 packages

Start up an `msys2` shell by running the following command (does not have to be
admin):

```
C:\tools\msys64\msys2_shell.cmd
```

In that shell, install all of these dependencies. If you are prompted for
input, just hit ENTER to choose the default:

```
pacman -S --needed git make tar rsync python zip unzip dos2unix man
```

## Build RabbitMQ

### Clone this repository

From within your MSYS2 shell:

```
git clone https://github.com/rabbitmq/rabbitmq-server-release.git
```

### Set `PATH`

```
export PATH="$PATH:/c/ProgramData/Chocolatey/bin:/c/ProgramData/Chocolatey/lib/Elixir/bin:/c/Program Files (x86)/NSIS/bin"
```

### Fetch and build deps

*Note:* as of this writing, RabbitMQ `3.7.8` is the latest version. Be sure to check out the tag appropriate for your use:

```
cd rabbitmq-server-release

# the following checks out the "next to be released" branch
# this branch and version 3.7.9 have a necessary fix for building
# on windows, see this: https://github.com/rabbitmq/rabbitmq-server-release/pull/89

git checkout v3.7.x

make deps
```

### Build Windows package

```
make UNIX_TO_DOS=unix2dos package-windows
```