Recent changes to compilando_macos

compilando_macos modified by Wagner Popov dos Santos

Wagner Popov dos Santos — Thu, 27 Dec 2018 01:02:10 -0000

--- v26
+++ v27
@@ -20,15 +20,10 @@

 **2.4.** Se o arquivo estiver compactado, descomprima ele com o comando gz:
 ~~~iex
-MeuMac:Downloads fabio$ gzip -d apcctrl-0.8.7.tar.gz
+MeuMac:Downloads fabio$ tar -xvvzf apcctrl-0.8.7.tar.gz
 ~~~

-**2.5.** Agora você tem um arquivo TAR. Você precisa extrair os arquivos que estão agrupados. Utilize o comando tar dessa forma:
-~~~iex
-MeuMac:Downloads fabio$ tar -xvvf apcctrl-0.8.7.tar
-~~~
-
-**2.6.** Os arquivos foram extraidos para a pasta apcctrl-0.8.7. Mude sua pasta atual para essa:
+**2.5.** Os arquivos foram extraidos para a pasta apcctrl-0.8.7. Mude sua pasta atual para essa:
 ~~~iex
 MeuMac:Downloads fabio$ cd apcctrl-0.8.7
 ~~~
@@ -40,9 +35,9 @@
 **3.1.** Crie a pasta sbin e rode o script configure:
 ~~~iex
 MeuMac:apcctrl-0.8.7 fabio$ mkdir -p /usr/local/sbin
-MeuMac:apcctrl-0.8.7 fabio$ ./configure --sbindir=/usr/local/sbin
+MeuMac:apcctrl-0.8.7 fabio$ ./configure --sbindir=/usr/local/sbin --disable-usb
 ~~~
-\*Caso você nunca tenha compilado um software no seu mac, ele solicitará o download das ferramentas de desenvolvimento para continuar. Pode ser necessário rodar o script configure novamente
+\*Você precisará do pacote XCode instalado! Caso você nunca tenha compilado um software no seu mac, ele solicitará o download das ferramentas de desenvolvimento para continuar. Pode ser necessário rodar o script configure novamente

 **3.2.** Faça a compilação com o comando make:
 ~~~iex

compilando_macos modified by Wagner Popov dos Santos

Wagner Popov dos Santos — Tue, 25 Sep 2018 12:13:55 -0000

--- v25
+++ v26
@@ -1,6 +1,6 @@
 ## \*\*\* Nova release / nova versão \*\*\*

-Foi corrigido um erro na versão para Mac. A porta não era iniciada adequadamente até a versão 0.8.4. A versão atual é a 0.8.7!
+Foi corrigido um erro na versão para Mac. A porta não era iniciada adequadamente até a versão 0.8.4. A versão atual é a 0.8.15!

 ## 1. Instalando no Mac OS X

compilando_macos modified by Wagner Popov dos Santos

Wagner Popov dos Santos — Mon, 24 Sep 2018 21:15:41 -0000

--- v24
+++ v25
@@ -9,7 +9,7 @@

 ## 2. Download do apcctrl e extração

