Difference between revisions of "Installing MILEPOST"

From MAGEEC
Jump to: navigation, search
(Rewritten and formatted to include guide, commands and expected outputs.)
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 [http://www.example.com cTuning CC 2.5 with MILEPOST v2.1 containing the bugfixes]
  
 +
2) Unzip to the desired location, and open ''setup_env.sh''. Edit the $BASE_DIR to the current folder location for cTuning.
  
'''Solution for "Database name not found!" error:
+
3) 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 -0ml *.c''
  
on line 17, add ''export CCC_CTS_USER = [your ctuning.org username]''
+
Please see [http://mageec.org Setting up MILEPOST for first time] for how to set up MILEPOST before you can run your programs using it.
  
 +
== Running a program using MILEPOST ==
  
Now when you run ''./__test_ctuning_web_service_for_ctuning_cc.sh'' it should say
+
[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''.
  
''''Test successfully passed''''
+
[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.
  
To be finished, with a link to a zipped correct working version that is patched.
+
[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 [http://ctuning.org/wiki/index.php/Special:UserLogin cTuning.org].
  
To simplify the process we have created a version that should unzip and work without having to encounter the issue that arose for us.
+
NB:Case sensitive
  
 +
['''Required'''] You will be asked to enter your password for the account.
  
Here is the link to the final working version [http://www.example.com MILEPOST]
+
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.

Revision as of 10:36, 1 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 cTuning CC 2.5 with MILEPOST v2.1 containing the bugfixes

2) Unzip to the desired location, and open setup_env.sh. Edit the $BASE_DIR to the current folder location for cTuning.

3) 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 -0ml *.c

Please see Setting up MILEPOST for first time for how to set up MILEPOST before you can run your programs using it.

Running a program using MILEPOST

[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.