Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
commands:nems-init [2019/05/05 10:58]
Robbie Ferguson
commands:nems-init [2019/09/21 13:59] (current)
Robbie Ferguson
Line 1: Line 1:
 =====NEMS Linux Commands: nems-init===== =====NEMS Linux Commands: nems-init=====
  
-In order to begin using your NEMS Linux server, you must first initialize it. The //​nems-init//​ process makes initialization quick and easy by automating many of the first-boot tasks for you.+**Welcome ​to NEMS Linux!**
  
-To initialize NEMS Linux, simply [[usage:​connect_to_nems_ssh|connect to your NEMS Linux server over SSH]] or via a connected keyboard/​monitor (if SSH is not available) ​and type:+In order to begin using your new NEMS Server, you must first initialize it. The //​nems-init//​ process makes initialization quick and easy by automating many of the first-boot tasks for you. After initialization,​ you'll be left with a fully-operational NEMS Server, complete with a small selection of sample check commands. 
 + 
 +**Please Note:** 
 + 
 +If any of the included sample check commands report error, perhaps they need adjusting or removal in NEMS NConf. Here are a couple quick examples: 
 + 
 +  - If the particular platform of your NEMS Server doesn'​t have a thermal sensor, you'll see an error when the thermal check runs, so you can remove that check and re-generate your Nagios config since it doesn'​t apply to you. 
 +  - If you have slow Internet, you'll see an alert when the default thresholds are met, so you can adjust the thresholds to numbers that are more appropriate for your configuration and re-generate your Nagios config. 
 + 
 +**Let'​s Begin:** 
 + 
 +To initialize NEMS Linux, simply [[usage:​connect_to_nems_ssh|connect to your NEMS Linux server over SSH]] or use the in-browser terminal feature of [[features:​cockpit|Cockpit]] on supported platforms ​and type:
  
 <code bash>​sudo nems-init</​code>​ <code bash>​sudo nems-init</​code>​
 +
 +On Docker, the method is instead to run the following command on your Docker host:
 +
 +<code bash>​sudo docker exec -it nems nems-init</​code>​
  
 ====Important Note==== ====Important Note====
  
-I recommend ​you perform your //​nems-init//​ operation over SSH. This is because if you use a keyboard connected directly ​to your NEMS server, you will potentially be working with a different keymap than your local system, which could cause you issues in future.+If you are trying ​to initialize ​NEMS via a connected keyboard and TVplease note that you will potentially be working with a different keymap than your local system, which could cause you issues in future. It is recommended to use the supported solutions listed above. In the case of a Raspberry Pi Zero (or other device where Ethernet is not included on-board) you can use an OTG or other supported Ethernet adapter to be able to initialize over the network. Keyboard / TV support is available for the extreme case where it is the only option, but it is not the recommended method, nor officially supported.
  
 ====What nems-init Does==== ====What nems-init Does====
Line 15: Line 30:
 //​nems-init//​ automates and simplifies the following operations: //​nems-init//​ automates and simplifies the following operations:
  
-  - **Removes ​the default Linux user and randomizes its password.** You should never have a production server using the default username:​password since there are many malware scripts that seek out and destroy such devices. +  - **Randomizes the password of the default Linux user and removes that user.** You should never have a production server using the default username:​password since there are many malware scripts that seek out and destroy such devices. 
-  - **Creates your NEMS user.** This is the username and password you will use to access web-based systems such as NConf, Nagios Core, and your NEMS-Migrator backups (over https or samba), as well as when you login to the NEMS server over SSH or local console. Make sure you select a strong password as this user will have SSH and super user access. This is also the user you will use to access network shares located on your NEMS Linux server. +  - **Creates your NEMS Linux admin user.** This is the username and password you will use to access web-based systems such as NConf, Nagios Core, and your NEMS-Migrator backups (over https or samba), as well as when you login to the NEMS server over SSH. Make sure you select a strong password as this user will have SSH and super user access. This is also the user you will use to access network shares located on your NEMS Linux server. 
-  - **Configures your timezone.** NEMS Linux uses NTP to automatically update your NEMS server's date and time based on your configured timezone.+  - **Configures your timezone.** NEMS Linux uses NTP to automatically update your NEMS Server's date and time based on your configured timezone.
   - **Configures your keyboard locale/​language.**   - **Configures your keyboard locale/​language.**
-  - **Generates and installs your self-signed SSL certificates.**+  - **Generates and installs your self-signed SSL certificates.** ​Every NEMS Server has its own custom self-signed SSL certificate.
  
 +Once NEMS Linux is initialized,​ you can access its interface through your web browser. The //​nems-init//​ process is the only time you should need to access the NEMS Linux terminal.
  • commands/nems-init.1557068323.txt.gz
  • Last modified: 2019/05/05 10:58
  • by Robbie Ferguson