Installing Sphere - Revision history

Jhobean at 01:36, 20 August 2021

2021-08-20T01:36:23Z

RanXerox: /* Test the Installation */

2013-02-22T17:31:20Z

‎Test the Installation

RanXerox: more formatting changes

2013-02-22T17:01:38Z

more formatting changes

RanXerox: /* Installation Step-By-Step */ formatting and troubleshooting tips

2013-02-22T16:48:29Z

‎Installation Step-By-Step: formatting and troubleshooting tips

Sirius: Added languagemenue

2010-11-26T20:25:26Z

Added languagemenue

ShiryuX: /* Windows */ - Updated MySQL Library link.

2010-07-18T22:43:00Z

‎Windows: - Updated MySQL Library link.

MrSugarCube at 06:46, 4 June 2009

2009-06-04T06:46:41Z

MrSugarCube at 16:07, 3 June 2009

2009-06-03T16:07:19Z

MrSugarCube: Created page with ''''''(WIP)''''' ==Linux== ===Preface=== Installing Sphere on a Linux box is not more difficult as doing this task on a Windows PC. Either way you will have to have basic knowledg...'

2009-06-03T15:22:45Z

Created page with ''''''(WIP)''''' ==Linux== ===Preface=== Installing Sphere on a Linux box is not more difficult as doing this task on a Windows PC. Either way you will have to have basic knowledg...'

New page

'''''(WIP)'''''
==Linux==
===Preface===
Installing Sphere on a Linux box is not more difficult as doing this task on a Windows PC. Either way you will have to have basic knowledge about your operation system, and you should not rely on that you simply have to doubleclick like mad to get the beast up and running.

Even more, this tutorial will assume that you are using a shell on the linux box, and that you have root access. You do not trust your skills to type a command without mistakes, or no one will trust your knowledge enough to give you system administrator privileges on his Linux PC? Well, then - your busted. Go home, and play Solitaire on a neat little Windows box, ok?

Finally, this tutorial will NOT cover the ways to get the necessary files onto the Linux server. If you cannot figure this out yourself - read the last sentence of the paragraph before. THIS IS NOT A LESSON "Linux for Dummies"! Do your homework, and learn. There are many books about Linux' basics, even E-Books you can download free of charge. Surfing to [http://www.linux.org http://www.linux.org] will be a good point to start.

One last word about syntax: LINUX commands and filenames are case sensitive! So if later on a file cannot be found it usually is because you typed something like "sphere.INI" instead of "sphere.ini".

And in this document lines in italics are denoting what you have to type into (or read from) the shell.

===Preparations===
On the Linux box you will need a MySQL client installation. You do not need a server if you do not plan to use the database features, but Sphere will not start without the proper MySQL client libraries. Period.

You also need access to a Sphere prerelease FOR LINUX, the default script package for this version, and eventually additional libraries (libboost for recent releases).

===Installation Step-By-Step===
'''1)''' As user root, create a user named 'sphere'. Set or create it's home directory (usually /home/sphere/), give it the correct owner and permissions:

<tt>useradd -d /home/sphere sphere 
mkdir /home/sphere 
chown sphere /home/sphere 
chmod 700 /home/sphere </tt>

'''2)''' Copy the files from the Sphere LINUX package and the scriptpack into this newly created directory. Create all missing directories like "save", "logs", "accounts" as they are named in your sphere.ini and spheretables.scp. You should end up with a structure like this:

<tt>/home/sphere --- spheresvr 
              |  sphere.ini 
              |  sphereCrypt.ini 
          |-------------------- accounts/ 
          |-------------------- logs/ 
          |-------------------- muls/ 
          |-------------------- save/ 
          |-------------------- scripts/ </tt>

'''3)''' After copying all related files to their respective positions, make sure that they all have the correct permissions and ownerships. Still as root do:

<tt>cd ~sphere 
chown -R sphere * 
find . -type d | xargs chmod 0700 
find . -type f | xargs chmod 0600 
chmod 4700 spheresvr </tt>

'''4)''' Still as root do a

<tt>ldd spheresvr </tt>

the output should be something like this:

