IBM Conect:Direct - Instalação

Última revisão: 17/09/2025 

Slack: Carlos.pires@ibm.com Documentação Técnica:

0.0 Download e Extração de Arquivo IBM_CD 

1.0 Preparação

    A. Baixar seu pacote IBM_CD_etc_etc_x64_etc.tar.Z , o pacote pode ser baixado por sites IBM como o FIX, Passaport Advantege, Boxes ou compartihado por IBMistas

    B. Para trasnferir este arquivo para sua VM você pode usar:
Comando SCP ou o comando Curl que funciona a partir de um link direto de um box ou drive.

    Para conseguir este link basta CTRL +J, para acessar o historico de dowloads do google

 

    1.1 Download do arquivo via curl 

        Comando utilizado: 
           "curl -L -o 'IBM_CD_V6.4_UNIX_SuSE_Power_LE (10).tar.Z' 'https://LINK"           
 
         Dicas essenciais: 

• -L: Faz o curl seguir redirecionamentos HTTP (essencial para links da Box). 

• -o: Define o nome do arquivo salvo localmente. 

• Aspas simples '...' são obrigatórias quando o nome do arquivo ou URL contém caracteres especiais como !, espaços ou parênteses. Isso evita que o shell interprete incorretamente. 

 

     1.2 Verificação do tipo de arquivo com file

         Após subir seu arquivo para VM e recomendavel verifica-ló

        

            Comando:  "file "IBM_CD_V6.4_UNIX.tar.Z" 

         (Mude para o nome do seu Arquivo) 
 
        Observação: 

        Apesar de ser .tar.Z, o arquivo pode não estar compactado com compress, mas sim ser             Um .tar puro. Isso é comum quando o nome do arquivo não reflete seu conteúdo real. 

 

     1.3 Extração com tar 

            Comando: 

        bash 

        tar -xvf "IBM_CD_V6.4_UNIX_.tar.Z" 

 

        Explicação: 

• -x → extrai os arquivos 

• -v → mostra os arquivos sendo extraídos (modo verboso) 

• -f → especifica o nome do arquivo .tar 

•    Resultado no Prompt 
             ./cdinstall 

             ./cdinstall_a 

             ./cdunix 

                   - Se Apareceu isso está correto 

   

 
 

       1.4 Inspeção dos arquivos extraídos 

            Comando sugerido: 

            file cdinstall cdinstall_a cdunix 

 

     2.0 Criação e Observação do diretório /home/cduser/installers/ 

        

    A . Crie o Usuario que receberá o C:D 

            *Provalmente terá que ser como Root / su -

                Para criar o usuário

                    useradd cduser

            

                 Para Alterar a Senha
                     passwd cduser

                Para Acessar o usuario cduser

                      su - cduser

    B . Crie os diretório de instalação   (Importante, em alguns casos so e possivel como ROOT)
            Crie os diretórios temporários com :

                mkdir -p /home/cduser/installers/

       

    C . Mova os Arquivos   (Importante)

                        Mova os arquivos para a psata Installers

                        mv ~/cdinstall ~/cdinstall_a ~/cdunix /home/cduser/installers/   

                               Ou

                            

                            mv/home/cecuser/cdinstall/home/cecuser/cdinstall_a/home/cecuser/cdunix/home/cduser/installers/

         OBS ->Antes de iniciar o processo de instalação do Connect:Direct for UNIX, é fundamental garantir que os três arquivos extraídos do pacote oficial estejam presentes e acessíveis no diretório /home/cduser/installers/. 
Os arquivos obrigatórios são: 

cdinstall – script principal de instalação 

cdinstall_a – script auxiliar utilizado durante o processo 

cdunix – arquivo de instalação propriamente dito (normalmente com tamanho superior a 300 MB) 

            - Todos os arquivos devem estar com permissões de execução (chmod 755) e                               pertencentes ao usuário cduser (chown cduser:cduser).             - Isso garante que o instalador possa validar e acessar corretamente os componentes,                evitando falhas como “not a Connect:Direct for UNIX cpio installation file”. 

 

       2.1 Exemplo de verificação: 

        bash 

        ls -l /home/cduser/installers/ 
 

            Resultado esperado: 

        -rwxr-xr-x 1 cduser cduser 124755 ... cdinstall 
        -rwxr-xr-x 1 cduser cduser 154782 ... cdinstall_a 
        -rwxr-xr-x 1 cduser cduser 355118080 ... CDUNIX 
 
        (Entre outros Arquivios) 

 
 

        2.2 Resumo
        Você: 

