# nodus-server-manager

> ## Installation ##

Latest version **1.1.2** (published 2017-08-05) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install nodus-server-manager
pnpm add nodus-server-manager
yarn add nodus-server-manager
bun add nodus-server-manager
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.1.2 |
| Published | 2017-08-05 |
| First published | 2017-07-30 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 30 |
| Known vulnerabilities | 0 (+24 in 9 direct dependencies) |
| Install scripts | no |
| Maintainers | bradserbu |

## Links

- npm: https://www.npmjs.com/package/nodus-server-manager
- npm.io page: https://npm.io/package/nodus-server-manager

## Dependencies (30)

- [ws](https://npm.io/package/ws.md) ^3.0.0
- [kue](https://npm.io/package/kue.md) ^0.11.6
- [flat](https://npm.io/package/flat.md) ^2.0.1
- [uuid](https://npm.io/package/uuid.md) ^3.1.0
- [async](https://npm.io/package/async.md) ^2.4.1
- [bytes](https://npm.io/package/bytes.md) ^2.5.0
- [chalk](https://npm.io/package/chalk.md) ^1.1.3
- [execa](https://npm.io/package/execa.md) ^0.6.3
- [getos](https://npm.io/package/getos.md) ^3.0.1
- [nodus](https://npm.io/package/nodus.md) ^0.5.2
- [ramda](https://npm.io/package/ramda.md) ^0.24.1
- [redis](https://npm.io/package/redis.md) ^2.7.1
- [yargs](https://npm.io/package/yargs.md) ^8.0.1
- [extend](https://npm.io/package/extend.md) ^3.0.1
- [influx](https://npm.io/package/influx.md) ^5.0.7
- [lodash](https://npm.io/package/lodash.md) ^4.17.4
- [exceljs](https://npm.io/package/exceljs.md) ^0.4.11
- [mongodb](https://npm.io/package/mongodb.md) ^2.2.29
- [request](https://npm.io/package/request.md) ^2.81.0
- [shelljs](https://npm.io/package/shelljs.md) ^0.7.8
- [bluebird](https://npm.io/package/bluebird.md) ^3.5.0
- [fs-extra](https://npm.io/package/fs-extra.md) ^3.0.1
- [gravatar](https://npm.io/package/gravatar.md) ^1.6.0
- [microtime](https://npm.io/package/microtime.md) ^2.1.6
- [handlebars](https://npm.io/package/handlebars.md) ^4.0.10
- [jsonwebtoken](https://npm.io/package/jsonwebtoken.md) ^7.4.1
- [nodus-framework](https://npm.io/package/nodus-framework.md) ^0.6.3
- [request-promise](https://npm.io/package/request-promise.md) ^4.2.1
- [event-loop-stats](https://npm.io/package/event-loop-stats.md) ^1.0.0
- [systeminformation](https://npm.io/package/systeminformation.md) ^3.18.0

## Recent versions

- 1.1.2 (latest) — 2017-08-05
- 1.1.1 — 2017-08-03
- 1.1.0 — 2017-07-30

## README

# NODUS Server Manager #

## Installation ##

- **STEP 1:** Install NodeJS
- **STEP 2:** Create '_nodus_' User Account
- **STEP 3:** Extract 'nodus-server-manager'
- **STEP 4:** Install Dependencies
- **STEP 5:** (TEST) Manually start the 'nsm-agent' collector
- **STEP 6:** Install 'nsm-agent' Service

### STEP 1: Install NodeJS ###

#### Red Hat® Enterprise Linux® / RHEL, CentOS and Fedora ####

**Supported Red Hat® Enterprise Linux® versions:**

- RHEL 5 (32-bit and 64-bit)
- RHEL 6 (32-bit and 64-bit)
- RHEL 7 (64-bit)

**Supported CentOS versions:***

- CentOS 5 (32-bit and 64-bit)
- CentOS 6 (32-bit and 64-bit)
- CentOS 7 (64-bit)


Node.js is available from the NodeSource Enterprise Linux and Fedora binary distributions repository. Support for this repository, along with its scripts, can be found on GitHub at nodesource/distributions.

Note that the Node.js packages for EL 5 (RHEL5 and CentOS 5) depend on the EPEL repository being available. The setup script will check and provide instructions if it is not installed.

**Run as root on RHEL, CentOS or Fedora:**

```
curl --silent --location https://rpm.nodesource.com/setup_7.x | bash -
```

**Install build tools, as root:**
```
yum -y install gcc-c++ make
```

**Then install, as root:**

```
yum -y install nodejs
```

**To check that node was installed successfully run:**
```
node --version
```

**NodeJS should print it's version information to the console:** 
```
v7.8.0
```

### STEP 2: Create '_nodus_' User Account ###

It is advised to create a separate service account for running the `agent` and `collector` services in the background.

Run the following commands, as root (_sudo_)

**Create a '_nodus_' user account:**
```
adduser nodus
```

**Use the `passwd` command to set the 'nodus' users password.**
```
passwd nodus
```

**Set and confirm the new user's password at the prompt. _A strong password is highly recommended!_**
```
Set password prompts:
Changing password for user username.
New password:
Retype new password:
passwd: all authentication tokens updated successfully.
```

### STEP 3: Extract 'nodus-server-manager' ###

Login as the 'nodus' user you just created.
```
su - nodus
```

Download the `nodus-server-manager` release package.
```
curl -lO http://147.75.66.217:8888/nodus-server-manager-0.1.0-0.tgz
```

Extract the `nodus-server-manager` release
```
tar -xvf nodus-server-manager-0.1.0-0.tgz
```

### STEP 4: Install Dependencies ###

There is an `install.sh` script located in the nodus-server-manager folder we just created that will install all 
the package dependencies.

**Change to the `nodus-server-manager` release directory, and run the `install.sh` script: **
```
cd nodus-server-manager
./install.sh
```

### STEP 5: (TEST) Manually start the 'nsm-agent' collector

To test that everything has been successfully installed, you can manually start the `nsm-agent` by running the following 
command from within the `nodus-server-manager` directory:
```
# Start `nsm-agent` process and collect stats every `10 seconds`
./start-agent.sh
```
_Press `CTRL+C` to EXIT_

The service should the following output: 
  
```
[nodus@nodus-centos nodus-server-manager]$ ./start-agent.sh
agent:commands:collect-stats:info Starting collector... 10000 +0ms
agent:commands:collect-stats:info Collecting stats... +10s
agent:commands:collect-stats:info Status sent successfully... +429ms
agent:commands:collect-stats:info Collecting stats... +10s
agent:commands:collect-stats:info Status sent successfully... +286ms
```

### STEP 5: Install the `nsm-agent` service (optional)

To run and start the `nsm-agent` automatically on reboot, using the standard linux `systemd` init system.

** Run the following, _as root_**
```
# Install 'nsm-agent.service' script
cp /home/nodus/nodus-server-manager/init-scripts/nsm-agent.service /etc/systemd/system

# Enable the service
systemctl enable nsm-agent.service

# Start the service
systemctl start nsm-agent.service
```

The `nsm-agent` service should now be installed and automatically collecting statistics.

- The service will start automatically on reboot

**To check the status of the service, run the following**
```
# Check the status of the service
systemctl status nsm-agent.service
```

You should see something similar to the following.  

**Note the `Active: active (running)`, which indicates the service is running and installed successfully**
```
[nodus@nodus-centos nodus-server-manager]$ sudo systemctl status nsm-agent.service
● nsm-agent.service - NODUS Server Manager Agent
   Loaded: loaded (/etc/systemd/system/nsm-agent.service; enabled; vendor preset: disabled)
   Active: active (running) since Fri 2017-05-26 03:43:42 UTC; 16s ago
     Docs: https://bitbucket.org/bradserbu/nodus-server-manager
 Main PID: 23096 (node)
   CGroup: /system.slice/nsm-agent.service
           └─23096 nsm-agent node_modules/.bin/nodus-run commands/collect-stats.js

May 26 03:43:42 nodus-centos systemd[1]: Started NODUS Server Manager Agent.
May 26 03:43:42 nodus-centos systemd[1]: Starting NODUS Server Manager Agent...
May 26 03:43:43 nodus-centos start-agent.sh[23096]: Fri, 26 May 2017 03:43:43 GMT agent:commands:collect-stats:info Starti...10000
May 26 03:43:53 nodus-centos start-agent.sh[23096]: Fri, 26 May 2017 03:43:53 GMT agent:commands:collect-stats:info Collec...ts...
May 26 03:43:54 nodus-centos start-agent.sh[23096]: Fri, 26 May 2017 03:43:54 GMT agent:commands:collect-stats:info Status...ly...
Hint: Some lines were ellipsized, use -l to show in full.
```

_(Optional)_ To view detailed system logs you can also use the following command: 

**Run the following command to view the `nsm-agent` logs**
```
journalctl -u nsm-agent.service
```

---
_Source: https://npm.io/package/nodus-server-manager · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._