Skip to content

Commit 4d1976b

Browse files
committed
updated readme
1 parent 7f86cd4 commit 4d1976b

File tree

4 files changed

+19
-9
lines changed

4 files changed

+19
-9
lines changed

README.md

Lines changed: 19 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,13 @@
22
## Nullix Server Hardware Performance Test Tool (NSHPTT)
33
A simple tool to test raw performance of any server, pc or machine. It features CPU and Disk stress tests and can/should be used to compare multiple machines to find bottlenecks.
44

5-
I created this because after a huge migration from one hosting company/location to another with tons of virtual machines, there was a lot of performance issues at the new location, which where incredible hard to nail down. At the end we found disk performance problems which only showed up clearly when reading files > 100MB... Long story short, this tool was developed to find this issues and have reproducable and comparable results.
5+
I created this because after a huge migration from one hosting company/location to another with tons of virtual machines, there was a lot of performance issues at the new location, which where incredible hard to nail down. At the end we found disk performance problems which only showed up on very specific workloads that this test simulates. Long story short: This tool was developed to find this issues and have reproducable and comparable results.
66

7-
![Slideshow](media/slideshow.gif?raw=true "NSHPTT")
7+
[![Watch the video](media/demo.jpg)](media/demo.mov)
88

99
## Features
1010

11+
- Supported on almost every platform and architecture with pre-built binaries or go source
1112
- Single Core Performance Test. The test just calculates square-root of random floats as often as it can, for a set amount of time.
1213
- For servers it's better to test single core performance, as all cores would probably have the same specs anyway. With this method you can compare different infrastructures better then with multi-core tests.
1314
- Disk Write-Read-Delete Test. Does write, than read, than delete files with random byte contents. Size, location and amount of file can be configured.
@@ -28,9 +29,18 @@ After the tests are stopped, a summary .html/.csv file is generated which you ca
2829
## Usage Pre-Built Binaries
2930
Download a pre-built binary from "Releases" for your OS architecture and run it via command-line. The man page will show up that lists you all possible usages.
3031

31-
nshptt_linux_amd64 --create-config
32-
nshptt_linux_amd64 --create-test-files
33-
nshptt_linux_amd64 --run
32+
# linux server example - start in a new empty folder
33+
wget https://github.com/NullixAT/nullix-server-hardware-performance-test-tool/releases/latest/download/nshptt_linux_amd64
34+
chmod +x nshptt_linux_amd64
35+
./nshptt_linux_amd64 --create-config
36+
./nshptt_linux_amd64 --create-test-files
37+
./nshptt_linux_amd64 --run
38+
39+
# windows example - start in a new empty folder
40+
curl -O -L https://github.com/NullixAT/nullix-server-hardware-performance-test-tool/releases/latest/download/nshptt_win_amd64.exe
41+
.\nshptt_win_amd64.exe --create-config
42+
.\nshptt_win_amd64.exe --create-test-files
43+
.\nshptt_win_amd64.exe --run
3444

3545
> Notice: The pre-compiled binaries can probably be detected by anti-virus software, as they are not signed and AV heuristics maybe struggle with that.
3646
If you don't trust the pre-compiled binaries, feel free to directly use the `Usage directly with GO` variant. You can review and inspect the script before you run it.
@@ -42,15 +52,15 @@ If you don't trust the pre-compiled binaries, feel free to directly use the `Usa
4252
go run tool.go --run
4353

4454

45-
# CSV Format
55+
## CSV Format
4656
The result CSV contains `type;time_microseconds;value;timestamp`.
4757
- type: Type of test
4858
- time_microseconds: The time used for actually executing the only test-revelant part, excluding time to setup the test before it can run (file creation, logging, etc...)
4959
- value: The value for values other than time_, for example the CPU cycles
5060
- timestamp: The timestamp of when the actual CSV row has been written
5161

5262

53-
# HTML Format
63+
## HTML Format
5464
The result HTML contains an easy viewable page with charts to make it easier for humans to read.
5565

5666
## Development
@@ -62,12 +72,12 @@ Always create an `issue` at github before you start changing things that you wan
6272
- Add any changes to the `RELEASEINFO.md` for the next release cycle
6373

6474
## Create release
65-
We create releases with an automated github actions, see `.github/workflows/release.yml`
75+
We create releases with automated github actions, see `.github/workflows/release.yml`
6676

6777

6878
## Build/Compile local
6979
- Requirements: run `bash setup.sh`
7080

7181
Just have a look at `build.sh` to see a list of all supported platforms and architectures and show to compile them with a single command line call.
7282

73-
Run `bash setup.sh` to build all into `build` directory.
83+
Run `bash build.sh` to build all into `build` directory.

media/demo.jpg

41.4 KB
Loading

media/demo.mov

8.65 MB
Binary file not shown.

media/slideshow.gif

-193 KB
Binary file not shown.

0 commit comments

Comments
 (0)