Tranferiu o Arquivo para a sua VM com SCP ou CURL 

Verificou o tipo real do arquivo com file. 

Diagnosticou corretamente a extensão do Arquivo 

Renomeou o arquivo para .tar
Extraiu com sucesso os componentes do instalador IBM. 
 

 

2.3 Comando:
Antes de iniciar a instalação, é necessário garantir que
 o diretório de destino exista e esteja acessível ao usuário responsável pela instalação

 

bash  

sudo mkdir -p /home/cduser/cdunix 
OBS - Caso não funcione os comando, tente sem SUDO na frente
 e teste novamente
 
sudo chown cduser:cduser /home/cduser/cdunix 
se não funcionar tente - sudo chown cduser:users /home/cduser/cdunix
Se Tambem não funcionar, talvez o grupo não exista e seja necessário criá-lo com

OPCIONAL - mkgroup cduser
 

Explicação técnica: 
mkdir -p: cria o diretório de destino, mesmo que ele ainda não exista. 
chown: garante que o usuário cduser seja o proprietário do diretório, permitindo que o instalador grave os arquivos sem erro de permissão.
 

3. Execução do Instalador 

Logado como cduser, iniciamos o instalador conforme instrução: 
EXECUTE:

1- cd /home/cduser/installers  
2 - ./cdinstall  para iniciar a instalção 

•  
   
   

  
   
  Tela 1 Passo1 – Boas-vindas do Instalador 

 

 Explicação: Essa tela marca o início oficial do processo de instalação. Ao pressionar ENTER, o instalador prossegue para a definição do diretório de destino. 

 

    passo 2 – Definição do Diretório de Instalação 

      

 

    Escolha feita: 

/home/cduser/cdunix  

 Explicação: 

• O diretório /home/cduser/cdunix será usado para armazenar todos os arquivos do Connect:Direct. 

• Usamos o caminho completo, evitando ambiguidade e garantindo compatibilidade com scripts e configurações futuras. 
   

 Passo 3 – Seleção do Tipo de Instalação 

 

 Escolha feita: 

1  

         Explicação: Selecionamos a opção (1) para instalar tanto o servidor quanto o cliente (CLI/API) na mesma máquina.             Informe a instalação 1 e "pressione Enter” 

        Essa escolha garante que todos os componentes necessários para operação e comunicação estejam disponíveis localmente. 
 
 
Passo 4 - Informar o caminho do arquivo de instalação 

- Após selecionar a opção (1) para instalar o Connect:Direct for UNIX Server and Client (CLI/API), o instalador solicita o caminho completo do arquivo de instalação. 
 
 
Prompt do PowerShell 

Resposta- 
 /home/cduser/installers/cdunix 
 
 

 
Passo 5  
Após informar o caminho completo do arquivo de instalação (/home/cduser/installers/cdunix), o instalador exibe a versão do produto que será instalada e solicita confirmação para prosseguir. 

Prompt exibido: 

Resposta correta: 
Y 
 
 Explicação: Este prompt confirma que o instalador reconheceu corretamente o arquivo cdunix e está pronto para instalar os componentes Server e Client na mesma máquina. A versão exibida pode variar (ex: 6.1.0.1 ou 6.4.0.0), mas o procedimento permanece o mesmo. 

Resultado esperado: O instalador inicia a verificação de espaço em disco e começa a extrair os pacotes necessários para a instalação. Ao final, a mensagem Done será exibida, indicando que a instalação foi concluída com sucesso e que o processo de personalização será iniciado automaticamente. 

 

 
- Se a verificação foi feita corretamnete você verá esta tela 
PRESS ENTER 

Após a instalação dos pacotes, o instalador inicia automaticamente o processo de personalização do ambiente Connect:Direct. Neste momento, é exibido o seguinte menu: 

 

Escolha realizada: Opção (3) — Server e Client 

Resposta digitada: 

plaintext 

3 
 

Justificativa técnica da escolha 
A opção (3) foi selecionada porque: 

o objetivo é instalar e configurar tanto o Server quanto o Client na mesma máquina. 

Essa abordagem garante que o ambiente Connect:Direct esteja completo, permitindo tanto o envio quanto o recebimento de arquivos via CLI/API. 

