Troubleshooting

Troubleshooting
Versão 1.0
As informações contidas neste documento estão sujeitas a alteração sem notificação
prévia. Os dados utilizados nos exemplos contidos neste manual são fictícios. Nenhuma
parte deste documento pode ser reproduzida ou distribuída em qualquer forma ou através
de quaisquer mídias, eletrônicas ou impressas, para quaisquer finalidades, sem a
autorização por escrito da SoftExpert Informática e Automação Ltda.
SOFTEXPERT e ISOSYSTEM são marcas registradas da SoftExpert Informática e
Automação Ltda.
Outros nomes de produtos citados neste manual são marcas registradas de suas
respectivas empresas.
Sumário
Capítulo 1 - Bem-Vindo!
..............................................................................................................5
Capítulo 2 - Como ..............................................................................................................7
Utilizar este Documento
Capítulo 3 - Lista de
..............................................................................................................9
Problemas
Executável
......................................................................................................................
incompatível
10
Access denied
...................................................................................................................... 11
Página em
......................................................................................................................
branco
12
No such ......................................................................................................................
file ou directory
15
Você não......................................................................................................................
está autorizado a ver esta página
16
Database......................................................................................................................
Error
17
Configuration
......................................................................................................................
not saved
Não é possível
......................................................................................................................
localizar a página
Página carregando
......................................................................................................................
sem erros
Report generate
......................................................................................................................
error
20
21
22
23
Server not
......................................................................................................................
Found
26
Erro ao iniciar
......................................................................................................................
o ISOSYSTEM - Server
27
Erro no Conversor
......................................................................................................................
PDF
28
Caracteres
......................................................................................................................
00 ao acessar os módulos
29
Capítulo 4 - Dúvidas
..............................................................................................................31
SoftExpert Software for Excellence
Bem-Vindo!
Capítulo
I
Bem-Vindo!
1
5
Bem-Vindo!
O Troubleshooting ISOSYSTEM é uma forma de solucionar os problemas mais comuns
encontrados durante a instalação, atualização e utilização dos módulos ISOSYSTEM
adquiridos pela organização. Desta forma, este documento lista uma série de problemas,
sejam eles de ambiente ou produto, e tenta resolvê-los por intermédio de medidas
convencionais (procedimentos lógicos).
O Troubleshooting ISOSYSTEM considera que você tenha experiência
em sistemas operacionais Microsoft Windows Server, bem como
experiência com bancos de dados relacionais. Também é necessário
conhecimento sobre configuração e administração de redes TCP/IP.
SoftExpert Software for Excellence
Como Utilizar este Documento
Capítulo
II
Como Utilizar este Documento
2
7
Como Utilizar este Documento
Os capítulos deste documento são formados pelos problemas envolvidos na instalação,
atualização e utilização dos módulos ISOSYSTEM. A lista de problemas disponíveis será
apresentada no próximo capítulo. Para facilitar na consulta, pressione as teclas CTRL+F
do teclado, e faça a busca pela mensagem de erro ou palavra-chave.
No decorrer do documento, serão encontradas diferentes estratégias para chamar a
atenção do usuário para informações importantes. As imagens que indicam estas
informações serão apresentadas a seguir:
Ícone
Nome
Descrição
Dica
Exibe dicas importantes que auxiliam na detecção/solução do
problema.
Atenção
Alerta que determina funcionalidade ou ação, quando não
executada corretamente, pode prejudicar alguma etapa da
detecção/solução do problema.
SoftExpert Software for Excellence
Lista de Problemas
Capítulo
III
Lista de Problemas
3
9
Lista de Problemas
Nesta seção são enumerados alguns dos possíveis problemas envolvidos na instalação,
atualização e utilização dos módulos ISOSYSTEM. Utilize os links abaixo para visualizar
os detalhes e possíveis soluções de cada problema.
Para facilitar na consulta dos problemas, pressione as teclas CTRL+F do
teclado, e faça a busca pela mensagem de erro ou palavra-chave.
Lista de Problemas:
Ú Problema 1
Seu executável não é compatível com a versão atual do
ISOSYSTEM Administração
Ú Problema 2
http://1.1 401 Access denied
Ú Problema 3
Página em branco
Ú Problema 4
Warning main(gen_crypto.inc) failed to open stream. No such file or
directory…
Ú Problema 5
Você não está autorizado a ver esta página
Ú Problema 6
Database Error
Ú Problema 7
[diretorio_da_instalacao]\php\php.ini has no writing permissions.
Configuration not saved!
Ú Problema 8
Não é possível localizar a página
Ú Problema 9
Página carregando sem apresentar erros
Ú Problema 10
Report generate error
Ú Problema 11
Server not Found or Server Application not Started
Ú Problema 12
Não foi possível iniciar o serviço ISOSystem - Server em computador
local
Ú Problema 13
Conversor PDF não está operacional
Ú Problema 14
Caracteres 00 ao acessar os módulos
SoftExpert Software for Excellence
10
Troubleshooting
Executável incompatível
Problema 1:
Seu executável não é compatível com a versão atual do
ISOSYSTEM Administração.
Descrição:
Utilizando o ISOSYSTEM Administração versão 1.12, ao tentar acessar
o ISOSYSTEM Documentos versão 5 diretamente pela url, é
apresentada a mensagem acima.
Causas
Prováveis:
O módulo ISOSYSTEM Documentos com Administração 1.11 ou
superior, deve ser acessado através da barra de acesso rápido do
ISOSYSTEM Administração.
Soluções:
Acessar o módulo ISOSYSTEM Documentos através da barra de
acesso rápido do ISOSYSTEM Administração.
Sistema
Operacional:
Qualquer
Módulo e
Versão:
ISOSYSTEM Documentos 5.17.X
Banco de
Dados:
Qualquer
Ú Não há nome e versão de outros softwares envolvidos
Voltar
SoftExpert Software for Excellence
Lista de Problemas
11
Access denied
Problema 2:
http://1.1 401 Access denied.
Descrição:
Utilizando o DOCVIEW, ao salvar o documento em modo de edição, o
sistema retorna a mensagem de erro: HTTP://1.1 401 ACCESS
DENIED. O sistema está instalado em uma máquina com domínio,
onde a estação de trabalho não esta autenticada para efetuar o
acesso.
Causas
Prováveis:
· Bloqueio de anti-virus.
· Não autenticação do usuário do IIS.
Soluções:
· Desbloquear downloads dos aplicativos docview.exe e excelview.exe
no Antivírus.
· Verificar se o usuário e senha do usuário do IIS estão corretos.
· Verificar se na configuração do diretório virtual a opção autenticação
integrada está desmarcada.
· Verificar se o usuário do IIS é um administrador local.
Sistema
Operacional:
Windows X
Módulo e
Versão:
ISOSYSTEM Documentos X
Banco de
Dados:
Qualquer
Ú Não há nome e versão de outros softwares envolvidos
Voltar
SoftExpert Software for Excellence
12
Troubleshooting
Página em branco
Problema 3:
Página em branco.
Aplica-se a:
Ú Primeiro acesso
Ú Durante a utilização do ISOSYSTEM
Veja a descrição mais detalhada nas próximas seções.
Voltar
SoftExpert Software for Excellence
Lista de Problemas
13
Primeiro Acesso
Problema 3.1: Página em branco ao acessar o sistema pela primeira vez.
Descrição:
Ao acessar o sistema pela primeira vez, após instalar o ISOSYSTEM,
aparece uma página em branco.
Causas
Prováveis:
O ISOSYSTEM não consegue direcionar para página de configuração
com o banco de dados.
Soluções:
Complete o link na barra de endereços adicionando /wizard/config.php
Por exemplo: http://ipdoservidor/isosystem/wizard/config.php.
Sistema
Operacional:
Windows X
Módulo e
Versão:
ISOSYSTEM Administração 1.10 ou superior.
Banco de
Dados:
Qualquer
Ú Não há nome e versão de outros softwares envolvidos
Voltar
SoftExpert Software for Excellence
14
Troubleshooting
Durante a utilização do ISOSYSTEM
Problema 3.2: Páginas em branco durante a utilização do ISOSYSTEM.
Descrição:
Telas em branco em qualquer momento da utilização do ISOSYSTEM.
Causas
Prováveis:
Ocorre algum erro de execução do php, que não pode ser exibido
devido ao fato do parâmetro display_errors, no arquivo de
configuração php.ini, estar marcado como Off.
Soluções:
Edite o arquivo php.ini, localize o parâmetro display_errors e defina o
seu valor como On. Reinicie o IIS ou Apache e acesse novamente a
tela do ISOSYSTEM, o erro deverá ser exibido.
Sistema
Operacional:
Windows X
Módulo e
Versão:
Qualquer
Banco de
Dados:
Qualquer
Ú Não há nome e versão de outros softwares envolvidos
Voltar
SoftExpert Software for Excellence
Lista de Problemas
15
No such file ou directory
Problema 4:
Warning main(gen_crypto.inc) failed to open stream. No such file
or directory…
Descrição:
O erro acima ocorre após a atualização do módulo ISOSYSTEM
Administração e Generic.
Causas
Prováveis:
Após a atualização, não foi alterada a versão do Base Class nos
arquivos de configuração isosystem.ini.
Soluções:
Edite o arquivo isosystem.ini e altere o parâmetro base_version para a
versão correspondente.
Sistema
Operacional:
Windows X
Módulo e
Versão:
ISOSYSTEM Administração X e Generic X
Banco de
Dados:
Qualquer
Ú Não há nome e versão de outros softwares envolvidos
Voltar
SoftExpert Software for Excellence
16
Troubleshooting
Você não está autorizado a ver esta página
Problema 5:
Você não está autorizado a ver esta página.
Descrição:
Ao acessar o ISOSYSTEM, a mensagem acima aparece, pois o usuário
configurado no IIS não tem permissão para exibir a página.
Causas
Prováveis:
· A senha do usuário configurado no IIS está incorreta.
· O usuário configurado no IIS não tem permissão de administrador
local.
· A opção de autenticação integrada está marcada na aba Segurança
das propriedades do diretório virtual.
Soluções:
· Verificar se o usuário e senha do usuário do IIS estão corretos.
· Verificar se o usuário do IIS é um administrador local.
· Verificar se na configuração do diretório virtual a opção de
autenticação integrada está desmarcada.
Sistema
Windows X
Operacional:
Módulo e
Versão:
Qualquer
Banco de
Dados:
Qualquer
Ú Não há nome e versão de outros softwares envolvidos
Voltar
SoftExpert Software for Excellence
Lista de Problemas
Database Error
Problema 6: Database Error.
Aplica-se a:
Ú SQL Server 2005
Ú Outros Bancos de Dados
Veja a descrição mais detalhada nas próximas seções.
Voltar
SoftExpert Software for Excellence
17
18
Troubleshooting
SQL Server 2005
Problema 6.1:
Database Error com SQL Server 2005 (SQL Server 2005).
Descrição:
A mensagem acima aparece após a configuração do ISOSYSTEM
com o banco de dados SQL Server 2005 ou após migração do SGBD
para essa versão.
Causas
Prováveis:
A dll ntwdblib utilizada pelo php para conectar com o banco de dados
é incompatível com o SQL Server 2005.
Soluções:
Atualizar a ntwdblib.dll localizado na pasta c:\windows\system32. Esta
dll pode ser baixada no seguinte link:
http://www.softexpert.com/patch/ntwdblib.dll.
Sistema
Operacional:
Windows X
Módulo e
Versão:
Qualquer
Banco de
Dados:
SQL Server 2005
Ú Não há nome e versão de outros softwares envolvidos
Voltar
SoftExpert Software for Excellence
Lista de Problemas
19
Outros Bancos de Dados
Problema 6.2:
Database Error.
Descrição:
A mensagem acima ocorre após a realização da configuração do
ISOSYSTEM com o banco de dados.
Causas
Prováveis:
· As informações do banco de dados, preenchido no momento de sua
configuração, estão incorretos.
· Cliente do banco de dados não instalado ou não configurado.
· IBProvider não instalado (caso o SGBD seja Firebird).
Soluções:
· Verifique os dados de conexão com o banco e realize, novamente, a
configuração utilizando o link “Database Configuration”.
· Verifique se o cliente do banco de dados está instalado e
configurado corretamente.
· Verifique se o IBProvider está instalado (caso o SGBD seja Firebird).
Sistema
Operacional:
Windows X
Módulo e
Versão:
ISOSYSTEM Administração X
Banco de
Dados:
Qualquer
Ú Não há nome e versão de outros softwares envolvidos
Voltar
SoftExpert Software for Excellence
20
Troubleshooting
Configuration not saved
Problema 7:
[diretorio_da_instalacao]\php\php.ini has no writing permissions.
Configuration not saved!
Descrição:
A configuração do ISOSYSTEM não pode ser salva.
Causas
Prováveis:
· O usuário configurado no IIS não tem permissões de gravação na
pasta do ISOSYSTEM.
· O usuário configurado no IIS não tem permissões administrativas.
· Nas propriedades do arquivos php.ini esta marcada a opção de
somente leitura.
Soluções:
· Verificar as permissões de segurança do diretório de instalação do
ISOSYSTEM. O usuário que foi configurado no IIS deve ter permissão
total.
· Verificar se o usuário do IIS é um administrador local.
· Verificar se nas propriedades do arquivo php.ini a opção de somente
leitura está desmarcada.
Sistema
Windows X
Operacional:
Módulo e
Versão:
ISOSYSTEM Administração X
Banco de
Dados:
Qualquer
Ú Não há nome e versão de outros softwares envolvidos
Voltar
SoftExpert Software for Excellence
Lista de Problemas
21
Não é possível localizar a página
Problema 8:
Não é possível localizar a página.
Descrição:
Ao entrar no ISOSYSTEM, aparece a mensagem de que não é possível
localizar a página.
Causas
Prováveis:
O php não tem permissão de ser executado.
Soluções:
Verifique se as extensões de serviços estão permitidas para .dll do php
(isapi_fcgi.dll).
Sistema
Windows 2003
Operacional:
Módulo e
Versão:
Qualquer
Banco de
Dados:
Qualquer
Ú Não há nome e versão de outros softwares envolvidos
Voltar
SoftExpert Software for Excellence
22
Troubleshooting
Página carregando sem erros
Problema 9:
Página carregando sem apresentar erros.
Descrição:
Ao acessar o ISOSYSTEM pela primeira vez, o Internet Explorer fica
carregando a página sem apresentar erros.
Causas
Prováveis:
A versão do Internet Explorer é incompatível.
Soluções:
Verifique qual a versão do Internet Explorer instalado, se for inferior a
versão 5.5, atualize para versão 5.5 ou superior.
Sistema
Windows X
Operacional:
Módulo e
Versão:
ISOSYSTEM Administração X
Banco de
Dados:
Qualquer
Ú Nome e versão de outros softwares envolvidos: Internet Explorer 5.0 ou inferior.
Voltar
SoftExpert Software for Excellence
Lista de Problemas
Report generate error
Problema 10:
Report generate error.
Aplica-se a:
Ú http://localhost:5009/softexpert/jasperreport
Ú Connection refused
Veja a descrição mais detalhada nas próximas seções.
Voltar
SoftExpert Software for Excellence
23
24
Troubleshooting
http://localhost:5009/softexpert/jasperreport
Problema 10.1:
Report
generate
http://localhost:5009/softexpert/jasperreport
error!!!
Descrição:
O erro acima ocorre ao visualizar relatórios por meio do gerador de
relatórios.
Causas
Prováveis:
· O gerador de relatórios não está configurado.
· A versão do java JRE é inferior à 1.5.
Soluções:
· Verifique se o jasperreport está habilitado no arquivo de
configuração seservice.ini.
· Verifique a versão do java e, se necessário, atualize para versão
1.5 ou superior.
Sistema
Operacional:
Windows X
Módulo e
Versão:
Qualquer
Banco de
Dados:
Qualquer
Ú Não há nome e versão de outros softwares envolvidos
Voltar
SoftExpert Software for Excellence
Lista de Problemas
25
Connection refused
Problema 10.2:
Report generate error!!! Connection refused: connect
Descrição:
A mensagem acima aparece ao visualizar relatórios através do
gerador de relatórios.
Causas
Prováveis:
· O SEServer não está instalado.
· O SEServer não está iniciado.
· A porta do SEServer está sendo bloqueada no firewall.
Soluções:
· Verifique se o serviço SEServer esta instalado.
· Verifique se o serviço SEServer esta iniciado.
· Verifique se tem algum firewall bloqueando a porta do SEServer
(normalmente porta 5009).
Sistema
Operacional:
Windows X
Módulo e
Versão:
Qualquer
Banco de
Dados:
SQL Server 2005
Ú Não há nome e versão de outros softwares envolvidos
Voltar
SoftExpert Software for Excellence
26
Troubleshooting
Server not Found
Problema 11: Server not Found or Server Application not Started.
Descrição:
O executável de determinado módulo client/server não conseguiu
encontrar o serviço ISOSYSTEM Server.
Causas
Prováveis:
· ISOSYSTEM Server não está instalado.
· ISOSYSTEM Server não está iniciado.
· A porta do ISOSYSTEM Server está bloqueada no firewall.
Soluções:
· Verifique se o serviço ISOSYSTEM Server está instalado.
· Verifique se o serviço ISOSYSTEM Server está iniciado.
· Verifique se tem algum firewall bloqueando a porta do ISOSYSTEM
Server (normalmente porta 9000).
Sistema
Windows X
Operacional:
Módulo e
Versão:
Qualquer
Banco de
Dados:
Qualquer
Ú Não há nome e versão de outros softwares envolvidos
Voltar
SoftExpert Software for Excellence
Lista de Problemas
27
Erro ao iniciar o ISOSYSTEM - Server
Problema 12:
Não foi possível iniciar o serviço ISOSystem - Server em
computador local.
Descrição:
Ocorre ao tentar iniciar o ISOSYSTEM Server.
Causas
Prováveis:
O ISOSYSTEM Server não foi configurado.
Soluções:
Verifique se foi cadastrada uma conexão
CFGISOSystemServer e tente novamente.
Sistema
Windows X
Operacional:
Módulo e
Versão:
Qualquer
Banco de
Dados:
Qualquer
Ú Não há nome e versão de outros softwares envolvidos
Voltar
SoftExpert Software for Excellence
por
meio
do
28
Troubleshooting
Erro no Conversor PDF
Problema 13: Conversor PDF não está operacional.
Descrição:
Os documentos não são convertidos após instalar o OpenOffice 2.0,
habilitar e configurar o PDF Converter.
Causas
Prováveis:
· O java não reconhece os path do OpenOffice.
· A versão do java JRE é inferior à 1.5.
Soluções:
· Reinicie o servidor para carregar os path do OpenOffice (Programe
esta reinicialização com o administrador do servidor).
· Verifique a versão do java e, se necessário, atualize para versão 1.5
ou superior.
Sistema
Windows X
Operacional:
Módulo e
Versão:
ISOSYSTEM Documentos 5.17.6, 6.2 ou superior.
Banco de
Dados:
Qualquer
Ú Nome e versão de outros softwares envolvidos: OpenOffice 2.0
Versões superiores à 2.0 do OpenOffice não são compatíveis com o
Conversor PDF.
Voltar
SoftExpert Software for Excellence
Lista de Problemas
29
Caracteres 00 ao acessar os módulos
Problema 14: Caracteres 00 ao acessar os módulos.
Descrição:
Ao acessar algum módulo ISOSYSTEM, aparecem os caracteres "00"
ao invés de carregá-lo.
Causas
Prováveis:
O login do usuário está preso no banco de dados.
Soluções:
Acesse o módulo ISOSYSTEM Administração e, por meio do menu
Configuração Ú Usuários Conectados, desconecte os usuários que
estão presos.
Sistema
Windows X
Operacional:
Módulo e
Versão:
ISOSYSTEM Administração X
Banco de
Dados:
Qualquer
Ú Não há nome e versão de outros softwares envolvidos
Voltar
SoftExpert Software for Excellence
Dúvidas
Capítulo
IV
Dúvidas
4
31
Dúvidas
Entre em contato com o SAC (Serviço de Atendimento ao
Cliente) da SoftExpert, se seu problema não estiver disponível
neste documento ou em caso de dúvidas:
E-mail: [email protected]
Telefone: +55 (47) 2101 9900
SoftExpert Software for Excellence