Índice

Objetivo

Este guia mostra como aumentar o limite máximo de upload no TOTVS Fluig Plataforma.

Como aumentar o limite de upload da plataforma

Para aumentar o limite de upload, siga os passos abaixo:

A realização deste procedimento pode causar problemas de performance na plataforma. Recomendamos que seja realizado em ambiente de homologação antes de configurar em produção.

Pare os serviços do fluig.

Localize o arquivo domain.xml, que está disponível em [diretório_instalação]/appserver/domain/configuration, e abra em um editor de texto utilizando um usuário com permissões de administrador.

Procure pela tag http-listener e o seu atributo max-post-size. Altere o valor para "2147483648" para permitir até 2GB de upload.

            <subsystem xmlns="urn:jboss:domain:undertow:3.1">
                <buffer-cache name="default"/>
                <server name="default-server">
                    <http-listener name="default" socket-binding="http" max-post-size="1073741824"/>

Se você possuir HTTPS na plataforma, precisará editar o valor também do parâmetro https-listener max-post-size. Se você não tiver HTTPS na plataforma, só existirá o primeiro parâmetro.

<http-listener max-post-size="2147483648" name="default" proxy-address-forwarding="true" socket-binding="http"/>
<https-listener max-post-size="2147483648" name="https" secure="true" security-realm="TOTVSTech" socket-binding="https"/>

Salve e inicie os serviços do fluig na ordem correta.

Tente publicar o arquivo em seguida.

Ao alterar o limite padrão de upload na configuração do serviço fluig acima do valor padrão, a performance para todos os usuários da plataforma poderá ser afetada durante o upload de arquivos com tamanho superior ao limite padrão.

Escolhendo o valor correto

Unidade de medida

Uma boa prática para determinar o novo valor da propriedade max-post-size em bytes, é utilizar um a potência de base 2 (Ex.: 2¹⁰, 2²⁰, 2³⁰, ...), conforme norma IEC 80000-13 : 2008. Isto se deve ao fato de que todos os dispositivos de armazenamento são projetados para guardar um volume de dados, sendo este um número múltiplo de dois, justamente por causa da natureza binária do bit, embora comercialmente seja utilizado o sistema internacional (Ex.: 10¹, 10², 10³, ...).

Segue abaixo alguns exemplos de valores baseados nesta lógica:

Tabela 1 - Valores de armazenamento conforme norma IEC 80000-13 : 2008
Potência de base 2	gibibyte (GiB)	mebibyte (MiB)	quibibyte (KiB)	Bytes	bits
2⁰	0	0	0	0	1
2¹	0	0	0	0	2
2³	0	0	0	1	8
2¹⁰	0	0	1	1024	8192
2²⁰	0	0	1024	1048576	8388608
2³⁰	1	1024	1048576	1073741824	8589934592
2³¹	2	2048	*2097152*	*2147483648*	*17179869184*

Tabela 2 - Múltiplos do Byte

