%META:TOPICPARENT{name="ApplyingLicenseFiles"}%
---+ Apply License Files to Multi-Tier Release 1.x through 3.x, on Unix

   1 Navigate to the root directory of your <nop>OpenLink installation, where you find <code>openlink.sh</code> and <code>openlink.csh</code>.
   1 Set the <nop>OpenLink environment by running the appropriate script for your shell.  The following will work in most environments, but your required command may differ --
| *shell* | *command* |
| <code>sh, bash, zsh</code> and related | <code><nowiki>. ./openlink.sh</nowiki></code> |
| <code>ksh</code> and related | <code><nowiki>source ./openlink.sh</nowiki></code> |
| <code>csh, tcsh</code> and related | <code><nowiki>source ./openlink.csh</nowiki></code> |
   1 Execute these commands, to stop the OpenLink Request Broker: 
<verbatim>
cd bin
./oplshut -fy
</verbatim>
   1 Retrieve your new <nop>OpenLink license file from your email or [[ODSBriefcaseLicenseStorage][ODS briefcase]], to the <code>.../openlink/bin/</code> directory you're in.  Use binary-preserving methods to transfer the file (e.g., FTP only in BIN mode).
   1 Rename any existing <code>register.ini</code> to <code>register.ini.old</code> or similar, and rename your new license file to <code>register.ini</code>. For example:
<verbatim>
mv register.ini register.ini.old
mv 5641.ini register.ini
</verbatim>
   1 Execute these commands to activate the new license, and restart the Broker.  If you normally use a different command to start the Broker, also use that command here.
<verbatim>
./register
./oplrqb
</verbatim>