Install Guide for TinyMUX Codebase

Description
 
This guide provides instructions for installing and configuring the latest TinyMUX codebase on a server supported by Third Generation.  Directions for both the recommended 64-bit installation and the optional 32-bit installation are documented within.  Further documentation on the advanced configuration and maintaining of the codebase is available through the resources provided below.
 
Resources
 
1. TinyMUX Home Page – http://www.tinymux.org/ 
2. TinyMUX Source Download - ftp://ftp.tinymux.org/
3. TinyMUX Install Documentation – http://www.tinymux.org/install.txt 
4. TinyMUX Database Conversion - http://www.tinymux.org/conversion.txt 
5. TinyMUX Wiki Support Page – http://wiki.tinymux.org/index.php/TinyMUX
 
Installation (64-bit install – Recommended for new installs)
 
It is recommended to use the native 64-bit software libraries of the operating system when installing and configuring the latest release of the TinyMUX codebase.  The following commands should be executed from the terminal of your shell account.
 
I.    Downloading and compiling the latest version of the TinyMUX source code.
 
1. Login to your shell account with an SSH client and type the following:
2. curl -O ftp://ftp.tinymux.org/tinymux-2.10/14/mux-2.10.1.14.unix.tar.gz
3. tar -zxf mux-2.10.1.14.unix.tar.gz
4. cd mux2.10/src
5. ./configure
6. make depend
7. make
 
II.   TinyMUX basic configuration
 
1. cd ../game
2. nano netmux.conf
3. >>> Update your “port” config option with your account’s registered game port.
4. >>> Update the “mud_name” config option with your game’s name.
5. >>> CTRL+X and save the configuration file.
 
III.   Starting TinyMUX
 
1. cd ~/mux2.10/game
2. ./Startmux
 
When starting your game for the first time, TinyMUX will automatically build a new minimal game database.  Once the game’s database has been initialized, you may access your game’s login screen by telneting to your game’s address and port number.  To login to the game’s default Wizard account, type: “connect wizard potrzebie”.  Proceed to log in to your game with the default wizard account, change the wizard account’s password (@password) and then shutdown the running game to save the database (@shutdown).  Once the game has been shutdown and the database has been saved, you may restart the game by repeating Step III.
 
Installation (32-bit install)
 
The following documentation provides instructions for compiling an existing TinyMUX codebase with optional 32-bit library support.  The compiling of TinyMUX with 32-bit legacy libraries may be required if your game’s database, release version or extensions do not support newer 64-bit software libraries.  In the scenario where transferring your database from another provider or a server with a different CPU architecture, it may be necessary to first compile your source with 32-bit support and then perform the instructions below for a database convert prior to upgrading to 64-bit.  It is recommended to compile new TinyMUX instances with 64-bit library support when possible.  The following commands should be directly executed from the terminal of your shell account.
 
I.    Compiling an existing TinyMUX codebase with 32-bit library support.
 
1. Login to your shell account with an SSH client and type the following:
2. cd ~/mux2.10/src
3. make clean
4. make realclean
5. ./configure --build=i686-pc-linux-gnu "CFLAGS=-m32" "CXXFLAGS=-m32" "LDFLAGS=-m32"
6. replace 'gcc' 'gcc -m32' – Makefile
7. replace 'g++' 'g++ -m32' – Makefile
8. make depend
9. make
 
II.   TinyMUX basic configuration
 
1. cd ../game
2. nano netmux.conf
3. >>> Update your “port” config option with your account’s registered game port.
4. >>> Update the “mud_name” config option with your game’s name.
5. >>> CTRL+X and save the configuration file.
 
III.   Starting TinyMUX
 
1. cd ~/mux2.10/game
2. ./Startmux
 
Database Conversion
 
When transferring an existing TinyMUX database between servers of different operating systems or CPU architectures, it may be necessary to perform a database conversion.  Database conversions can be used to backup your database to a data flat file and can be useful when relocating your database to a new server or when upgrading your codebase to a new architecture, such as Intel 64-bit.
 
Database conversions should follow the developer’s recommendations - http://www.tinymux.org/conversion.txt
 
The following is an example of how to convert a TinyMUX database.
 
1.  >>> Shutdown the running game on the original server. (@Shutdown)
2.  >>> Perform a database dump on the original server.
3.  cd ~/mux2.10/game/data
4.  ./db_unload netmux netmux.db.new netmux.flat
5.  >>> Transfer your codebase to your new server. (SFTP, FTP, cPanel, etc.)
6.  >>> Perform a database import on the new server.
7.  cd ~/mux2.10/game/data
8.  mkdir archive
9.  mv netmux.db* archive/
10. mv netmux.dir archive/
11. mv netmux.pag archive/
12. ./db_load netmux netmux.flat netmux.db
13. >>> Start your game and review logs to verify no errors on database read.
  • TinyMUX
  • 5 Users Found This Useful
Was this answer helpful?

Related Articles

How to terminate a running process

This article describes how to terminate a running or non-responsive process under your shell...

Where can I find a codebase for my MUD or MUSH?

There are several freely distributed and open-source projects available that provide stable...

How to configure the Screen application

How to configure and run the application Screen in your shell account.Note: This environment...

Install Guide for Evennia Codebase

This guide provides instructions for installing the Evennia codebase for first time use with our...

Install Guide for PennMUSH Codebase

Description   This guide provides instructions for installing and configuring the latest...