Skip to content

Commit

Permalink
Add documation for dealing with /dev/random issues
Browse files Browse the repository at this point in the history
You may occasionally see that nodes will not immediately connect this
with the hub. In some cases the delay has been as high as 40 minutes.
This is due to a known problem with linux containers where there is a
lack of entropy within the running container. [James Bayer](http://blog.pivotal.io/cloud-foundry-pivotal/features/challenges-with-randomness-in-multi-tenant-linux-container-platforms) wrote a great article explaining the core of the problem.

Resolve #14
  • Loading branch information
mtscout6 committed Dec 12, 2014
1 parent a1002d2 commit ef53bd4
Show file tree
Hide file tree
Showing 8 changed files with 136 additions and 0 deletions.
17 changes: 17 additions & 0 deletions Hub/README.md
Expand Up @@ -26,6 +26,23 @@ Selenium has the support of some of the largest browser vendors who have taken (

See the Selenium [site](http://docs.seleniumhq.org/) for documation on usage within your test code.

## Known Issues

### Problems with `/dev/random`

You may occasionally see that nodes will not immediately connect with the hub. In some cases the delay has been as high as 40 minutes. This is due to a known problem with linux containers where there is a lack of entropy within the running container. [James Bayer](http://blog.pivotal.io/cloud-foundry-pivotal/features/challenges-with-randomness-in-multi-tenant-linux-container-platforms) wrote a great article explaining the core of the problem.


You can either install an entropy gathering daemon (EGD), such as [HAVEGED](http://www.issihosts.com/haveged/index.html), on you docker host.

-- or --

Run your container with the `-v /dev/urandom:/dev/random` option. ie:

```
$ docker run -d -v /dev/urandom:/dev/random --link selenium-hub:hub selenium/node-firefox
```

## License

View [license information](https://code.google.com/p/selenium/source/browse/COPYING) for the software contained in this image.
Expand Down
17 changes: 17 additions & 0 deletions NodeBase/README.md
Expand Up @@ -27,6 +27,23 @@ Selenium has the support of some of the largest browser vendors who have taken (

See the Selenium [site](http://docs.seleniumhq.org/) for documation on usage within your test code.

## Known Issues

### Problems with `/dev/random`

You may occasionally see that nodes will not immediately connect with the hub. In some cases the delay has been as high as 40 minutes. This is due to a known problem with linux containers where there is a lack of entropy within the running container. [James Bayer](http://blog.pivotal.io/cloud-foundry-pivotal/features/challenges-with-randomness-in-multi-tenant-linux-container-platforms) wrote a great article explaining the core of the problem.


You can either install an entropy gathering daemon (EGD), such as [HAVEGED](http://www.issihosts.com/haveged/index.html), on you docker host.

-- or --

Run your container with the `-v /dev/urandom:/dev/random` option. ie:

```
$ docker run -d -v /dev/urandom:/dev/random --link selenium-hub:hub selenium/node-firefox
```

## License

View [license information](https://code.google.com/p/selenium/source/browse/COPYING) for the software contained in this image.
Expand Down
17 changes: 17 additions & 0 deletions NodeChrome/README.md
Expand Up @@ -27,6 +27,23 @@ Selenium has the support of some of the largest browser vendors who have taken (

See the Selenium [site](http://docs.seleniumhq.org/) for documation on usage within your test code.

## Known Issues

### Problems with `/dev/random`

You may occasionally see that nodes will not immediately connect with the hub. In some cases the delay has been as high as 40 minutes. This is due to a known problem with linux containers where there is a lack of entropy within the running container. [James Bayer](http://blog.pivotal.io/cloud-foundry-pivotal/features/challenges-with-randomness-in-multi-tenant-linux-container-platforms) wrote a great article explaining the core of the problem.


You can either install an entropy gathering daemon (EGD), such as [HAVEGED](http://www.issihosts.com/haveged/index.html), on you docker host.

-- or --

Run your container with the `-v /dev/urandom:/dev/random` option. ie:

```
$ docker run -d -v /dev/urandom:/dev/random --link selenium-hub:hub selenium/node-firefox
```

## License

View [license information](https://code.google.com/p/selenium/source/browse/COPYING) for the software contained in this image.
Expand Down
17 changes: 17 additions & 0 deletions NodeChromeDebug/README.md
Expand Up @@ -50,6 +50,23 @@ Selenium has the support of some of the largest browser vendors who have taken (

See the Selenium [site](http://docs.seleniumhq.org/) for documation on usage within your test code.

## Known Issues

### Problems with `/dev/random`

You may occasionally see that nodes will not immediately connect with the hub. In some cases the delay has been as high as 40 minutes. This is due to a known problem with linux containers where there is a lack of entropy within the running container. [James Bayer](http://blog.pivotal.io/cloud-foundry-pivotal/features/challenges-with-randomness-in-multi-tenant-linux-container-platforms) wrote a great article explaining the core of the problem.


You can either install an entropy gathering daemon (EGD), such as [HAVEGED](http://www.issihosts.com/haveged/index.html), on you docker host.

-- or --

Run your container with the `-v /dev/urandom:/dev/random` option. ie:

```
$ docker run -d -v /dev/urandom:/dev/random --link selenium-hub:hub selenium/node-firefox
```

## License

View [license information](https://code.google.com/p/selenium/source/browse/COPYING) for the software contained in this image.
Expand Down
17 changes: 17 additions & 0 deletions NodeDebug/README.template.md
Expand Up @@ -50,6 +50,23 @@ Selenium has the support of some of the largest browser vendors who have taken (

See the Selenium [site](http://docs.seleniumhq.org/) for documation on usage within your test code.

## Known Issues

### Problems with `/dev/random`

You may occasionally see that nodes will not immediately connect with the hub. In some cases the delay has been as high as 40 minutes. This is due to a known problem with linux containers where there is a lack of entropy within the running container. [James Bayer](http://blog.pivotal.io/cloud-foundry-pivotal/features/challenges-with-randomness-in-multi-tenant-linux-container-platforms) wrote a great article explaining the core of the problem.


You can either install an entropy gathering daemon (EGD), such as [HAVEGED](http://www.issihosts.com/haveged/index.html), on you docker host.

-- or --

Run your container with the `-v /dev/urandom:/dev/random` option. ie:

```
$ docker run -d -v /dev/urandom:/dev/random --link selenium-hub:hub selenium/node-firefox
```

## License

View [license information](https://code.google.com/p/selenium/source/browse/COPYING) for the software contained in this image.
Expand Down
17 changes: 17 additions & 0 deletions NodeFirefox/README.md
Expand Up @@ -27,6 +27,23 @@ Selenium has the support of some of the largest browser vendors who have taken (

See the Selenium [site](http://docs.seleniumhq.org/) for documation on usage within your test code.

## Known Issues

### Problems with `/dev/random`

You may occasionally see that nodes will not immediately connect with the hub. In some cases the delay has been as high as 40 minutes. This is due to a known problem with linux containers where there is a lack of entropy within the running container. [James Bayer](http://blog.pivotal.io/cloud-foundry-pivotal/features/challenges-with-randomness-in-multi-tenant-linux-container-platforms) wrote a great article explaining the core of the problem.


You can either install an entropy gathering daemon (EGD), such as [HAVEGED](http://www.issihosts.com/haveged/index.html), on you docker host.

-- or --

Run your container with the `-v /dev/urandom:/dev/random` option. ie:

```
$ docker run -d -v /dev/urandom:/dev/random --link selenium-hub:hub selenium/node-firefox
```

## License

View [license information](https://code.google.com/p/selenium/source/browse/COPYING) for the software contained in this image.
Expand Down
17 changes: 17 additions & 0 deletions NodeFirefoxDebug/README.md
Expand Up @@ -50,6 +50,23 @@ Selenium has the support of some of the largest browser vendors who have taken (

See the Selenium [site](http://docs.seleniumhq.org/) for documation on usage within your test code.

## Known Issues

### Problems with `/dev/random`

You may occasionally see that nodes will not immediately connect with the hub. In some cases the delay has been as high as 40 minutes. This is due to a known problem with linux containers where there is a lack of entropy within the running container. [James Bayer](http://blog.pivotal.io/cloud-foundry-pivotal/features/challenges-with-randomness-in-multi-tenant-linux-container-platforms) wrote a great article explaining the core of the problem.


You can either install an entropy gathering daemon (EGD), such as [HAVEGED](http://www.issihosts.com/haveged/index.html), on you docker host.

-- or --

Run your container with the `-v /dev/urandom:/dev/random` option. ie:

```
$ docker run -d -v /dev/urandom:/dev/random --link selenium-hub:hub selenium/node-firefox
```

## License

View [license information](https://code.google.com/p/selenium/source/browse/COPYING) for the software contained in this image.
Expand Down
17 changes: 17 additions & 0 deletions README.md
Expand Up @@ -108,6 +108,23 @@ When you are prompted for the password it is __secret__. If you wish to change t
RUN x11vnc -storepasswd <your-password-here> /home/seluser/.vnc/passwd
```

## Known Issues

### Problems with `/dev/random`

You may occasionally see that nodes will not immediately connect with the hub. In some cases the delay has been as high as 40 minutes. This is due to a known problem with linux containers where there is a lack of entropy within the running container. [James Bayer](http://blog.pivotal.io/cloud-foundry-pivotal/features/challenges-with-randomness-in-multi-tenant-linux-container-platforms) wrote a great article explaining the core of the problem.


You can either install an entropy gathering daemon (EGD), such as [HAVEGED](http://www.issihosts.com/haveged/index.html), on you docker host.

-- or --

Run your container with the `-v /dev/urandom:/dev/random` option. ie:

```
$ docker run -d -v /dev/urandom:/dev/random --link selenium-hub:hub selenium/node-firefox
```

##### Look around

``` bash
Expand Down

0 comments on commit ef53bd4

Please sign in to comment.