Skip to content

Commit

Permalink
Updated CHANGELOG and README
Browse files Browse the repository at this point in the history
  • Loading branch information
grtjn committed Jul 1, 2019
1 parent aef9c6a commit 3d89f1d
Show file tree
Hide file tree
Showing 2 changed files with 67 additions and 17 deletions.
33 changes: 32 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,44 @@
# Change Log

## [1.0.6](https://github.com/grtjn/mlvagrant/tree/1.0.6) (2019-07-01)
[Full Changelog](https://github.com/grtjn/mlvagrant/compare/1.0.5...1.0.6)

**Implemented enhancements:**

- MarkLogic 9.0-4 has separate Converters installer [\#122](https://github.com/grtjn/mlvagrant/issues/122)
- Support MarkLogic 10 [\#135](https://github.com/grtjn/mlvagrant/issues/135)
- Remove bower, tomcat and other things that should not be running alongside MarkLogic on the same VM [\#134](https://github.com/grtjn/mlvagrant/issues/134)
- Upgrade to LTS Node v10 [\#133](https://github.com/grtjn/mlvagrant/issues/133)
- Add pm2-logrotate to pm2 install [\#130](https://github.com/grtjn/mlvagrant/issues/130)
- Add centos-6.9 and centos-7.3 baseboxes [\#115](https://github.com/grtjn/mlvagrant/issues/115)
- Upgrading/installing git 2 [\#108](https://github.com/grtjn/mlvagrant/issues/108)

**Fixed bugs:**

- Trying to install ML 9.0-9 failed dependency [\#132](https://github.com/grtjn/mlvagrant/issues/132)
- VMs don't attempt to prevent clock skew [\#127](https://github.com/grtjn/mlvagrant/issues/127)
- Upgrade Vagrant wipes out /opt/vagrant directory [\#126](https://github.com/grtjn/mlvagrant/issues/126)
- Trying to install MarkLogicConverters-9.0-5.x86\_64 fails - missing libs [\#125](https://github.com/grtjn/mlvagrant/issues/125)
- re: CentOS 7.3, vagrant up hangs on SSH step [\#124](https://github.com/grtjn/mlvagrant/issues/124)
- Attempting Install and Reinstall Throwing Lots of Errors \(See log\) [\#123](https://github.com/grtjn/mlvagrant/issues/123)
- Centos-7.3 connection timeout [\#116](https://github.com/grtjn/mlvagrant/issues/116)

**Closed issues:**

- Upgrade to LTS Node v8 [\#121](https://github.com/grtjn/mlvagrant/issues/121)
- Add TOC at top of README [\#117](https://github.com/grtjn/mlvagrant/issues/117)

**Merged pull requests:**

- Prevent clockskew [\#120](https://github.com/grtjn/mlvagrant/pull/120) ([Audarth](https://github.com/Audarth))

## [1.0.5](https://github.com/grtjn/mlvagrant/tree/1.0.5) (2017-06-26)
[Full Changelog](https://github.com/grtjn/mlvagrant/compare/1.0.4...1.0.5)

**Implemented enhancements:**

- Setup of pm2 startup script on Centos/RH 7 [\#114](https://github.com/grtjn/mlvagrant/issues/114)
- Reloading MarkLogic [\#112](https://github.com/grtjn/mlvagrant/issues/112)
- Upgrading/installing git 2 [\#108](https://github.com/grtjn/mlvagrant/issues/108)
- Upgrade NodeJS [\#100](https://github.com/grtjn/mlvagrant/issues/100)
- Dynamically search ML installers [\#53](https://github.com/grtjn/mlvagrant/issues/53)

Expand Down
51 changes: 35 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,8 @@ Scripts for bootstrapping a local MarkLogic cluster for development purposes usi
- Easy creation of VirtualBox VMs
- Works on Windows, MacOS, and Linux
- Uses pre-built CentOS Vagrant base boxes
- Supports MarkLogic 5 up to 9
- Supports CentOS 5.11 up to 7.2
- Supports MarkLogic 5 up to 10
- Supports CentOS 5.11 up to 7.2 (7.2 is auto-updated to latest)
- Automatic setup of cluster
- Also installs MLCP, Java, NodeJS, Ruby, etc
- Highly configurable
Expand Down Expand Up @@ -52,7 +52,7 @@ Note: this project used to depend on chef/centos boxes, but they are no longer a
You first need to download and install prerequisites and mlvagrant itself:

- Download and install [VirtualBox](https://www.virtualbox.org/wiki/Downloads)
- When using VirtualBox 5.1, make sure to use latest baseboxes, e.g. those for CentOS 6.9 and 7.2
- When using VirtualBox 5.1+, make sure to use latest baseboxes, e.g. those for CentOS 6.9 and 7.2
- Download and install [Vagrant](https://www.vagrantup.com/downloads.html)
- Install the [vagrant-hostmanager](https://github.com/smdahlen/vagrant-hostmanager) plugin:
- `vagrant plugin install vagrant-hostmanager`
Expand All @@ -64,8 +64,8 @@ You first need to download and install prerequisites and mlvagrant itself:
- `sudo mkdir -p /space/software`
- Make sure Vagrant has write access to that folder:
- `sudo chmod 777 /space/software`
- Download [MarkLogic 9 for CentOS](http://developer.marklogic.com/products) (login required)
- Download [MLCP 9 binaries](http://developer.marklogic.com/products/mlcp)
- Download [MarkLogic 10 for CentOS](http://developer.marklogic.com/products) (login required)
- Download [MLCP 10 binaries](http://developer.marklogic.com/products/mlcp)
- Move MarkLogic rpm, and MLCP zip to `/space/software` (no need to unzip MLCP!)
- Download mlvagrant:
- `git clone https://github.com/grtjn/mlvagrant.git`
Expand Down Expand Up @@ -130,13 +130,13 @@ That will do the same as above, but additionally flush the MarkLogic data direct
The `project.properties` file contains various settings, amongst others:

- `nr_hosts`, defaults to 3
- `ml_version`, defaults to '9'
- `ml_version`, defaults to '10'

The minimum number of hosts is 1, the maximum is limited mostly by the local resources you have available. Each vm will take 2.5Gb of disk space, and by default (also in the Vagrantfile) takes 2Gb of ram, and 2 CPU cores.

Note: although you can technically create a cluster of just 2 nodes, 3 nodes is required for proper fail-over. The cluster needs a quorum to vote if a host should be excluded.

The ml_version is used in the `install-ml-centos.sh` script to select the appropriate installer. Code is in place to install versions 5, 6, 7, 8, and 9. The install-ml script refers to latest rpms by exact name, which includes subversion number, and patch level. Use the ml_installer property to override with the exact version you prefer to install.
The ml_version is used in the `install-ml-centos.sh` script to select the appropriate installer. Code is in place to install versions 5, 6, 7, 8, 9, and 10. The install-ml script refers to latest rpms by exact name, which includes subversion number, and patch level. Use the ml_installer property to override with the exact version you prefer to install.

For the full list of settings see below..

Expand All @@ -153,9 +153,10 @@ CentOS base VM version - defaults to 7.2, allowed: 5.11/6.5/6.6/6.7/6.8/6.9/7.0/

Note: MarkLogic 8+ does not support CentOS 5-
Note: MarkLogic 9+ does not support CentOS 6-
Note: MarkLogic 10+ seems to need latest CentOS 7, which is why OS is updated by default since mlvagrant 1.0.6

### ml_version
Major MarkLogic release to install - defaults to 9, allowed: 5,6,7,8,9 (installers need to be present)
Major MarkLogic release to install - defaults to 10, allowed: 5,6,7,8,9,10 (installers need to be present)

### nr_hosts
Number of hosts in the cluster - defaults to 3, minimum for failover support
Expand Down Expand Up @@ -202,12 +203,12 @@ Override hard-coded MarkLogic installers (file is searched in /space/software, o
Override hard-coded MLCP installers (file is searched in /space/software, or c:\space\software\ on Windows)

### update_os
Run full OS updates - defaults to false
Run full OS updates - defaults to true

Note: doing this with CentOS 6.5 or 7.0 will take it up to the very latest minor release (6.9+ resp 7.2+)
Note: doing this with CentOS 6.5 or 7.0 will take it up to the very latest minor release (6.9+ resp 7.6+)

### install_dev_tools
Install group "Development tools" - defaults to false
Install group "Development tools" - defaults to true

### install_zip
Install zip/unzip - defaults to true
Expand All @@ -227,10 +228,10 @@ Note: installs an MLCP version that matches ml_version, unless an explicit mlcp_
Note: this will force installation of JDK 8, and unzip (unzip required for installation)

### install_nodejs
Install Node.js, npm, bower, gulp, forever (globally) - defaults to true
Install Node.js, npm - defaults to true

### install_nodejs_lts
Install Long-Term Support version of Node.js (v6 currently) - defaults to true
Install Long-Term Support version of Node.js (v10 currently) - defaults to true

### install_ruby
Install Ruby - default to true
Expand All @@ -243,11 +244,13 @@ Install Git command-line tools - defaults to true

### install_git_project
Initializes a bare Git repository under /space/projects, along with a user named {project_name} to use it
Also installs legacy tooling for it, including bower, gulp, forever (globally)

### install_pm2
Install PM2 NodeJs Process Manager, for running NodeJs services - defaults to true

Note: this will force installation of Git v2.
Note: pm2-logrotate was added by default since 1.0.6

### install_httpd
Install and enable HTTPD service - defaults to true
Expand All @@ -259,10 +262,11 @@ Install modules and tools for SSL/HTTPS - defaults to true

Note: HTTPD needs to be configured properly to enable HTTPS in there. See [README](#using-https-with-httpd) for details.

### install_tomcat
Install Tomcat, and enable the service - defaults to true
### install_tomcat / launch_tomcat
Install Tomcat - defaults to true
Enable the service - defaults to false

Note: Tomcat could be pre-installed, but usually isn't enabled by default. This will make sure it is installed, and enabled.
Note: Tomcat could be pre-installed, but usually isn't enabled by default. This will make sure it is installed. It is not launched by default for security reasons.
Note: on CentOS 5 you get Tomcat 5 (tomcat5), on CentOS 6 you get Tomcat 6 (tomcat6), on CentOS 7 you get Tomcat 7 (tomcat)

## Fixing IP issues with public_network
Expand Down Expand Up @@ -416,6 +420,21 @@ Usually as long as the Guest Additions version is higher than that of your Virtu

https://github.com/dotless-de/vagrant-vbguest#running-as-a-command

In the event Guest Additions and VirtualBox are too much out of synch, you could get a message like this:

```
[vagrant-ml1] No Virtualbox Guest Additions installation found.
Updating GuestAdditions skipped.
```

This seems to be the case when using the centos-7.2 basebox (one of the most recent currently) against VirtualBox 5.2, and typically occurs **after** the first halt/up. In that case you are forced to reinstall them. You can do so easily using:

```
vagrant vbguest --do install --no-cleanup
```

Once completed, you should be able to halt/up your vm(s) as pleased without any further issues.

## Changing cpu or memory

Pretty simple:
Expand Down

0 comments on commit 3d89f1d

Please sign in to comment.