Assume you downloaded the file xxx.tar.gz, run the following command

   gzip -cd xxx.tar.gz | tar -xvof - 
   cd xxx 
   run "sh ./install.sh" 

Q: Error: cannot restore segment prot after reloc: Permission denied in linux?

The latest Linux enabled new kernel security extensions (SELinux). SELinux also changes some default system behaviors, such as shared library loading. There are two solutions for this.

1. update SElinux configuration. editing the /etc/selinux/config file and change SELINUX=enforcing to SELINUX=permissive After rebooting, it should work. Or you can run the command: "setenforce Permissive"
2. Assume ch is installed at /usr/local/ch directory,
   

    cd /usr/local/ch
    find . -name '*.dl' -exec chcon -t texrel_shlib_t {} \;
   

   For created dynamically loaded lib such as file.dl using Ch SDK, run the following command to update the created file. chcon -t texrel_shlib_t file.dl

Soluiton 2 is recommended.

Q: I got the error Shared object "limb.so.2" not found in FreeBSD 5.4, how to resolve it?

When you start Ch under FreeBSD 5.4, you might see the message "/usr/libexec/ld-elf.so.1: Shared object libm.so.2" not found. You need Install in FreeBSD compat4x port to fix this issue.

Q: How to uninstall Ch in Windows?

Click Control Panel in My Computer. Click Add/Remove Programs, select SoftIntegration Ch 2.0 xxx Edition, where xxx can be either Professional, Standard and Evaluation, then click Add/Remove. Press Yes if you are asked to complete remove Ch and all of its components.

Q: How to uninstall Ch in Unix and Mac OS X?

The uninstallation instruction can be found in CHHOME/docs/chinstall.pdf.
You can remove Ch and all related components from CHHOME directory such as /usr/local/ch. Remove symbolic link /bin/ch. Remove login shells /bin/ch in /etc/shells if it was installed. And remove $HOME/.chrc if it was created.

Q: When installing Ch software, why does it always ask to uninstall the old version of Ch? I already uninstalled all of the old version of Ch.

It might be because you didn't clean up the registry values for Ch. The most likely reason is that you tried to uninstall manually or uninstallation is incomplete. One of the following two solutions below may solve the problem.

1. Reboot. You have to reboot to finish the uninstallation if you are using Ch while uninstalling Ch.
2. Click the uninstall to continue as you were asked, it will go through the uninstallation for you automatically. And then run Ch installation program such as installch_b.exe again to reinstall Ch.

This is related to the default MS-DOS windows setup. There are three solutions to this problem. The first solution applies to Ch shell in the current window only. The other two solutions apply to Ch in both current window and startup.

1. Type: ALT+ENTER, it will resize the Ch shell prompt in windows from full screen to normal window, similar to the solution for changing from full screen to a window in MS-DOS shell.
2. • Open My Computer
   • open C: drive
   • open the windows directory
   • click on "show files"
   • click on the system directory
   • click on "show files"
   • right click on conagent
   • select properties
   • select the screen tab
   • select the window button under usage
   • click ok
3. type "Alt"+"Tab", and then the MS-DOS shell will be found at the toolbars -- at the right hand side of "Start". Right click the MS-DOS shell=>"Properties", then click menu "Screen", under "Usage", select "Window" instead of "Full Screen", then click "Apply".

Q: How to change the windows home directory in ch shell?

You can follow the microsoft link here to change your home directory. After the change, you are required to reboot your computer to be effective.

Q: How to compile the program in Ch shell or ChIDE?

In Unix, if you have gcc or Mac OS X xcode installed, you can compile the code from Ch shell or ChIDE directly.

In Windows, if you have Microsoft Visual Studio or Express Edition installed, the installer will do the auto configuration for you. You need to run "ch -d" to copy the configure file _chrc to your home directory. Then, start Ch shell using command cl or nmake for compilation.
To compile From ChIDE, Click menu bar Tools --> Compile to compile your C code.