-**2.1.** Para escrever esse documento foi utilizado o apcctrl-0.8.7.tar.gz. Faça o download na ** [seção files](http://sourceforge.net/projects/apcupsd-brazil/files/)**.
+**2.1.** Para escrever esse documento foi utilizado o apcctrl-0.8.7.tar.gz. Faça o download na ** [seção files](http://sourceforge.net/projects/apcctrl/files/)**.

 **2.2.** Abra um terminal clicando no seu Launchpad e procure por "terminal".

compilando_macos modified by Wagner Popov dos Santos

Wagner Popov dos Santos — Mon, 09 Jan 2017 13:31:39 -0000

--- v23
+++ v24
@@ -1,6 +1,6 @@
 ## \*\*\* Nova release / nova versão \*\*\*

-Foi corrigido um erro na versão para Mac. A porta não era iniciada adequadamente até a versão 0.8.5. A versão atual é a 0.8.7!
+Foi corrigido um erro na versão para Mac. A porta não era iniciada adequadamente até a versão 0.8.4. A versão atual é a 0.8.7!

 ## 1. Instalando no Mac OS X

compilando_macos modified by Wagner Popov dos Santos

Wagner Popov dos Santos — Mon, 09 Jan 2017 13:31:21 -0000

--- v22
+++ v23
@@ -1,6 +1,6 @@
 ## \*\*\* Nova release / nova versão \*\*\*

-Foi corrigido um erro na versão para Mac. A porta não era iniciada adequadamente. A versão atual é a 0.8.7!
+Foi corrigido um erro na versão para Mac. A porta não era iniciada adequadamente até a versão 0.8.5. A versão atual é a 0.8.7!

 ## 1. Instalando no Mac OS X

compilando_macos modified by Wagner Popov dos Santos

Wagner Popov dos Santos — Mon, 09 Jan 2017 13:30:31 -0000

--- v21
+++ v22
@@ -71,7 +71,7 @@

 Como o MacOSX fixa os devices pelo número serial, esse conversor do nobreak não possui esse campo corrigido e isso faz com que toda vez que o computador é reiniciado ou o cabo USB é removido e inserido novamente o nome do dispositivo pode mudar. Para contornar isso foi feita uma função apenas para MacOSX que procura o nome do dispotivivo mais similar com o configurado. ** Com isso, o nome do device confgurado no meu caso deve ser apenas /dev/cu.usbserial **

-#### 4.1. Alterando o arquivo apcctrl.conf
+##### 4.1. Alterando o arquivo apcctrl.conf

 Esse arquivo é que configura a aplicação. Utilize [esse arquivo apcctrl.conf](apcctrl.conf_macosx) como exemplo. Edite com o comando vim e sudo:
 ~~~iex
@@ -79,7 +79,7 @@
 ~~~
 \* Você pode utilizar outro editor diferente do vim.

-#### 4.2. Exemplo dos campos no arquivo de configuração
+##### 4.2. Exemplo dos campos no arquivo de configuração

 UPSCABLE simple
 UPSTYPE brazil

compilando_macos modified by Wagner Popov dos Santos

Wagner Popov dos Santos — Mon, 09 Jan 2017 13:29:16 -0000

--- v20
+++ v21
@@ -1,6 +1,6 @@
 ## \*\*\* Nova release / nova versão \*\*\*

-Foi corrigido um erro na versão para Mac. A porta não era iniciada adequadamente. A versão atual é a 0.8.5!
+Foi corrigido um erro na versão para Mac. A porta não era iniciada adequadamente. A versão atual é a 0.8.7!

 ## 1. Instalando no Mac OS X
@@ -9,7 +9,7 @@

 ## 2. Download do apcctrl e extração

-**2.1.** Para escrever esse documento foi utilizado o apcctrl-0.8.5.tar.gz. Faça o download na ** [seção files](http://sourceforge.net/projects/apcupsd-brazil/files/)**.
+**2.1.** Para escrever esse documento foi utilizado o apcctrl-0.8.7.tar.gz. Faça o download na ** [seção files](http://sourceforge.net/projects/apcupsd-brazil/files/)**.

 **2.2.** Abra um terminal clicando no seu Launchpad e procure por "terminal".

@@ -20,17 +20,17 @@

 **2.4.** Se o arquivo estiver compactado, descomprima ele com o comando gz:
 ~~~iex
-MeuMac:Downloads fabio$ gzip -d apcctrl-0.8.5.tar.gz
+MeuMac:Downloads fabio$ gzip -d apcctrl-0.8.7.tar.gz
 ~~~

 **2.5.** Agora você tem um arquivo TAR. Você precisa extrair os arquivos que estão agrupados. Utilize o comando tar dessa forma:
 ~~~iex
-MeuMac:Downloads fabio$ tar -xvvf apcctrl-0.8.5.tar
+MeuMac:Downloads fabio$ tar -xvvf apcctrl-0.8.7.tar
 ~~~

-**2.6.** Os arquivos foram extraidos para a pasta apcctrl-0.8.5. Mude sua pasta atual para essa:
+**2.6.** Os arquivos foram extraidos para a pasta apcctrl-0.8.7. Mude sua pasta atual para essa:
 ~~~iex
-MeuMac:Downloads fabio$ cd apcctrl-0.8.5
+MeuMac:Downloads fabio$ cd apcctrl-0.8.7
 ~~~

 ## 3. Compilando e instalando
@@ -39,53 +39,60 @@

 **3.1.** Crie a pasta sbin e rode o script configure:
 ~~~iex
-MeuMac:apcctrl-0.8.5 fabio$ mkdir -p /usr/local/sbin
-MeuMac:apcctrl-0.8.5 fabio$ ./configure --sbindir=/usr/local/sbin
+MeuMac:apcctrl-0.8.7 fabio$ mkdir -p /usr/local/sbin
+MeuMac:apcctrl-0.8.7 fabio$ ./configure --sbindir=/usr/local/sbin
 ~~~
 \*Caso você nunca tenha compilado um software no seu mac, ele solicitará o download das ferramentas de desenvolvimento para continuar. Pode ser necessário rodar o script configure novamente

 **3.2.** Faça a compilação com o comando make:
 ~~~iex
-MeuMac:apcctrl-0.8.5 fabio$ make
+MeuMac:apcctrl-0.8.7 fabio$ make
 ~~~

 **3.3.** Faça a instalação com o comando make install (com uso do sudo):
 ~~~iex
-MeuMac:apcctrl-0.8.5 fabio$ sudo make install
+MeuMac:apcctrl-0.8.7 fabio$ sudo make install
 ~~~

 **3.4.** Instalação do daemon. Esse passo é necessário para que o daemon seja iniciado sempre que o computador for ligado.
 ~~~iex
-MeuMac:apcctrl-0.8.5 fabio$ sudo launchctl load /Library/LaunchDaemons/org.apcctrl.apcctrl.plist
+MeuMac:apcctrl-0.8.7 fabio$ sudo launchctl load /Library/LaunchDaemons/org.apcctrl.apcctrl.plist
 ~~~

 ## 4. Configuração

 Seu nobreak possui um conversor usb-serial embutido dentro dele. Quando o ApcCtrl é iniciado ele precisa saber onde o seu MacOSX colocou o acesso a ele. Os dispositivos estão listados na pasta /dev. Utilize o comando ls com o grep abaixo para facilitar identificar ele:
 ~~~iex
-MeuMac:apcctrl-0.8.5 fabio$ ls -la /dev | grep usb
+MeuMac:apcctrl-0.8.7 fabio$ ls -la /dev | grep usb
 crw-rw-rw-  1 root   wheel      14,   3 Nov  3 09:03 cu.usbserial-9f3
 crw-rw-rw-  1 root   wheel      14,   2 Nov  3 09:00 tty.usbserial-9f3
 ~~~
 Um dispositivo usb-serial no Mac inicia com o nome cu. Então, no meu caso, o device que dá acesso ao meu nobreak é **/dev/cu.usbserial-9f3**

-**4.1.** Alterando o arquivo apcctrl.conf
+Como o MacOSX fixa os devices pelo número serial, esse conversor do nobreak não possui esse campo corrigido e isso faz com que toda vez que o computador é reiniciado ou o cabo USB é removido e inserido novamente o nome do dispositivo pode mudar. Para contornar isso foi feita uma função apenas para MacOSX que procura o nome do dispotivivo mais similar com o configurado. ** Com isso, o nome do device confgurado no meu caso deve ser apenas /dev/cu.usbserial **
+
+#### 4.1. Alterando o arquivo apcctrl.conf

 Esse arquivo é que configura a aplicação. Utilize [esse arquivo apcctrl.conf](apcctrl.conf_macosx) como exemplo. Edite com o comando vim e sudo:
 ~~~iex
-MeuMac:apcctrl-0.8.5 fabio$ sudo vim /etc/apcctrl/apcctrl.conf
+MeuMac:apcctrl-0.8.7 fabio$ sudo vim /etc/apcctrl/apcctrl.conf
 ~~~
 \* Você pode utilizar outro editor diferente do vim.

+#### 4.2. Exemplo dos campos no arquivo de configuração
+
+UPSCABLE simple
+UPSTYPE brazil
+DEVICE /dev/cu.usbserial

 ## 5. Testando

 A aplicação apctest deve ser utilizada para testar seu nobreak. Caso você tenha algum problema ao iniciar o apctest você pode tentar mudar o path atual (cd ~) ou rodar como root com o camando sudo.

 ~~~iex
-MeuMac:apcctrl-0.8.5 fabio$ sudo /usr/local/sbin/apctest -d 100
+MeuMac:apcctrl-0.8.7 fabio$ sudo /usr/local/sbin/apctest -d 100

-2016-11-03 11:34:22 apctest 0.8.5 (27 September 2016) darwin
+2016-11-03 11:34:22 apctest 0.8.7 (27 September 2016) darwin
 Checking configuration ...
 sharenet.type = Network & ShareUPS Disabled
 cable.type = Custom Cable Simple
@@ -116,8 +123,8 @@

 Aparentemente é comum encontrar relatos de pessoas que ficaram com a porta usb-serial no Mac OS como bloqueada (locked, em uso). Uma sugestão é criar a pasta e mudar as permissões dela da seguinte forma:
 ~~~iex
-MeuMac:apcctrl-0.8.5 fabio$ sudo mkdir /var/lock
-MeuMac:apcctrl-0.8.5 fabio$ sudo chmod 777 /var/lock
+MeuMac:apcctrl-0.8.7 fabio$ sudo mkdir /var/lock
+MeuMac:apcctrl-0.8.7 fabio$ sudo chmod 777 /var/lock
 ~~~
 Não é uma solução elegante, especialmente para um servidor, aguardo sugestões!

@@ -128,13 +135,13 @@
 Para iniciar ou encerrar o daemon que efetivamente controla o nobreak você deve utilizar o launchctl com o uso do sudo. Para que isso funcione você precisa ter executado a etapa **3.4**.

 ~~~iex
-MeuMac:apcctrl-0.8.5 fabio$ sudo launchctl stop org.apcctrl.apcctrl
-MeuMac:apcctrl-0.8.5 fabio$ sudo launchctl start org.apcctrl.apcctrl
+MeuMac:apcctrl-0.8.7 fabio$ sudo launchctl stop org.apcctrl.apcctrl
+MeuMac:apcctrl-0.8.7 fabio$ sudo launchctl start org.apcctrl.apcctrl
 ~~~

 Para verificar se a aplicação foi carregada pelo launcctl na etapa **3.4** você pode utlizar o comando:
 ~~~iex
-MeuMac:apcctrl-0.8.5 fabio$ sudo launchctl list | grep apc
+MeuMac:apcctrl-0.8.7 fabio$ sudo launchctl list | grep apc
 51      126     org.apcctrl.apcctrl
 414     0       com.apcctrl.apcagent.4832
 ~~~
@@ -142,11 +149,11 @@

 Você também pode utilizar a aplicação apcaccess para verificar o estado do daemon.
 ~~~iex
-MeuMac:apcctrl-0.8.5 fabio$ /usr/local/sbin/apcaccess 
+MeuMac:apcctrl-0.8.7 fabio$ /usr/local/sbin/apcaccess 
 APC      : 001,034,0858
 DATE     : 2017-01-06 11:11:03 -0800  
 HOSTNAME : Fabios-iMac.local
-VERSION  : 0.8.5 (16 December 2016) darwin
+VERSION  : 0.8.7 (16 December 2016) darwin
 UPSNAME  : UpsNome
 CABLE    : Custom Cable Simple
 DRIVER   : BRAZIL UPS Driver

compilando_macos modified by Wagner Popov dos Santos

Wagner Popov dos Santos — Mon, 09 Jan 2017 13:13:11 -0000

--- v19
+++ v20
@@ -20,7 +20,7 @@

 **2.4.** Se o arquivo estiver compactado, descomprima ele com o comando gz:
 ~~~iex
-MeuMac:Downloads fabio$ gz -d apcctrl-0.8.5.tar.gz
+MeuMac:Downloads fabio$ gzip -d apcctrl-0.8.5.tar.gz
 ~~~

 **2.5.** Agora você tem um arquivo TAR. Você precisa extrair os arquivos que estão agrupados. Utilize o comando tar dessa forma:

compilando_macos modified by Wagner Popov dos Santos

Wagner Popov dos Santos — Fri, 06 Jan 2017 20:45:26 -0000

--- v18
+++ v19
@@ -138,7 +138,7 @@
 51      126     org.apcctrl.apcctrl
 414     0       com.apcctrl.apcagent.4832
 ~~~
-Nesse exemplo, o número 51 indica o PID da aplicação servidora. indicando que o serviço está rodando. Se ao contrário de um número você tiver um hífen, significa que a aplicação servidora não está funcionando.
+Nesse exemplo, o número 51 indica o PID da aplicação servidora. indicando que o serviço está rodando. Se ao contrário de um número você tiver um hífen, significa que a aplicação servidora não está em execução.

 Você também pode utilizar a aplicação apcaccess para verificar o estado do daemon.
 ~~~iex

compilando_macos modified by Wagner Popov dos Santos

Wagner Popov dos Santos — Fri, 06 Jan 2017 20:43:12 -0000

--- v17
+++ v18
@@ -112,7 +112,16 @@
 Select function number: 
 ~~~

-## 6. Iniciando a aplicação
+## 6. Evitando que a porta usb-serial fique bloqueada
+
+Aparentemente é comum encontrar relatos de pessoas que ficaram com a porta usb-serial no Mac OS como bloqueada (locked, em uso). Uma sugestão é criar a pasta e mudar as permissões dela da seguinte forma:
+~~~iex
+MeuMac:apcctrl-0.8.5 fabio$ sudo mkdir /var/lock
+MeuMac:apcctrl-0.8.5 fabio$ sudo chmod 777 /var/lock
+~~~
+Não é uma solução elegante, especialmente para um servidor, aguardo sugestões!
+
+## 7. Iniciando a aplicação

 Para monitorar o apcctrl no ambiente gráfico você deve utilizar o apcagent. Para isso, abra o seu launchpad e procure por apcagent.