Dependencies
From OpenSimulator
(moved windows security issues into Dependencies) |
(→Windows: added windows firewall configuration) |
||
| Line 17: | Line 17: | ||
NOTE: Windows Versions prior to XP such as NT, 2000 are not supported. NET Framework 4.0 not officially supported by OpenSim yet. | NOTE: Windows Versions prior to XP such as NT, 2000 are not supported. NET Framework 4.0 not officially supported by OpenSim yet. | ||
| + | |||
| + | |||
| + | '''''Windows Firewall''''' | ||
| + | |||
| + | On Server 2008 or Windows 7, you'll need to configure the "Windows Firewall with Advanced Security" to enable access from the viewers on another machines. | ||
| + | |||
| + | Click Start and then click Control Panel. In the Control Panel, click System and Security and then click Administrative Tools. In Administrative Tools, double-click Windows Firewall with Advanced Security. Or you can even direct access by typing "WF.msc" in the Run textbox in the start menu. | ||
| + | |||
| + | In the Windows Firewall with Advanced Security, in the left pane, right-click Inbound Rules. Right click on "opensim.exe" entry. From the context menu that appears select Properties. Then, on the General tab, under Action, select the "Allow the connections" option and click OK. | ||
| + | |||
'''''Windows Vista''''' | '''''Windows Vista''''' | ||
| Line 41: | Line 51: | ||
Finally, select "OK" and exit the McAfee SecurityCenter window. | Finally, select "OK" and exit the McAfee SecurityCenter window. | ||
| − | |||
= Linux = | = Linux = | ||
Revision as of 05:02, 10 May 2011
In addition to the OpenSim code itself, certain other packages need to be installed on different platforms in order to get OpenSim binaries to run.
As well as the information on this page (which should be expanded), you may find more information on dependencies in Build Instructions though this will also contain dependencies required only for building. This are also more hints in Troubleshooting
Windows
When using OpenSim on Windows XP ensure it is updated to at least Service Pack 2 (SP2).
When using OpenSim on Windows XP, VISTA, Win-7, Server 2003 & 2008, You need to have the newest version of the .NET Framework 3.5 sp1 (3.51), available from Microsoft Download Centre: www.microsoft.com/downloads/details.aspx [[|]]
32-Bit Operating System: Start/Run OpenSim.exe
64-Bit Operating System: Start/Run OpenSim.32BitLaunch.exe
Depending on your installation, you may have to run the program as administrator. (right click run as a administrator)
NOTE: Windows Versions prior to XP such as NT, 2000 are not supported. NET Framework 4.0 not officially supported by OpenSim yet.
Windows Firewall
On Server 2008 or Windows 7, you'll need to configure the "Windows Firewall with Advanced Security" to enable access from the viewers on another machines.
Click Start and then click Control Panel. In the Control Panel, click System and Security and then click Administrative Tools. In Administrative Tools, double-click Windows Firewall with Advanced Security. Or you can even direct access by typing "WF.msc" in the Run textbox in the start menu.
In the Windows Firewall with Advanced Security, in the left pane, right-click Inbound Rules. Right click on "opensim.exe" entry. From the context menu that appears select Properties. Then, on the General tab, under Action, select the "Allow the connections" option and click OK.
Windows Vista
Some people have reported that to run on Windows Vista, you must first disable Windows Firewall. Under the new "Start" button of Vista, select "Control panel". Then double-click "Windows Firewall". In the window that pops up, on the left column, select "Turn Windows Firewall on or off". You will have to give permission for this to run, then select the option "Off (not recommended)". Click "OK" and exit from the Windows Firewall window.
If you have McAfee SecurityCenter, see the description below.
Once all the security features are disabled, right click on OpenSim.exe and select "Run as administrator". This will pop up a window asking permission, select "Allow". Your OpenSim server should run in a DOS-like window and accept connections.
McAfee Security
McAfee Security does not allow applications to listen on ports not explicitly specified. You have two options: 1) disable firewall protection all together, 2) enable OpenSim.exe to be able to open ports.
Disable firewall
Open McAfee SecurityCenter. Select "Internet & Network". In the lower left corner is a small link to "Configure...". Select this. In the right side of the window, select the bar that says "Firewall protection is enabled". Here you can select "Off".
Enable OpenSim.exe to open ports
Open McAfee SecurityCenter. Select "Internet & Network". In the lower left corner is a small link to "Configure...". Select this. In the right side of the window, select the bar that says "Firewall protection is enabled". Select the "Advanced..." button. This will pop up a new window.
In the new window, on the left side, select "Program Permissions." In the middle on the right side of the window, select the "Add Allowed Program" button. Use the browser that pops up to find the OpenSim executable and select it.
Finally, select "OK" and exit the McAfee SecurityCenter window.
Linux
OpenSimulator requires Mono 2.4.3 or later.
Ubuntu
sudo apt-get install nant mono-gmcs libmono-microsoft8.0-cil \
libmono-system-runtime2.0-cil libgdiplus libmono-i18n2.0-cil libmono-oracle2.0-cil
Nant is required if you need to build OpenSim.
RHEL, Fedora, CentOS or Any Other RedHat-based Distributions
First, run "yum info mono-core" to see the version of the mono packages in the core repository for your distribution. If it shows 2.4.3 or later, proceed to #Installing from Core Repository. If not, skip to #Installing from Mono Repository. Note that the current version you can get from yum repository for some distributions is lower than requirement (ex. 1.2.4 on CentOS). Unlike Ubuntu, RedHat-based distributions should be always conservative, therefore it is natural that they don't so often update their repository. What you can do to manage this problem is to add an extra repository for mono.
Installing from Core Repository
Just type:
sudo yum install mono-core mono-data-sqlite mono-extras libgdiplus
It will also install dependent modules. After that you can launch OpenSim.exe with mono out-of-the-box.
Installing from Mono Repository
This procedure is tested on CentOS 5.5 & 5.6 box with OpenSim 0.7.1.
Go to yum config file folder and create new one for mono.
cd /etc/yum.repos.d sudo vi mono.repo
And then in mono.repo :
[mono] name = novell-mono baseurl=http://ftp.novell.com/pub/mono/download-stable/RHEL_5/ enabled=1 gpgcheck=0
Now, you can yum install the later version of mono from this repository. Additional note that make sure all of mono packages are i386(not IA64 build). If your box is 32bit, don't care and you can even install properly without ".i386" suffix.
sudo yum install mono-addon-core.i386 mono-addon-data.i386 mono-addon-data-sqlite.i386 \
mono-addon-extras.i386 mono-addon-web.i386 mono-addon-winforms.i386 mono-addon-libgdiplus0.i386
Yum will install mono into /opt/novell/mono, so you can create a symbolic link to /usr/bin :
sudo ln -s /opt/novell/mono/bin/mono /usr/bin/mono
After that, you should be able to launch OpenSim.exe without any errors.
Mac OS X
All you have to do is to fetch Mono Runtime package from Mono Download Page and install it.
Locales and Regional Settings
OpenSimulator will only work properly when you run it with an English locale or regional setting. With other settings than English, you are likely to see a variety of issues, ranging from misbehaving scripts to crashes.
Linux
In Linux, you can easily use the standard "C" locale just for running OpenSim.exe, as explained in Troubleshooting#ScriptEngine Issues:
env LANG=C mono OpenSim.exe
For information about changing your locale in a more general way, see Troubleshooting#Locales Issues
Windows
If you are not using an English regional setting in Windows by default, then there is not a solution as easy as for Linux, unfortunately. I did it with an additional user account that I created just for OpenSim in which I set the regional setting to "English (US)". I run OpenSim.exe from my normal user account with "Run as..." (or check "Run with different credentials" in a shortcut's advanced properties) and specify the OpenSim account as the one to be used.
Additional Resources
OSGrid Technical Support Forum with many installation tutorials: osgrid.org/forums/viewforum.php
MONO Project: www.mono-project.com/Main_Page
