Installation

Rosetta is software from the Baker laboratory at the University of Washington https://www.rosettacommons.org. Rosetta is used by a number of modules in Phenix

• phenix.erraser
• phenix.mr_rosetta
• phenix.simple_homology_model.
• phenix.rosetta_refine

phenix.rosetta_refine requires a compilation of Rosetta from source as it requires some programs for the interface between Phenix and Rosetta that are not in the binary distribution. The first three programs will run with a binary installation of Rosetta (or the compiled installation of Rosetta). From a practical point-of-view, making the effort to install the compiled version of Rosetta means that you can run all phenix Rosetta dependent programs.

Once you have installed Rosetta you need to set the environmental variable $PHENIX_ROSETTA_PATH.

Installation - Using standard Phenix installation

Proceed with the following.

• Go to https://c4c.uwc4c.com/express_license_technologies/rosetta, find "Academic License" and click on "LICENSE". Fill out the form, and receive by email a link to the download site and a login/password.
• You will need Rosetta version 3.7 specifically 2016.32.58837. It is quicker to download the source bundle. The binaries are not required when installing for ALL programs.
• Make the directory where you want to install Rosetta (if it does not already exist). Move the downloaded file (something like rosetta_src_2016.35.xxxxx_bundle.tgz) there. Then unpack the bundle...

% tar xzf rosetta_src_20??.??.?????_bundle.tgz (changing the names to
  match your bundle)

• You should have a directory like rosetta_src_2016.35.xxxxx_bundle that contains:

demos   main    tools

• The directory containing "main demo tools" is to be called "PHENIX_ROSETTA_PATH". Now you can now set a local environmental variable in your ".profile" (sh or bash shell) or ".cshrc" (c-shell) to mark where rosetta is located: if you are using the bash or sh shells:

%  export PHENIX_ROSETTA_PATH=/your-path-to-rosetta-here/

or sh (C-shell):

%  setenv PHENIX_ROSETTA_PATH /your-path-to-rosetta-here/

• The final step is to build the interface for rosetta_refine. This is a similar step to the previous scons step so supply as many nproc as available on your machine.

% rosetta.build_phenix_interface nproc=2

You should now be completely ready to go with Rosetta in Phenix that can be tested using

% rosetta.run_tests

Installation - Using the latest Rosetta version and Phenix source

To use the latest Rosetta version, Phenix needs to be compiled from source using a compiler that is c++11 compatible. To compile,

% cd <phenix-installer-1.12-2829-source directory>
% ./install --prefix=<installation location>

• You may also need zlib1g-dev and scons (e.g. Ubuntu). You can get this library and scons with

% sudo apt-get install zlib1g-dev
% sudo apt-get install scons

• Now you want to compile. Follow the instructions in main/source/readme.txt. Note that the default compilation is mode=debug, which builds executables 10x slower than mode=release executables. Set the number of processors to speed up the compilation.

% cd main/source
% scons bin mode=release -j4

• Troubleshooting

• See FULL INSTRUCTIONS at https://www.rosettacommons.org/support
• Build may also be called with ./scons.py bin mode=release -j4
• Build may fail because it is unable to find the g++ requested by build. This can be fixed in two ways
  1. If you have the correct version of g++ installed, but it is not called by the name expected by the build, simply set a soft link from g++ to e.g. g++-4.6
  2. See: http://morganbye.net/blog/2011/05/rosetta-32-ubuntu-1104 for how to edit to tools/build/basic.settings and tools/build/options.settings and using "scons bin mode=release cxx=gcc cxx_ver=4.5"
• Build may fail due to shallow warnings. Edit tools/build/basic.settings to comment out all "warn" flags for your operating system.

Proxy Server Setup

To use the fragment server and your machine is behind a firewall and there is a proxy server you need to go through, then if you use a .hhr file to download files from the PDB then you will need to specify your proxy server. You can use the following command to specify the proxy server (replacing it with YOUR proxy server).

If you are using the bash or sh shells:

% export HTTP_PROXY=proxyout.mydomain.edu:8080

or sh (C-shell):

% setenv HTTP_PROXY proxyout.mydomain.edu:8080