- A escolha da opção (3) automatiza a criação dos arquivos de configuração necessários para ambos os componentes, evitando a necessidade de executar etapas separadas para Server e Client. 

 

Configuração do Connect:Direct for UNIX Server 

Após selecionar a opção (3) no menu de personalização, o instalador inicia a configuração do ambiente do Server. Serão solicitadas diversas informações de rede e identificação do node. 
 

Identificação única do node 
O nome do node deve ser  CDNODE01 que é usado internamente pelo Connect:Direct para identificar esta instância específica do servidor. 

Ele será referenciado em diversos arquivos de configuração, como: 

- initparm.cfg 

- netmap.cfg 

- userfile.cfg 

 

 

ENTER 

 

 

Configuração do Arquivo de Autorização de Usuários (userfile.cfg) 
Caminho do arquivo gerado: /home/cduser/cdunix/ndm/cfg/CDNODE01/userfile.cfg 

Tipos de registros suportados: 

1. Usuário remoto 

2. Usuário local 

Respostas fornecidas durante a configuração: 

Inserir usuário remoto: N 

Inserir usuário local: Y 

Nome do usuário local: cduser 

Conceder autoridade administrativa: Y 

Inserir outro usuário local: N 
 

Resultado: 
Registro único criado para o usuário cduser 
Associado ao node CDNODE01 
Com permissões administrativas habilitadas

Após a finalização da configuração do Server, o instalador inicia automaticamente a configuração do Client. 
O arquivo de configuração do Client é criado em: /home/cduser/cdunix/ndm/cfg/cliapi/ndmapi.cfg 
Esse arquivo define as informações de conexão entre o Client e o Server do Connect:Direct 
 
Configuração do CD Cliente 
Durante a personalização do Connect:Direct, após a configuração do Server, o instalador inicia automaticamente a configuração do Client. 

Pergunta: Enter port of the Connect:Direct Server this Client will connect to:  
 
Resposta: 1363  
 
A porta 1363 é o valor padrão utilizado para a comunicação entre o Client e o Server. Deve ser mantida, salvo necessidade específica. 

Pergunta: Enter hostname of the Connect:Direct Server this Client will connect to:  
 
Resposta: (xxxx) Depende 
 
Este valor varia conforme o hostname real da máquina. O nome cdnode01 foi usado neste exemplo, mas em cada ambiente pode ser diferente, conforme definido no arquivo /etc/hosts. 

Resultado: O arquivo de configuração do Client foi criado em: /home/cduser/cdunix/ndm/cfg/cliapi/ndmapi.cfg 

Além disso, foi gerado o arquivo de chave de autenticação padrão com o valor CD4UNIX. 
 
 

Configuração com privilégios de root 

Após a configuração do Server e do Client, o instalador apresenta a opção de realizar tarefas que exigem privilégios administrativos. Neste ponto, deve-se escolher a opção: 

 

Após isso:

 

PRESS ENTER 

 

 

- O instalador solicita confirmação para continuar com essas ações (Y) e,  
 
- Em seguida, pede a senha do usuário root para aplicar as configurações. 

 

Definição de acesso para o usuário root Foi escolhida a opção "N", permitindo que o usuário root tenha acesso local ao sistema. 

 

Configuração de permissões para iniciar o serviço O instalador perguntou se o serviço seria iniciado pelo instalador ou por alguém do grupo primário.  

A resposta foi Y, ativando o suid bit no executável cdpmgr. 
 Isso permite que o usuário cduser (ou outro do mesmo grupo) possa iniciar o serviço sem precisar de root diretamente. 
 

 

 

Etapa Final da Personalização: Encerrando o Instalador 
 

Ação realizada: Foi escolhida a opção [5], conforme indicado na sua documentação, para encerrar o procedimento de personalização do Connect:Direct for UNIX. 

 

Último Passo: Encerramento da Personalização e Preparação Final 

 

pós todas as configurações (Server, Client, permissões com root e definição de acesso), o instalador foi encerrado com a seguinte escolha: 

plaintext 

Enter your choice:[3]5 
 

Essa ação finalizou o procedimento de personalização do Connect:Direct for UNIX. 

Iniciando o Connect:Direct Server 

Após o encerramento do instalador e retorno ao usuário cduser, o próximo passo é iniciar o serviço do Connect:Direct Server. 

Execute o seguinte comando, substituindo <nodename> pelo nome do nó configurado durante a instalação para INICIAR O CD, NÃO ACESSAR, APENAS INICIAR e como se fosse para liga-lo na tomada 

