Difference between revisions of "Installing MILEPOST"

From MAGEEC
Jump to: navigation, search
(Added final dropbox link)
 
(14 intermediate revisions by 2 users not shown)
Line 1: Line 1:
=='''Guide to installing MILEPOST on Linux'''==
+
=='''Simple guide to installing MILEPOST on Linux'''==
  
 +
There were several issues getting MILEPOST to install correctly and run, so we have created a custom tar containing the correct changes and fixes to environment variables.
  
== Install issues ==
+
1) Download this version of [https://www.dropbox.com/s/pv8mld3gpcsvcv9/working-ctuning.tar.gz MILEPOST v2.5 with GCC 4.4.4 containing the bugfixes]. It's pre-built for 64 bit linux, so you may need to build MILEPOST yourself instead ([[Building MILEPOST]]).
  
 +
2) Untar to the desired location, and open ''setup_env.sh'' (Available [https://raw.github.com/mageec/wiki_files/master/setup_env.sh here] if you built MILEPOST yourself). Edit the $BASE_DIR to the current folder location for cTuning.
  
'''Solution for "Database name not found!" error:
+
== Running a program using MILEPOST ==
'''
+
Now to run on your own .c files, open terminal in the folder for the file to be run, and run the following command with the correct folder location:
Navigate to /demo/bitcount.c/___common_environment.sh
 
  
and edit line 15 from ''export CCC_CTS_DB=cod_opt_cases'' to ''export CCC_CTS_DB = fursinne_coptcasestest''
+
''/path/to/cTuning/setup_env.sh ctuning-cc -Oml *.c''
  
on line 17, add ''export CCC_CTS_USER = [your ctuning.org username]''
+
For further information on how to run the other features type ''ctuning-cc --help''
  
 +
Please check you have the PATH variable set up correctly with ''echo $PATH'' and looking for ''path/to/ctuning/install/bin/''. If this is not listed, please add it to the PATH variable to solve any environmental issues.
  
Now when you run ''./__test_ctuning_web_service_for_ctuning_cc.sh'' it should say
+
During the running of setup_env.sh you will be asked some questions. They are as follows:
  
''''Test successfully passed''''
+
[Optional] You will now be asked if you want to change the SORT order, select ''y'' if so and enter the order, otherwise skip with ''n''.
  
To be finished, with a link to a zipped correct working version that is patched.
+
[Optional] If there is no ''_ctuning_select_functions.txt'' file that you have specified in the directory the program runs in, then you will be asked to either specify a file, or skip.
  
 +
[Optional] If there is no ''_ctuning_remove_opt_flags.txt'' then you will be asked if you want to specify a location of this list, or you can skip again.
  
To simplify the process we have created a version that should unzip and work without having to encounter the issue that arose for us.
+
['''Required'''] You will be asked to enter your cTuning.org username. This is the one you have signed up for at [http://ctuning.org/wiki/index.php/Special:UserLogin cTuning.org].
  
 +
NB:Case sensitive
  
Here is the link to the final working version [http://www.example.com MILEPOST]
+
['''Required'''] You will be asked to enter your password for the account.
 +
 
 +
MILEPOST should now successfully run and find the best predicted optimisation flags using the COD at cTuning.org and invoke these on your chosen .c program.
 +
 
 +
NB:This is set up to use the ''fursinne_coptcasestest'' database, which will need to be changed if you intend on using a different one from cTuning. This can be changed in ''setup_env.sh'' on line 99, to the desired database.
 +
 
 +
=='''Related Pages'''==
 +
[[Building MILEPOST]]

Latest revision as of 10:35, 2 July 2013

Simple guide to installing MILEPOST on Linux

There were several issues getting MILEPOST to install correctly and run, so we have created a custom tar containing the correct changes and fixes to environment variables.

1) Download this version of MILEPOST v2.5 with GCC 4.4.4 containing the bugfixes. It's pre-built for 64 bit linux, so you may need to build MILEPOST yourself instead (Building MILEPOST).

2) Untar to the desired location, and open setup_env.sh (Available here if you built MILEPOST yourself). Edit the $BASE_DIR to the current folder location for cTuning.

Running a program using MILEPOST

Now to run on your own .c files, open terminal in the folder for the file to be run, and run the following command with the correct folder location:

/path/to/cTuning/setup_env.sh ctuning-cc -Oml *.c

For further information on how to run the other features type ctuning-cc --help

Please check you have the PATH variable set up correctly with echo $PATH and looking for path/to/ctuning/install/bin/. If this is not listed, please add it to the PATH variable to solve any environmental issues.

During the running of setup_env.sh you will be asked some questions. They are as follows:

[Optional] You will now be asked if you want to change the SORT order, select y if so and enter the order, otherwise skip with n.

[Optional] If there is no _ctuning_select_functions.txt file that you have specified in the directory the program runs in, then you will be asked to either specify a file, or skip.

[Optional] If there is no _ctuning_remove_opt_flags.txt then you will be asked if you want to specify a location of this list, or you can skip again.

[Required] You will be asked to enter your cTuning.org username. This is the one you have signed up for at cTuning.org.

NB:Case sensitive

[Required] You will be asked to enter your password for the account.

MILEPOST should now successfully run and find the best predicted optimisation flags using the COD at cTuning.org and invoke these on your chosen .c program.

NB:This is set up to use the fursinne_coptcasestest database, which will need to be changed if you intend on using a different one from cTuning. This can be changed in setup_env.sh on line 99, to the desired database.

Related Pages

Building MILEPOST