<tt>longbow:/home/sphere# ldd spheresvr 
libpthread.so.0 => /lib/libpthread.so.0 (0x4001f000) 
libmysqlclient.so.15 => /usr/lib/libmysqlclient.so.15 (0x40071000) 
libboost_regex-gcc-1_33_1.so => /usr/lib/libboost_regex-gcc-1_33_1.so (0x40243000) 
libstdc++.so.6 => /usr/lib/libstdc++.so.6 (0x402ea000) 
libm.so.6 => /lib/libm.so.6 (0x403c9000) 
libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x403ef000) 
libc.so.6 => /lib/libc.so.6 (0x403fa000) 
/lib/ld-linux.so.2 (0x40000000) 
libcrypt.so.1 => /lib/libcrypt.so.1 (0x4051c000) 
libnsl.so.1 => /lib/libnsl.so.1 (0x4054a000) 
libz.so.1 => /usr/lib/libz.so.1 (0x40561000) </tt>

LOOK FOR MISSING LIBRARIES! If something is missing, just install it. You should know how to do. If it's just libboost what is missing, you have got this with the preparations. Copy it into /usr/lib/ and type

<tt>ldconfig </tt>

===Test the Installation===
It does not matter if you start your test as user root or user sphere. Setting the permissions of the spheresvr executable to 4700 forces it to always be started as it's owner, sphere. So start it:

<tt>cd ~sphere 
./spheresvr </tt>

You will get the usual startup yaddayadda, perhaps including some warnings:

<tt>longbow:/home/sphere# ./spheresvr 
WARNING:(sphere.ini,587)'scripts/spherestatusbase.html' not found... 
ERROR:(sphere.ini,587)Can't open web page input 'spherestatusbase1.htm' 
Sphere Version 0.56b [Linux] by www.sphereserver.com, compiled at Sep 15 2006 (23:23:07) 
Signal handlers installed. 
Expansion maps supported: T2A, LBR, AOS, SE, ML 
ERROR:(spheretables.scp,59)Unable to open directory scripts/custom/ 
ERROR:(spheretables.scp,59)DirList=-1 for 'scripts/custom/' 
Allocating map sectors: 0=7168 1=7168 2=900 3=1280 4=32761 
Indexing 211 scripts... 
Loading scripts/sphere_defs.scp 
[...] </tt>

You can safely ignore warnings and errors regarding missing web pages. But if the sphere issues other errors, or terminates, dont just stare at the error number like the rabbit stares at the snake: The text immediately above the error will tell you what's wrong. So fix it.

Finally your Sphere will tell you something like:

<tt>[...] 
Loading save/spheredata... 
Loading save/spherestatics... 
Loading save/sphereworld... 
Loading save/spherechars... 
166 Objects accounted for 
Option flags: CommandSysmsgs + NoHouseMuteSpeech 
Experimental flags: DiagonalWalkCheck + ScriptsReturnStrings + NewTriggersEnable + NewPositionChecks + WalkCheck + ScriptProfiler + SizeOptimize 
Admin=me@my.email.com, URL=www.myshard.com, Lang=English, TZ=0 
Startup complete. items=0, chars=0 
Creating thread. </tt>

You are now in the sphere console and can issue the common commands (type '?' to get a list). So create an account, activate it, edit the login.cfg on your windows box with the client installation to point to the address of the Linux box, and be the first to log in.

To stop the Sphere, type 'S' in the console, then 'x'. Linux will tell you something about deinstalling handlers and shutting down. But often it will just "hang" after this, not really terminating. Clear this situation by typing CTRL-c

===Preparing for production===
Perhaps you closed your shell during the test. Then you should have noticed that the operating system killed your Sphere at the same moment. That's not a bug but wanted behaviour: Linux is a multi user os, and when a user logs out processes started by him shall not accidentally kept running.

But of course you will not be able to keep open the console all the time, at least if your Linux box can only be reached remotely, perhaps by ssh. If it's the main service running on the box, you should create a startup script what starts spheresvr in an endless loop, thus restarting it in the event it should crash. To do this, first install the 'screen' utility using the packet manager of your distribution. Then use the text editor of your choice and create a script like this:

<tt>#!/bin/sh 
cd ~sphere 
while true; do 
screen -D -m /home/sphere/spheresvr 
sleep 30 
done </tt>

