invis-setup

### invis Server Setup for "GreenLeaf Organic Farms"

**Business Profile:** GreenLeaf Organic Farms is a 15-employee organic produce distributor in Portland, Oregon. They need a server to manage inventory, invoicing, and networked office equipment.

**Server Configuration:**
- **Hardware:** HP ProLiant MicroServer Gen10 Plus (4-core AMD CPU, 16GB RAM, 1TB SSD + 2TB HDD for storage)
- **OS:** openSUSE Leap 15.5 (invis pre-installed)
- **Services Enabled:**
  - DHCP for automatic IP assignment to 8 workstations and 2 warehouse scanners
  - Samba for file sharing (shared folders: `Inventory`, `Invoices`, `HR_Docs`)
  - Nextcloud for basic ERP (inventory tracking, invoicing, and employee document management)
  - CUPS for printer sharing (2 HP LaserJet Pro MFP M426fdw units)
  - Firewall rules pre-configured for small business use

**Network Setup:**
1. **IP Range:** 192.168.1.0/24 (assigned via DHCP)
2. **Printers:** Both printers mapped to `\\192.168.1.100\Printer1` and `\\192.168.1.100\Printer2`
3. **Workstations:** All Windows 11 PCs auto-joined to domain `GREENLEAF.LOCAL`
4. **Mobile Devices:** 3 iPads and 2 Android tablets connected via Wi-Fi (SSID: `GreenLeaf_Guest` for visitors)

**Admin Guide for "Sarah" (Office Manager):**

**Step 1: Power Up and Initial Login**
- Plug in the server and wait 5 minutes for it to boot.
- On Sarah’s PC, open a browser and navigate to `http://invis-server.local:8080` (default admin interface).
- Log in with username `admin` and password `TempPass123!` (change this immediately in *System > Users*).

**Step 2: Configure DHCP and Network**
- Go to *Network > DHCP Server* and verify the range `192.168.1.100-200`.
- Under *Network > Interfaces*, ensure the server’s IP is `192.168.1.100` (static assignment).
- **Tip:** If a device isn’t getting an IP, restart its network adapter or check for duplicate IPs using `arp -a` in Command Prompt.

**Step 3: Set Up File Sharing (Samba)**
- Navigate to *Services > Samba* and enable the service.
- Create shared folders:
  - `Inventory` (read/write for all employees)
  - `Invoices` (read-only for sales team, read/write for accounting)
  - `HR_Docs` (read/write for HR only)
- **Tip:** Use the *Permissions* tab to restrict access. For example, grant `Sales` group read/write to `Invoices` but deny `Warehouse` group.

**Step 4: Deploy Nextcloud (ERP Lite)**
- Go to *Services > Nextcloud* and click *Install*.
- After installation, access `http://invis-server.local/nextcloud` and log in with `admin`/`TempPass123!`.
- **Configure ERP Modules:**
  - **Inventory:** Upload a CSV of current stock (columns: `ItemID`, `Name`, `Quantity`, `Price`).
  - **Invoicing:** Set up templates for organic produce sales (e.g., "Weekly Order #123").
  - **Users:** Add employees via *Users > Add User* (e.g., `[email protected]`, `[email protected]`).
- **Tip:** Enable *Two-Factor Authentication* in *Security Settings* to protect sensitive data.

**Step 5: Connect Printers**
- Go to *Services > CUPS* and click *Add Printer*.
- Select the printer model (HP LaserJet Pro M426fdw) and assign it to the default queue.
- Share the printer via Samba: In *Samba > Shares*, add a share named `Printer1` with path `/var/spool/cups` and set permissions to `write list = @sales`.
- **Tip:** If a printer isn’t printing, check the queue in *CUPS > Jobs* or restart the CUPS service via terminal (`sudo systemctl restart cups`).

**Step 6: Test and Troubleshoot**
- **Test File Access:** From a workstation, open `\\192.168.1.100\Inventory` and create a test file.
- **Test ERP:** Log into Nextcloud from Sarah’s PC and verify inventory updates.
- **Common Issues:**
  - **Printer not found:** Ensure the printer is on the same network and has a static IP (e.g., `192.168.1.50`).
  - **Slow file access:** Check disk usage in *System > Storage* and clear temporary files.
  - **Nextcloud login errors:** Reset the admin password via terminal (`sudo -u wwwrun php occ user:resetpassword admin`).

**Next Steps:**
- Schedule a weekly backup of the server (use *System > Backup* to export to an external drive).
- Train employees on basic tasks like checking inventory in Nextcloud or printing via the shared queue.

**Final Note:** The invis server is now fully operational! Sarah can manage the system without IT expertise, and GreenLeaf Organic Farms has a scalable foundation for future growth.