- Overview
- Prerequisites
- Unzipping software package
- Installing client component - IDE
- Installing server component - RDA
Last update: 05/22/2004
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:
Linux ( with ftp, telnet, development rpm packages installed )
FreeBSD ( with ftp, telnet, development packages installed )
Client OS:
Win2000/XP/2003
( ***Notice: We no longer support Windows98*** )
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
Unzip software package with compression/de-compression tool( winzip, winrar etc. ), and the directory after unzipping looks like this:
Server\ --Linux/FreeBSD setup package for RDA
Rpm\
Linux\ --Linux rmp package for server
Tar\
FreeBSD\ --FreeBSD tar package for server
Linux\ --Linux tar package for server
Client\ --Windows setup package for IDE
Doc\ --Documents
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.
with the RPM package( recommended for Linux)
It is strongly recommended to install RPM package with superuser privilege( known as root ), it's the simplest way to install RDA.
1. Transfer the RPM package to the server via FTP or other measures
2. Change user to root
$ su root
3. Install RPM package
# rpm -ivh magicd-x.rpm
If there exist old version software package, execute command as:
# rpm -Uvh magicd-x.rpm
( ***Notice: x is the release version of the package*** )
4. Startup Remote Development Agent( daemon process )
# cd /var/magicd/bin
# ./magicd
default listening socket port is 2004.
You can change listening socket port by command option -p like this:
# ./magicd -p 5000
( ***Notice: If you have changed the listening socket port, you MUST change the server property in the client IDE for it to work normally.*** )
5. Test it. Start up IDE, use Server Wizard to create a new server profile, input the username and password for remote login and click 'Test' button to examine if RDA works properly.
6. To stop Remote Development Agent, execute command as:
# cd /var/magicd/bin
# ./killit.sh
with the binary tarball
If the server OS is not linux , or you don't have the superuser privilege, you have to install RDA with the binary tarball.
1. Transfer the binary tarball to the server via FTP or other measures.
2. Extract files from the binary tarball, execute command as:
$tar -xvf magicd-x.tar
( ***Notice: x is the release version of the package*** )
If an old version of this software package exists please remove it first.
3. Set environment variable $MAGICHOME to the software installation directory in your default startup shell profile. ( ***Notice: It's necessary for the server component to work properly*** )
Add this to your default startup shell profile ( i.e. .bash_profile, etc. )
MAGICHOME=/your_path_name/magicd-x
export MAGICHOME
( ***Notice: x is the release version of the package*** )
4. Login again to enable the environment variable 'MAGICHOME'.
5. 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 $MAGICHOME/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"
6. Start Remote Development Agent( daemon process )
$ cd $MAGICHOME/bin
$ ./magicd
default listening socket port is 2004.
You can change listen socket port by command option -p like this:
$ ./magicd -p 5000
( ***Notice: If you have changed the listening socket port, you MUST change the server property in the client IDE for it to work normally.*** )
7. Test it. Start up IDE, use Server Wizard to create a new server profile, input the username and password you just configured and click 'Test' button to examine if RDA works properly.
( ***Notice: If Remote Development Agent works without superuser privilege, you MUST change the debug redirection terminal port property of the server in the IDE to work normally. Select File->Remote Server Manager, double click the server profile name , select 'Advance' page , modify Telnet port correspond to the Remote Development Agent*** )
8. To stop Remote Development Agent, execute command:
$ cd $MAGICHOME/bin
$ ./killit.sh
