1st Time_Linux Install
Date: 06 8, 2001 3:37:23 PM

# 1st Time Linux Install output

Installing Admin Mod on a Linux system is just as easy as installing on a Win32 platform. After unzipping the tarball run the `install_admin` shell script. You can provide the MOD you want to install Admin Mod for as an argument to the installer by using the MOD directory name:

    ./install_admin cstrike

This would install Admin Mod for Counter-Strike. If you leave out the MOD and call the installer without arguments, it will present you with a list of your installed MODs to choose from.

The installation of Admin Mod with the `install_admin` script is pretty self-explanatory. Below we show some steps the installer takes when installing Admin Mod on a machine that does not have Admin Mod installed on it yet. This content is provided for reference. We will assume that if you have successfully installed hlds_l on a Linux machine, you don't need to have your hand held. :)

## install_admin Walkthrough

The installer will first try to locate the tools that it needs to do it's work. If some of the required tools cannot be found it will exit since it cannot complete the installation. Normally that should not happen since it uses only tools that every standard Linux installation should have installed like 'sed', 'grep' or 'cp'. After the setup it will greet you with a welcome screen.

    Setting up installation... ok

                   Admin Mod Installation Script
                           Version 2.50.60

       This script will install Admin Mod version 2.50.60 on your
       system. It will ask you for the directory that you installed
       the Half-Life server in. To accept defaults just press Return.
       After the binaries are installed you should read the docu-
       mentation and configure Admin Mod before you use it for the
       first time.

    Shall I proceed with the installation? (y/n) [y]

This is your chance to quit the installer if you invoked it unintentionally. When the installer prompts you for input it will normally show you some possible inputs like 'y' for yes, 'n' for no or 'q' for quit. It will usually provide a default (shown in brackets, e.g. '[y]') which you can accept by simply hitting the Return key.
When you choose to continue the installer will try to locate your HLDS installation.

    Trying to locate your HLDS... done

    Please enter the directory where your HL server is installed,
    or hit Return to accept the default.
    [/usr/local/games/hlds_l]:

If it found a version of the HLDS on your system it will present you with a default location. If that is the HLDS you want to install Admin Mod for you can accept the default. Otherwise enter the path to the HLDS installation you want Admin Mod installed for.

If you did not provide the MOD you want to install Admin Mod for on the commandline, the installer will search for your installed MODs and give you a list to choose from. If your MOD is not listed, quit the installer and call it again with the MOD directory as an argument.

    You seem to have the following MODs installed:
            MOD             Description
    ----------------------------------------------
      [1]:  cstrike         Counter-Strike
      [2]:  dmc             Deathmatch Classic
      [3]:  dod             Day of Defeat
      [4]:  ricochet        Ricochet
      [5]:  si              Science and Industry
      [6]:  tfc             Team Fortress
      [7]:  valve           Half-Life

    Please choose the number of the MOD you
    want to install Admin Mod for (q to quit): 5

Choose the MOD to install Admin Mod for. In this example we chose "Science and Industry" by entering '5' at the prompt. The installer will check if it can find the MOD installation and present you with another prompt:

    Looks like you have Science and Industry installed in
    /usr/local/games/hlds_l/si.
    I can now install the Admin Mod files. Proceed? (y/n) [y]

This is your last chance to chicken out. If you answer 'y' here the installer will continue and install the Metamod and Admin Mod files into the MOD directory.

    Installing Metamod binaries to si/addons/metamod ... done.

    Updating your liblist.game file ... done.

    Installing Admin Mod files to si/addons/adminmod ... done.

    Updating your Metamod plugins file ... done.

After the files have been installed, and Metamod and Admin Mod have been configured to be loaded the next time you start the server, one more thing is left. To set the configuration variables (cvars) for Admin Mod the file containing the cvars has to be read by the server upon startup.
This is achived by having the server "exec" the adminmod.cfg file from the server.cfg file. An entry in the server.cfg file is required for this. The installer can make this entry for you. Since you do a fresh install of Admin Mod it is usually a good idea to let the installer add the line to your server.cfg file.

    The Admin Mod files have now been installed. It looks like you install this
    version of Admin Mod for the first time. You will have to edit your
    adminmod.cfg file in the directory
    /usr/local/games/hlds_l/si/addons/adminmod/config
    to configure Admin Mod for your server. Then add this line to the bottom of your
    /usr/local/games/hlds_l/si/server.cfg file:

    exec addons/adminmod/config/adminmod.cfg.

    I have copied an adminmod.cfg file with default settings to your
    /usr/local/games/hlds_l/si/addons/adminmod/config
    directory and can now add the necessary line to your server.cfg file.
    Edit the adminmod.cfg file afterwards to configure it to your needs.

    Shall I add the line to your server.cfg file? (y/n) [y]

The installer is now done installing Admin Mod.

    Congratulations, Admin Mod is now installed.
    To configure it you should now edit your adminmod.cfg file and create
    users.ini, maps.ini, ips.ini, models.ini and wordlist files as needed.
    Follow the instructions in the documentation and check for more infor-
    mation at the Admin Mod website http://www.adminmod.org.

    Enjoy!

Be sure to edit the adminmod.cfg file to set the correct values for your setup. See the section on configuring Admin Mod to learn how to customize Admin Mod for your server.