<table class="infobox" style="padding: 0; text-align: left; width: 0">
    <tbody>
        <tr>
            <th colspan="3" style="background-color:#ddf; text-align: center;"><a href="https://pt.wikipedia.org/wiki/Prefixo_bin%C3%A1rio"
                    title="Prefixo binário">Prefixo binário</a> (<a
                    href="https://pt.wikipedia.org/wiki/Comiss%C3%A3o_Eletrot%C3%A9cnica_Internacional"
                    title="Comissão Eletrotécnica Internacional">IEC</a>)
            </th>
            <th>
            </th>
            <th colspan="3" style="background-color:#ddf; text-align: center;"><a
                    href="https://pt.wikipedia.org/wiki/Sistema_Internacional_de_Unidades" title="Sistema Internacional de Unidades">Prefixo do
                    SI</a>
            </th>
        </tr>
        <tr>
            <th>Nome
            </th>
            <th>Símbolo
            </th>
            <th>Múltiplo
            </th>
            <th>
            </th>
            <th>Nome
            </th>
            <th>Símbolo
            </th>
            <th>Múltiplo
            </th>
        </tr>
        <tr>
            <td style="text-align:left;"><a href="https://pt.wikipedia.org/wiki/Byte" title="Byte">byte</a>
            </td>
            <td>B
            </td>
            <td>2<sup>0</sup>
            </td>
            <td>
            </td>
            <td style="text-align:left;"><a href="https://pt.wikipedia.org/wiki/Byte" title="Byte">byte</a>
            </td>
            <td>B
            </td>
            <td>10<sup>0</sup>
            </td>
        </tr>
        <tr>
            <td style="text-align:left;"><a href="https://pt.wikipedia.org/wiki/Kibibyte" class="mw-redirect" title="Kibibyte">kibibyte</a>
            </td>
            <td>KiB
            </td>
            <td>2<sup>10</sup>
            </td>
            <td>
            </td>
            <td style="text-align:left;"><a href="https://pt.wikipedia.org/wiki/Kilobyte" title="Kilobyte">kilobyte</a>
            </td>
            <td>kB
            </td>
            <td>10<sup>3</sup>
            </td>
        </tr>
        <tr>
            <td style="text-align:left;"><a href="https://pt.wikipedia.org/wiki/MebiByte" title="MebiByte">mebibyte</a>
            </td>
            <td>MiB
            </td>
            <td>2<sup>20</sup>
            </td>
            <td>
            </td>
            <td style="text-align:left;"><a href="https://pt.wikipedia.org/wiki/Megabyte" title="Megabyte">megabyte</a>
            </td>
            <td>MB
            </td>
            <td>10<sup>6</sup>
            </td>
        </tr>
        <tr>
            <td style="text-align:left;"><a href="https://pt.wikipedia.org/wiki/Gibibyte" title="Gibibyte">gibibyte</a>
            </td>
            <td>GiB
            </td>
            <td>2<sup>30</sup>
            </td>
            <td>
            </td>
            <td style="text-align:left;"><a href="https://pt.wikipedia.org/wiki/Gigabyte" title="Gigabyte">gigabyte</a>
            </td>
            <td>GB
            </td>
            <td>10<sup>9</sup>
            </td>
        </tr>
        <tr>
            <td style="text-align:left;"><a href="https://pt.wikipedia.org/wiki/Tebibyte" title="Tebibyte">tebibyte</a>
            </td>
            <td>TiB
            </td>
            <td>2<sup>40</sup>
            </td>
            <td>
            </td>
            <td style="text-align:left;"><a href="https://pt.wikipedia.org/wiki/Terabyte" title="Terabyte">terabyte</a>
            </td>
            <td>TB
            </td>
            <td>10<sup>12</sup>
            </td>
        </tr>
        <tr>
            <td style="text-align:left;"><a href="https://pt.wikipedia.org/wiki/Pebibyte" title="Pebibyte">pebibyte</a>
            </td>
            <td>PiB
            </td>
            <td>2<sup>50</sup>
            </td>
            <td>
            </td>
            <td style="text-align:left;"><a href="https://pt.wikipedia.org/wiki/Petabyte" title="Petabyte">petabyte</a>
            </td>
            <td>PB
            </td>
            <td>10<sup>15</sup>
            </td>
        </tr>
        <tr>
            <td style="text-align:left;"><a href="https://pt.wikipedia.org/wiki/Exbibyte" title="Exbibyte">exbibyte</a>
            </td>
            <td>EiB
            </td>
            <td>2<sup>60</sup>
            </td>
            <td>
            </td>
            <td style="text-align:left;"><a href="https://pt.wikipedia.org/wiki/Exabyte" title="Exabyte">exabyte</a>
            </td>
            <td>EB
            </td>
            <td>10<sup>18</sup>
            </td>
        </tr>
        <tr>
            <td style="text-align:left;"><a href="https://pt.wikipedia.org/wiki/Zebibyte" title="Zebibyte">zebibyte</a>
            </td>
            <td>ZiB
            </td>
            <td>2<sup>70</sup>
            </td>
            <td>
            </td>
            <td style="text-align:left;"><a href="https://pt.wikipedia.org/wiki/Zettabyte" title="Zettabyte">zettabyte</a>
            </td>
            <td>ZB
            </td>
            <td>10<sup>21</sup>
            </td>
        </tr>
        <tr>
            <td style="text-align:left;"><a href="https://pt.wikipedia.org/wiki/Yobibyte" title="Yobibyte">yobibyte</a>
            </td>
            <td>YiB
            </td>
            <td>2<sup>80</sup>
            </td>
            <td>
            </td>
            <td style="text-align:left;"><a href="https://pt.wikipedia.org/wiki/Yottabyte" title="Yottabyte">yottabyte</a>
            </td>
            <td>YB
            </td>
            <td>10<sup>24</sup>
            </td>
            <td>
            </td>
        </tr>
    </tbody>
</table>

Fórmula

Sabendo que o valor padrão de um 1 GigaBytes é 1073741824 bytes, então pode-se utilizar este valor como constante para multiplicarmos a capacidade.

A fórmula abaixo permite o cálculo rápido e simples do novo valor para o limite de upload desejado para o ambiente da plataforma.

Vbytes = vGB * 1073741824

Onde:

Vbytes → o novo valor a ser definido no arquivo de configuração domain.xml, no campo max-post-size.

vGB → valor em GigaBytes ao qual pretende-se aumentar a capacidade de upload do ambiente.

1073741824 → valor de 1GB em bytes, utilizado como constante ou referência.

Exemplos

Preciso aumentar de 1GB para 2GB a capacidade de upload;

Vbytes = 2 * 1073741824

Vbytes = 2147483648

logo max-post-size="2147483648"

Preciso aumentar de 1GB para 5GB a capacidade de upload;

Vbytes = 5 * 1073741824

Vbytes = 5368709120

logo max-post-size="5368709120"

Esta documentação é válida a partir da atualização 1.6.5 - Liquid. Se você utiliza uma atualização anterior, ela pode conter informações diferentes das quais você vê na sua plataforma.