Iniciando o servidor C:D 

/home/cduser/cdunix/ndm/bin/cdpmgr -i /home/cduser/cdunix/ndm/cfg/<nodename>/initparm.cfg 
--------------------------------------------------------------------------- 
Verificação da Instalação e Inicialização do Cliente 

Após a inicialização bem-sucedida do Connect:Direct Server com o comando: 

bash 

/home/cduser/cdunix/ndm/bin/cdpmgr -i /home/cduser/cdunix/ndm/cfg/CDNODE01/initparm.cfg 
 

Prosseguimos com os seguintes passos para validar o ambiente e preparar o uso do cliente. 

1️⃣ Exportando a variável de ambiente NDMAPICFG 

Comando executado: 

- bash 

export NDMAPICFG=/home/cduser/cdunix/ndm/cfg/cliapi/ndmapi.cfg 
 

Motivo: Essa variável aponta para o arquivo de configuração da API do cliente Connect:Direct. Sem ela, o comando direct não consegue localizar os parâmetros necessários para se conectar ao serviço. 

Dica: Sempre execute esse export na mesma sessão antes de chamar o cliente. Para tornar permanente, pode ser adicionado ao .bash_profile ou .bashrc do usuário cduser. 

2️⃣ Invocando o cliente direct 
 

Comando executado: 

bash 

/home/cduser/cdunix/ndm/bin/direct 
 

Motivo: Esse comando inicia o cliente interativo do Connect:Direct, permitindo o envio de processos, consulta de estatísticas e monitoramento de transmissões. 

Dica: Se o cliente não abrir ou exibir erro, verifique se o serviço cdpmgr está ativo e se a variável NDMAPICFG foi corretamente exportada. 

3️⃣ Verificando estatísticas no prompt do direct com “Select statistics”3 
 

Comando executado dentro do cliente: 

plaintext 

direct> Select statistics; 
 

Motivo: Esse comando exibe estatísticas gerais do sistema, como processos executados, status de transmissões e histórico de atividades. É uma forma rápida de validar se o ambiente está funcional. 

Dica: Use esse comando após iniciar o serviço e antes de enviar qualquer processo. Ele ajuda a confirmar que o Connect:Direct está operando corretamente. 

4. Execute um processo de validação.

    Este procedimento de exemplo realiza a cópia do arquivo msgfile.cfg para cddelete.me dentro do diretório pessoal do usuário.

plaintext

Direct> submit file=/home/cduser/cdunix/ndm/bin/sample.cd;

-  Para acompanhar a execução do processo, utilize o comando:

Direct> select process pnumber=1;

O Connect:Direct exibirá um relatório contendo: identificador e nome do processo, usuário responsável, nó de origem, fila de execução e status atual.

Após a conclusão, consulte os dados estatísticos com:

plaintext

Direct> select statistics pnumber=1;

ACESSANDO O DIRECT APÓS SAIR DA VM

Esse passo a passo retrata o caminho necessario para entrar na vm após intalar o direct

Este passo muito importante pois voce fará isso todas as vezes que acessar 

seu direct, TODAS

1- Entre com SSH + sua PSSWD

2- Como cduser EXECUTE OS 4 COMANDOS EXPORT 

export D_DIR=/home/cduser/cdunix/ndm
export PATH=$D_DIR/bin:$PATH
export LIBPATH=$D_DIR/lib:${LIBPATH}
export NDMAPICFG=$D_DIR/cfg/cliapi/ndmapi.cfg




Importância dos exports: 
Sem essas variáveis, o sistema não localizará os binários 
nem as bibliotecas necessárias para inicializar o Connect:Direct. 
Isso resultará em erros como command not found ou falhas de carregamento
 de dependências.
 Esses exports garantem que o ambiente esteja corretamente 
configurado para cada sessão.


3 Utilize um destes Comandos para iniciar o CLI do Direct

./direct

ou

 /home/cduser/cdunix/ndm/bin/direct

ou

 $D_DIR/bin/ndmcli


Obs: As submissões de processos e estatísticas continuam funcionando da mesma forma.
 O que muda é que, todas as vezes que você acessar sua VM, será necessário executar
 novamente os comandos export para configurar corretamente o ambiente do 
Connect:Direct. Esse passo é essencial para garantir que o CLI funcione como
 esperado em cada nova sessão.