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. Due to frequent developer updates, newer versions of the source code may be currently available at the TinyMUX FTP site. The commands below provide an example on configuring your codebase with what was the current version at the time of writing. Newer versions will require substitution of the proper version numbers.
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. scl enable devtoolset-9 bash
2. curl -O ftp://ftp.tinymux.org/tinymux-2.12/10/mux-2.12.0.10.unix.tar.gz
3. tar -zxf mux-2.12.0.10.unix.tar.gz
4. cd mux2.12/src
5. ./configure
6. sed -i 's/-L\/usr\/lib\/mysql/-L\/usr\/lib64/' Makefile
7. sed -i 's/-L\/usr\/lib\/mysql/-L\/usr\/lib64/' modules/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
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.