This way the server will be run in a virtual window to what you always can attach with 'screen -r'. Read the manpage for screen for more information.

@@ Line 1: / Line 1: @@
 {{Languages|Installing_Sphere}}
 ==Linux==
@@ Line 159: / Line 175: @@
 Then take it to the next level!  Perhaps create an /etc/init.d/sphereserver script to start, stop, or restart the server... then softlink that script in the various /etc/rc*.d/ directories so that the sphere server automatically starts when the linux server is rebooted... maybe setup a cron job to automatically rotate and archive the log files that sphere creates.
 ==FreeBSD==

@@ Line 86: / Line 86: @@
   ldconfig
-==Troubleshooting==
+===Test the Installation===
-After starting the server, if you see errors like:
+It does not matter if you start your test as user root or user sphere. Setting the permissions of the spheresvr executable to 4700 forces it to always be started as it's owner, sphere. So start it:
-...the filesystem ACLs may be wrong, specifically the ACLs on the UO mul and uop files in the UO client directory.  There are numerous solutions, but one way to fix this is to change the permissions on these files to 644.
+  cd ~sphere
-Finally your Sphere will tell you something like:
+:55:FATAL:Segmentation fault 16:55:FATAL:Error Pri=1, Code=11, Desc='Segmentation fault', in CChar::CanMoveWalkTo() #1 "Check Valid Move"
+...the filesystem ACLs may be wrong, specifically the ACLs on the UO mul and uop files in the UO client directory.  There are numerous solutions, but one way to fix this is to change the permissions on these files to 644.
-You are now in the sphere console and can issue the common commands (type '?' to get a list). So create an account, activate it, edit the login.cfg on your windows box with the client installation to point to the address of the Linux box, and be the first to log in.
+But I digress.... Assuming no catestrophic failures, you are now in the sphere console and can issue the common commands (type '?' to get a list). So create an account, activate it, edit the login.cfg (or host details) on your windows box with the client installation to point to the address of the Linux box, and be the first to log in.
@@ Line 151: / Line 148: @@
-<tt>#!/bin/sh<br />
+ #!/bin/sh
-cd ~sphere<br />
+ cd ~sphere
-while true; do<br />
+ while true; do
-screen -D -m /home/sphere/spheresvr<br />
+ screen -D -m /home/sphere/spheresvr
-sleep 30<br />
+ sleep 30
-done<br /></tt>
+ done
 This way the server will be run in a virtual window to what you always can attach with 'screen -r'. Read the manpage for screen for more information.
 ==Windows==
 Start by downloading Sphere. See the [[Where to get Sphere]] page for download links. You should end up with two different zip files, one containing the Sphere executable and the other containing the [[Script Pack]].
@@ Line 186: / Line 186: @@
-<tt>FreeBSD freebsdvbox.fastwebnet.it 7.0-RELEASE FreeBSD 7.0-RELEASE #0: Sun Feb 24 19:59:52 UTC 2008     root@logan.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC  i386<br /></tt>
+ FreeBSD freebsdvbox.fastwebnet.it 7.0-RELEASE FreeBSD 7.0-RELEASE #0: Sun Feb 24 19:59:52 UTC 2008     root@logan.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC  i386
 With:
