Tutorials..

The Linux iP Server.

This tutorial will be written targeted to a home linux user with some additional info for hosts tossed in.
It is assumed Linux hosts can wade through the non relevant portions.

To run the Linux iP server you want to open a terminal window and type ./iplinserver and hit enter:

This will bring up the Copyright screen and ask you if you want to set up the server.

The first thing you will do is enter a name for your server.

It is a very good idea not to use any special characters in the name.

Then you will enter the domain or IP address of the server.

You will then specify two ports for the server to use.

(For a hosted server where the host uses an external web server (not the builtin one) enter 80 for the media port.)

You can specify an external BASE URL for the media server here. Home users will likely not do so.

(Hosts who use an external web server for the media should point it to the smedia subfolder of the ipserver.)

If the server is on a host, the host would enter Y for yes its hosted.

This prevents the iP client's builtin server setup editor from changing ports etc.
Home users should enter N.

Hosts can also specify an IP address to bind the iP server's internal servers to.
Home users should leave this blank.

Once all of these steps are completed, the server will save the newly entered settings and proceed.

The server will now ask if you want to create users, tell it Y

You can then enter 1 or more staff users. In the format username/password/accesslevel.
Hit enter on a blank line to stop entering users.

Example:

Here the username is "Dan", the password is "8675309", and the accesslevel is "255", which corresponds to an Owner.
Each user may have their own username, password and accesslevel (which determines what kind of staff they are).

In this example below I have created 3 users, Dan, Phill and Ammy. Note that usernames and passwords are case sensitive.

When you have finished entering users and hit enter on an empty line, the server will stop running.

To run the iP server "normally" you would add a Users=## to its paramaters.
Example:
Users=100 means allow 100 users on the server.
Home users can set this to anything they wish.
Hosts will likely use it to limit users according to the number of allowed users on the plan the server owner purchased.

To see if your iP server is running type PS UX and hit enter.

Older versions of Linux appear to list every fork in the runnign program so you may see multiple items for your iP server.
This doesn't happen on newer versions of Linux, I see only one for example on SUSE 9.2, the iP server's main process.

There are 3 ways to shut your iP server down:

1 - Type 'shutdown inside the iP client while connected to it and empowered.
2 - Create the file shutdown.txt in the iP server's folder. It will shut itself down and delete shutdown.txt.
3 - Kill it based on its process id, or PID. Which is shown in the output from the PS UX command.


In our example above the PID is 2005

To kill it we would type KILL 2005 and hit enter.

The iP server uses very few resources, when it starts the CPU% will peek as it validates the room media in the room definitions,
and ensures that room props are in the cache, then after a few minutes it will be down to almost 0. Likewise it uses little RAM.