Installation Guide

           Last update: 07/29/2004

     

  • Overview

    Based on client/server architecture, Magic C++'s full installation consists of two phases. One for the server component - RDA( Remote Development Agent ), and one for the client component C/C++ IDE( Integrated Development Environment ). Without RDA installed IDE can ONLY work under edit mode and without support for remote compiling and debugging.

    System requirements:

    Server OS:

    AIX: AIX 4.3 , AIX 5L

    SUN: Solaris 2.6 ,Solaris 2.7 , Solaris 7 , Solaris 8

    HP: HP-UX 9.x , HP-UX 11

    Linux: Red Hat Linux 7.0 , Red Hat Linux 8.0,  Red Hat Linux 9.0,Turbo Linux 7.0,SuSE Linux 7.1

    BSD: FreeBSD 4.7 , FreeBSD 4.8 , FreeBSD 4.9.£¬OpenBSD 2.7.

    With ftp, telnet, development rpm packages installed

    Client OS:

    Win2000/XP/2003

    ( ***Notice: We no longer support Windows98*** )

  • Prerequisites

    Before installing Magic C++, please check to make sure that:

    1. Client can communicate with server via TELNET and FTP

    2. Server has development packages( gcc, gdb etc. ) installed and works normally

  • Unzipping software package

    Unzip software package with compression/de-compression tool( winzip, winrar etc. ), and the directory after unzipping looks like this:

    Server\                     --source codes package for RDA

    Client\                      --Windows setup package for IDE

    Doc\                        --Documents

  • Installing client component - IDE

    Enter client directory and use your mouse to double click Setup.exe then follow the setup instructions step by step. Enter any characters when prompted for serial number to evaluate the software for 45 days.

  • Installing server component - RDA

    1. Transfer the source codes package to the server via FTP or other measures

    2. Extract files from the package, execute command as:

    tar -zxvf magicd-x.tar.gz

    ( ***Notice: x is the release version of the package*** )

    If an old version of this software package exists please remove it first.

    3. Compile the source codes and install

    ./configure

    or

    ./configure --prefix=your_magicd_install_path

    make

    make install

    If you meet problems with these steps please send us the error output info, we'll solve it for you as soon as possible, thank you.

  • Start Remote Development Agent( daemon process )

    with the default options

    cd /your_magicd_install_path/bin

    ./magicd

    You will see output info like this:

    Starting Magic C++ Server daemon program...
    Install Root Directory is :/home/ken/magicd-2.5.0/../magicd-2.5.0
    Starting up http server on the port [2104]
    Magic C++ Server Daemon Startup successfully on port [2004]...
    Copyright(c) 2004 MagicUnix Information Technology Limited. All right reserved

    with the customized options

    Usage : magicd [-p PORT] [-t HTTP_PORT] [-f FILE] [-L FILE] [-a USERNAME,PASSWORD]

    [--help][--version] [--col ] [--row ] [--debug]

    -p PORT

    RDA listening socket port£¬default is 2004.

 -t HTTP_PORT

    HTTP  server listening socket port£¬default is 2104.

 -f FILE

    specify an option file£¬the option file format will be list below.

    ( ***Notice£ºOther command line options will be ignored if you use this option*** )

-L FILE

    specify the login program.

-a USERNAME,PASSWORD

    enable the authentication ability embeded in RDA with specified username and password. This option is NECESSARY if you startup RDA with non-root user.

-h = --help

    print help info

-v = --version

    print version info

-d = --debug

    work under debugging mode, the RDA will print debugging info in details to the log file, that will help us to solve problems for you.

-c = --col

    specify the number of columns of terminal, default is 300

-r = --row

    specify the number of rows of terminal, default is 100

 

Here is the standard format of the option file

###################################

[COMMON]

port=2004

login=/bin/login

debug=0

http_port = 2104

        [WINSZ]

row = 100

col = 300

[SELF_AUTH]

self auth = 0

#need check password

username=magicd

password=magicd

###################################

Comment for each option:        

port - listening socket port

row -  number of rows

col - number of columns

self auth - enable/disable the authentication ability embeded in RDA

username - username

password - password

http_port - HTTP server listening socket port

( ***Notice£ºOther command line options will be ignored if you use this option*** )

Non-root user notice

If you're not logged in as superuser, authentication by the server is disabled. Magic C++ provides password authentication to solve the problem. You have to properly configure username and password before activating the authentication ability.

In [SELF_AUTH] section of /your_magicd_install_path/etc/magic.ini:

modify "username = magicd" to your own login name

modify "password = magicd" to your own password

modify "self auth = 0" to "self auth = 1"

  • Stop Remote Development Agent( daemon process )

    To stop Remote Development Agent, execute command:

    cd /your_magicd_install_path/bin

    ./killit.sh

    Back to Top