-<tt>Using built-in specs.<br />
+ Using built-in specs.
-Target: i386-portbld-freebsd7.0<br />
+ Target: i386-portbld-freebsd7.0<br />
-Configured with: ./..//gcc-4.1-20071105/configure --disable-nls --with-system-zlib --with-libiconv-prefix=/usr/local --program-suffix=41 --libdir=/usr/local/lib/gcc-4.1.3 --with-gxx-include-dir=/usr/local/lib/gcc-4.1.3/include/c++/ --disable-rpath --prefix=/usr/local --mandir=/usr/local/man --infodir=/usr/local/info/gcc41 i386-portbld-freebsd7.0<br />
+ Configured with: ./..//gcc-4.1-20071105/configure --disable-nls --with-system-zlib --with-libiconv-prefix=/usr/local --program-suffix=41 --libdir=/usr/local/lib/gcc-4.1.3 --with-gxx-include-dir=/usr/local/lib/gcc-4.1.3/include/c++/ --disable-rpath --prefix=/usr/local --mandir=/usr/local/man --infodir=/usr/local/info/gcc41 i386-portbld-freebsd7.0
-Thread model: posix<br />
+ Thread model: posix
-gcc version 4.1.3 20071105 (prerelease)<br /></tt>
+ gcc version 4.1.3 20071105 (prerelease)
@@ Line 201: / Line 201: @@
-<tt>libthr.so.3 => /lib/libthr.so.3 (0x281f3000)<br />
+ libthr.so.3 => /lib/libthr.so.3 (0x281f3000)
-libmysqlclient.so.15 => /usr/local/lib/mysql/libmysqlclient.so.15 (0x28206000)<br />
+ libmysqlclient.so.15 => /usr/local/lib/mysql/libmysqlclient.so.15 (0x28206000)
-libstdc++.so.6 => /usr/lib/libstdc++.so.6 (0x28265000)<br />
+ libstdc++.so.6 => /usr/lib/libstdc++.so.6 (0x28265000)
-libm.so.5 => /lib/libm.so.5 (0x2835a000)<br />
+ libm.so.5 => /lib/libm.so.5 (0x2835a000)
-libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x2836f000)<br />
+ libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x2836f000)
-libc.so.7 => /lib/libc.so.7 (0x2837a000)<br />
+ libc.so.7 => /lib/libc.so.7 (0x2837a000)
-libcrypt.so.4 => /lib/libcrypt.so.4 (0x28476000)<br />
+ libcrypt.so.4 => /lib/libcrypt.so.4 (0x28476000)
-libz.so.4 => /lib/libz.so.4 (0x2848f000)<br /></tt>
+ libz.so.4 => /lib/libz.so.4 (0x2848f000)

@@ Line 29: / Line 29: @@
-<tt>useradd -d /home/sphere sphere<br />
+ useradd -d /home/sphere sphere
-mkdir /home/sphere<br />
+ mkdir /home/sphere
-chown sphere /home/sphere<br />
+ chown sphere /home/sphere
-chmod 700 /home/sphere<br /></tt>
+ chmod 700 /home/sphere
@@ Line 38: / Line 38: @@
-<tt>/home/sphere --- spheresvr<br />
+ /home/sphere --- spheresvr
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;sphere.ini<br />
+                | sphere.ini
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;sphereCrypt.ini<br />
+                | sphereCrypt.ini
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|-------------------- accounts/<br />
+                |-------------------- accounts/
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|-------------------- logs/<br />
+                |-------------------- logs/
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|-------------------- muls/<br />
+                |-------------------- muls/
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|-------------------- save/<br />
+                |-------------------- save/
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|-------------------- scripts/<br /></tt>
+                |-------------------- scripts/
@@ Line 51: / Line 51: @@
-<tt>cd ~sphere<br />
+ cd ~sphere
-chown -R sphere *<br />
+ chown -R sphere *
-find . -type d | xargs chmod 0700<br />
+ find . -type d | xargs chmod 0700
-find . -type f | xargs chmod 0600<br />
+ find . -type f | xargs chmod 0600
-chmod 4700 spheresvr<br /></tt>
+ chmod 4700 spheresvr
-'''4)''' Still as root do a
+'''4)''' Still as root, print the shared library dependencies:
-<tt>ldd spheresvr<br /></tt>
+ ldd spheresvr
@@ Line 67: / Line 67: @@
-<tt>longbow:/home/sphere# ldd spheresvr<br />
+ longbow:/home/sphere# ldd spheresvr
-libpthread.so.0 => /lib/libpthread.so.0 (0x4001f000)<br />
+ libpthread.so.0 => /lib/libpthread.so.0 (0x4001f000)
-libmysqlclient.so.15 => /usr/lib/libmysqlclient.so.15 (0x40071000)<br />
+ libmysqlclient.so.15 => /usr/lib/libmysqlclient.so.15 (0x40071000)
-libboost_regex-gcc-1_33_1.so => /usr/lib/libboost_regex-gcc-1_33_1.so (0x40243000)<br />
+ libboost_regex-gcc-1_33_1.so => /usr/lib/libboost_regex-gcc-1_33_1.so (0x40243000)
-libstdc++.so.6 => /usr/lib/libstdc++.so.6 (0x402ea000)<br />
+ libstdc++.so.6 => /usr/lib/libstdc++.so.6 (0x402ea000)
-libm.so.6 => /lib/libm.so.6 (0x403c9000)<br />
+ libm.so.6 => /lib/libm.so.6 (0x403c9000)
-libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x403ef000)<br />
+ libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x403ef000)
-libc.so.6 => /lib/libc.so.6 (0x403fa000)<br />
+ libc.so.6 => /lib/libc.so.6 (0x403fa000)
-/lib/ld-linux.so.2 (0x40000000)<br />
+ /lib/ld-linux.so.2 (0x40000000)
-libcrypt.so.1 => /lib/libcrypt.so.1 (0x4051c000)<br />
+ libcrypt.so.1 => /lib/libcrypt.so.1 (0x4051c000)
-libnsl.so.1 => /lib/libnsl.so.1 (0x4054a000)<br />
+ libnsl.so.1 => /lib/libnsl.so.1 (0x4054a000)
-libz.so.1 => /usr/lib/libz.so.1 (0x40561000)<br /></tt>
+ libz.so.1 => /usr/lib/libz.so.1 (0x40561000)
-LOOK FOR MISSING LIBRARIES! If something is missing, just install it. You should know how to do. If it's just libboost what is missing, you have got this with the preparations. Copy it into /usr/lib/ and type
+<strong>LOOK FOR MISSING LIBRARIES!</strong> If something is missing, just install it. You should know how to do. If it's just libboost what is missing, you have got this with the preparations. Copy it into /usr/lib/ and type:
-<tt>ldconfig<br /></tt>
+ ldconfig
 ===Test the Installation===