If you install Microsoft Visual Studio or Express Edition after Ch has been installed, run "ch -d" to copy the configure file _chrc to your home directory, and then edit _chrc file in your home directory to comment out the settings that we preset for Microsoft Visual Studio.

Q: How to change .c association with Ch instead of Visual C++?

Click "Start"->"Run", then type explorer from Open:, it will pop up explorer window, Click menu bar "Files"->"Folder Options", then select "File Types", Under "Registered file types", scroll down to the line "C C Source", then select it, it will display "Opens with: Microsoft Visual studio 2005" depending on your visual studio version, you can select "Change...", then select "Browse ...", and find the your ch home directory and select the file "c:\ch\bin\ch.exe", then select "OK" to close the window.

Q: How to install Ch Professional Edition in a teaching lab?

There are two ways to install Ch Professional edition in a lab. Both solutions allow you to re-image machines in a lab easily. You can just select one that meets the guideline for your lab.

1. You can use a floating license server and install Ch Professional Edition in the lab. The floating license server can control the maximum number of machines to use Ch Professional simultaneously. You need to provide the Mac address, host name and operating system of your floating license server, and the operating system and number of floating client machines in the lab.

   Please note that the client machines need to have the access to the floating license server to check out a license at run time.

2. If you don't have a floating license server machine or don't have the internet connection between clients and server at run time, you need to install a individual license for each machine. You need to provide us with the Mac address and operating system for all machines in your lab. We can then create a single license file which can be used for all machines. A single license file is easy to set up in the master machine to duplicate for other machines in the lab.

When you provide the operating system of your machine, you need to specify if it is 32 bit or 64 bit machine. You need to download Ch Professional Edition (actually Ch Professional Evaluation Edition) from here. Once a proper license file is in place, Ch Professional Evaluation Edition will become Ch Professional Edition.

In Windows, we offer a special Ch Professional Edition that allows silent installation via Active Directory push. A system administrator for your teaching lab can contact us about how to get such a binary.

Q:How to get Mac address of a machine?

There are two ways to get Mac address of your machine.

• Solution 1: To get the Mac address of your machine, you can follow the link here.

• Solution 2: If you have Ch or SIGL installed, there is another way to get Mac address of your machine.

  * For Windows

  If you have Ch installed, run the following command from an MSDOS shell. 
            C:\Ch\bin\rlmutil.exe rlmhostid -q  ether
  
  you will get the output:
            00248cbf7c1e
  
  If you have SIGL installed, run  the following command from MSDOS shell. 
           C:\silib\rlmenduser\rlmutil.exe rlmhostid -q  ether
  
  you will get the output:
            00248cbf7c1e
  
  * For Mac and Linux
  
  Run the command below from terminal
            /usr/local/ch/bin/rlmutil rlmhostid -q  ether
  
  you will get the output:
            00248cbf7c1e
  
  or run the following command if you use SIGL:
         /usr/local/silib/rlmenduser/rlmutil rlmhostid -q  ether
  
  you will get the output:
            00248cbf7c1e
  
  00248cbf7c1e is the Mac address that you need to send to us.
  
  If you have multiple mac address output from the above command, just
  keep the first one, the rest can be ignored.
  

Q: How to handle the license error after installing the license file?

1.  ERROR: installing a demo license for ch_professional v7.0.0 failed
    No "rlm_demo" license available (-139)
   

   This error means that the license file is corrupt. You may find another way to download the attached license file to copy over to the license directory.

2. ERROR: failed to find the Ch Professional home directory for checking license
   

   This error means that ch cannot find CHHOME. If it is under Linux or Mac OSX, you need to check if /usr/local/ch exists or not. Also, you need to check if environment variable for CHHOME was pre-set wrongly.

Q: Why my Ch version becomes Japanease, Chinese Edition other than English?

During the installation for Ch Professional or Ch Student Edition, the installer will try detect your locale language and makes the ChIDE becomes non-English based on your locale settings in your operating system.

You can change back to English edition by copying the file locale.properties from CHHOME\chide\doc\locale\locale.properties to CHHOME\chide, where CHHOME is the directory where Ch is installed.