Guida per il pacchetto DMG e ZIP · versione 1.5.0.
Versione Mac in collaudo. I test sono stati eseguiti in un ambiente Windows con i servizi macOS simulati. Installazione, Portachiavi e avvio automatico devono ancora essere provati su un Mac reale. L’app non è firmata o notarizzata Apple.
1. Prima di iniziare
Mac con macOS 14 o successivo, Apple Silicon o Intel; la compatibilità effettiva deve essere verificata sul tuo Mac.
Connessione Internet per installare le dipendenze e collegamento alla rete delle stampanti.
Credenziali del gestionale e IP/host delle stampanti. Se manca Python, può servire una password amministratore del Mac per installare il runtime.
2. Installa dal DMG
Nel portale scegli Scarica Agent OHSP → Scarica DMG per Mac. Attendi il completamento del download.
Apri Agent_OHSPrint_macOS.dmg da Download. Nel volume che appare nel Finder entra nella cartella Agent_OHSPrint_macOS.
Fai doppio clic su Installa Agent OHSPrint.app, con il logo OHS. Si apre il Terminale con l’installazione guidata. In alternativa apri Installa_Agent_OHSPrint.command nella stessa cartella. Non trascinare l’installer in Applicazioni.
Leggi la destinazione proposta: ~/Applications/OHSPrint_monito, nella cartella del tuo utente. Digita s e premi Invio per confermare; premi solo Invio per annullare.
Attendi il download e l’installazione del runtime Python e delle librerie, se necessari. Se richiesto, inserisci nel Terminale la password amministratore del Mac e premi Invio: durante la digitazione non appaiono caratteri. Non è la password del gestionale o della stampante.
Al termine si aprono questa guida e l’interfaccia dell’agente nel browser. Quando il Terminale mostra Installazione conclusa, premi Invio per chiuderlo.
Se usi lo ZIP, estrai tutta la cartella e apri l’app di installazione al suo interno. Mantieni insieme tutti i file fino alla fine dell’installazione.
3. Se macOS blocca l’apertura
Dopo un tentativo di apertura, se ti fidi del pacchetto scaricato dal portale aziendale, apri menu Apple → Impostazioni di Sistema → Privacy e sicurezza. Cerca il messaggio relativo all’installer e, se disponibile, scegli Apri comunque, poi conferma. L’opzione può dipendere dalle regole del Mac aziendale. Istruzioni ufficiali Apple.
Non disattivare le protezioni globali del Mac. Se compare un avviso di software dannoso o non puoi autorizzare l’apertura, interrompi l’installazione e contatta l’amministratore.
4. Prima configurazione
Verifica l’indirizzo del gestionale: attualmente https://www.ohssrl.it/gestione_stampe/. Il Mac deve poterlo raggiungere tramite Internet.
Inserisci utente e password del portale, poi premi Accedi e carica anagrafiche.
Seleziona Cliente e Sede e conferma l’associazione.
Premi Aggiungi stampante e inserisci un IP/host, oppure usa Scansione rete Sharp indicando la rete corretta, per esempio 192.168.1.0/24. Attendi che la barra verde termini.
Seleziona i dispositivi da monitorare e verifica utente, password e comunità SNMP. Conferma la password di ogni stampante: il valore iniziale è admin, da sostituire se diverso. Se macOS chiede il permesso per la rete locale a Python/OHSPrint, consenti per permettere le letture.
Premi Leggi selezionate e controlla modello, matricola, contatori, toner ed errori.
Premi Aggiorna dati ora e invia. Il messaggio inserimento avvenuto con successo compare quando il portale conferma la registrazione. Controlla le macchine associate al cliente nel gestionale.
Spunta Sincronizzazione automatica giornaliera e premi Salva configurazione. Usa Verifica installazione per controllare portale, dispositivi selezionati e avvio automatico.
5. Avvio automatico e uso quotidiano
Per riaprire l’agente: Finder → Vai → Vai alla cartella, scrivi ~/Applications e apri Agent OHSPrint.app.
L’agente parte dopo l’accesso dello stesso utente a macOS e continua dopo aver premuto Chiudi interfaccia. Il monitoraggio si ferma a logout, spegnimento o sospensione. Non opera prima dell’accesso dell’utente.
Se una lettura giornaliera è dovuta, viene recuperata quando l’agente riparte. Se il portale è offline, le letture restano cifrate sul Mac e l’invio viene ritentato.
Aggiorna dati ora e invia forza una lettura anche quando l’automatico è in pausa. Il gestionale può interrogare i dispositivi mentre il processo automatico è attivo.
Usa Stampa / PDF dopo una lettura per il riepilogo di contatori, consumabili e ultimi errori. I valori disponibili dipendono dalla stampante.
Dopo l’installazione puoi espellere il volume del DMG nel Finder: il programma è stato copiato nella cartella utente.
6. Risoluzione dei problemi
Portale non raggiungibile: prova ad aprire l’indirizzo in Safari; verifica rete/VPN e server acceso.
Nessuna stampante trovata: controlla IP, rete di scansione, stampante accesa, permessi rete locale, credenziali e SNMP. Prova l’aggiunta diretta di un IP.
Letture conservate sul PC: l’invio non è ancora confermato. Ripristina la connessione e attendi il nuovo esito; non cancellare i dati dell’agente.
Avvio automatico non attivo: premi Attiva avvio automatico e poi Verifica installazione; controlla eventuali autorizzazioni per le attività in background.
Installazione interrotta: conserva l’errore del Terminale, controlla Internet e spazio disponibile e risolvi la causa prima di riprovare.
I log operativi sono in ~/Applications/OHSPrint_monito/LOGS. Configurazione e letture in attesa sono in ~/Library/Application Support/OHSPrintAgent; la chiave di cifratura è nel Portachiavi dell’utente.
7. Disinstallazione
Premi Chiudi interfaccia, apri ~/Applications/OHSPrint_monito e avvia Disinstalla_Agent_OHSPrint.command. Scrivi SI per rimuovere programma e avvio automatico. Al passaggio successivo premi Invio per conservare i dati, oppure scrivi ELIMINA per cancellare anche configurazione, credenziali, letture in attesa e log.