← Older revision		Revision as of 20:25, 26 November 2010
Line 1:		Line 1:
		+	{{Languages\|Installing_Sphere}}
		+
	==Linux==		==Linux==
	===Preface===		===Preface===

@@ Line 162: / Line 162: @@
 # Copy this file three times an rename them as: spherestatics, spherechars.scp and sphereworld.scp
 # Go to the "accounts" folder that you created alongside the "save" folder, and do the same as Step 3 and 4, but name the files: "sphereacct.scp" and "sphereaccu.scp"
-# Download the [http://prerelease.sphereserver.net/files/libMySQL.dll MySQL Library] and place it into your Sphere Folder (remember: "c:\sphere").
+# Download the [http://prerelease.sphere.torfo.org/files/libMySQL.dll MySQL Library] and place it into your Sphere Folder (remember: "c:\sphere").
 # Now, [[Configuring_Sphere.ini|configure your sphere.ini]]. This is a must before running Sphere for the first time!
 # Double Click on SphereSvr.exe to launch the Console. This black window is your server console from which you can enter commands.
@@ Line 169: / Line 169: @@
 Now you can go around your map and explore some parts of it. You can use the navigation bar on the left to read various tutorials to learn how to script and learn something about Sphere. After that, read the other articles and check the [[Main_Page#Reference Compendium|reference compendium]] if you need something special.
 ==FreeBSD==

@@ Line 88: / Line 88: @@
 ===Test the Installation===
-It does not matter if you start your test as user root or user sphere. Setting the permissions of the spheresvr executable to 4700 forces it to always be started as it's owner, sphere. So start it:
+It does matter if you start your test as user ''root'' or user ''sphere''... But setting the permissions of the spheresvr executable to 4700 forces it to always be started as it's owner, and if you followed the earlier instuctions, that owner is ''sphere''. So start it like this:
@@ Line 138: / Line 138: @@
 To stop the Sphere, type 'S' in the console, then 'x'. Linux will tell you something about deinstalling handlers and shutting down. But often it will just "hang" after this, not really terminating. Clear this situation by typing CTRL-c
 ===Preparing for production===

← Older revision		Revision as of 06:46, 4 June 2009
Line 204:		Line 204:

	If you use this release, please check [http://www.sphereserver.net/index.php?showtopic=44153 this topic].		If you use this release, please check [http://www.sphereserver.net/index.php?showtopic=44153 this topic].
		+
		+	[[Category: Setting Up Sphere]]