Install Manual: FMYiRC V1.20 MDV2007.1
From FMYiRCWiki
Freemed-YiRC V1.20 MDV2007.1 Installation Manual
NOTE: This document mostly has not changed since V1.00. Over time, it may be tweaked to include V1.20 idiosyncrasies.
Contents |
Summary
This document details how to get Freemed-YiRC V1.20 up and running on a server from scratch, including operating system install/configuration. This requires the Mandriva Linux 2007.1 install CDs/DVD as well as the FMYiRC MDV2007.1 Helper CD (CD from .iso, or .tar.gz file).
Operating System (Mandriva 2007.1) Install
During the initial Operating System installation, please follow these steps to help ensure the FMYiRC install goes as smoothly as possible!
INSTALL/UPGRADE - If you are asked whether to perform an install or upgrade, please choose install.
SECURITY - Security Level should be set to High. Leave the Security Administrator field blank unless you have a reason to fill it.
PARTITIONING -
- Use Custom Disk Partitioning.
- Create THREE Partitions:
- 1: Root partition (/ - ext3)
- AT LEAST 20GB (20000) in size
- 2: Swap partition.
- AT LEAST 1GB (1000) in size
- 3: Home partition. (/home - ext3)
- Use the rest of the hard drive, unless you need to reserve space for other purposes.
- How much space you will really need will vary wildly. Most Freemed-YiRC data is textual in nature, which is typically smaller in size, as opposed to large binary files. However, Freemed-YiRC does have the capability for uploading binary files into it for storage. These files can add up very quickly. Most of this discussion is probably moot due to hard drives continuing to fall in price while rising in size. However, it is recommended that you have AT LEAST 40GB for your home partition. A recommended minimum may be around 100GB for those agencies wishing to use file uploads.
- 1: Root partition (/ - ext3)
- FORMAT ALL PARTITIONS (if asked)
COPY WHOLE CDs - Check this option. Having these files available may be very handy later.
PACKAGES - Select all package groups except for LSB.
SERVICES - When it asks Do you really want to install these servers? chose Yes.
NOW YOU WAIT - The installer will now install the requested packages. Depending on how you are installing, this can take as little as 15 minutes, or more than an hour...
AUTHENTICATION - Please enter your root users password. This is the administrative user. Please enter a good password with both letters and numbers!!!
ADD USER - It will require that you create a 2nd user (other than root)
- Create a user named fmyirc (Real Name & User Name)
- Set the password to something other than the root password!
- After you hit Accept User it will ask you to enter another one. You do not need to do this, instead, click on next.
LILO/GRUB BOOTLOADER - Put bootloader into First sector of drive (MBR)
SUMMARY - Configuration of hardware in Linux is beyond the scope of this document. However...
- If you don't know anything about how to configure networking in Linux, then this may be the best place to do so. Go down to the Network & Internet section and hit Configure next to Network. Select Ethernet (unless you need a different connection), and hit Next. Continue on setting up the network.
- Hit the Next button in the Summary menu unless you know what you are doing here.
- NOTE: FMYiRC does not require the use of a GUI (Graphical User Interface) in Linux, so video drivers are not of huge importance here. All FMYiRC maintenance can be done either from a web browser or on the server directly via the command-line (or SSH).
- NOTE: FMYiRC does not require sound drivers to be working on the server for any reason.
- NOTE: FMYiRC does, however, require solid and stable networking hardware which is well supported by Linux! This is VERY important!
UPDATES - DO NOT ALLOW INSTALL TO DO UPDATES!
- While normally updates would be a good thing, this may complicate your FMYiRC installation by causing unexpected circumstances. If you wish to update your system, please do so AFTER following through with the COMPLETE FMYiRC installation!!!
CONGRATULATIONS - When you see this screen, the DVD or CD tray should pop out (if you're installing from a DVD or CD). Please remove the DVD or CD and hit the Reboot button. Congratulations, you have installed Mandriva Linux 2007.1!!!
Post Operating System Install (Automated)
- After installing the operating system, please make sure you reboot the system.
- The system will boot up into Mandriva Linux 2007.1. The very first time you boot after installation it will come up to a First Boot Wizard screen. You do not have to do this.
- Please press CTRL-ALT-F2 to enter text mode.
- Log in using the root user and root password you specified during the operating system install.
Install using MDV2007.1 Helper CD (creating using .iso file):
- Place the FMYiRC MDV2007.1 Helper CD in the CD/DVD drive.
- From the command prompt, issue the following commands:
mount /media/cdrom cd /media/cdrom ./install.sh
Install using MDV2007.1 Helper CD .tar.gz file:
- Place the MDV2007.1 Helper CD file (fmyirc-mdv20071setup_*.tar.gz) into /tmp
- From the command prompt, issue the following commands:
cd /tmp tar -xzvf fmyirc-mdv20071setup_*.tar.gz cd fmyirc-mdv20071setup_* ./install.sh
The FMYiRC MDV2007.1 automated install will now take place. For the most part, errors or warnings can be ignored.
The automated install will finish when you are returned to the command prompt.
Please reboot the system before continuing!!!
- shutdown -r now or press CTRL-ALT-DEL
NOTE: If it's determined that after a reboot there was a problem caused by the FMYiRC Helper CD Install, please note that great care has been taken to ensure any file modified during this process had an original copy placed into the /tmp directory!!!
Post Operating System Install (Manual)
Things that need to be taken care of before you can continue. Most of these items are beyond the scope of this document.
- Configure networking (IP address, DNS, etc...)
- NOTE: The firewall is already configured for you via the FMYiRC Helper CD!
- Setup SSL keys for Apache/HTTPD
- Set to IP address of FMYiRC server, unless DNS is used.
- Set to WAN IP address if most users access FMYiRC server from off-site locations/Internet.
- Set to LAN IP address if most users access FMYiRC server from locally, on-site.
- Set to IP address of FMYiRC server, unless DNS is used.
You may want to reboot the server again before continuing.
What's Next?
Congratuations! Your FMYiRC server should now be ready to access from a web browser.
To access, please point a computer with a web browser and network connection to: https://IP_ADDRESS/freemed-yirc/
NOTES:
- If you omit the /freemed-yirc/ portion of the above address, you may only see a blank page. This is a security feature to reduce unwanted access to your server.
- If you omit only the final forward slash (/), you may also receive an error or time-out. Unless your FMYiRC server is configured with a Fully Qualified Domain Name, you should ALWAYS include the final forward slash!
- In addition, you will receive an error if you use http instead of https. This is also a security feature.
At this point, you may wish to view the following documents:
- Freemed-YiRC V1.20 Quick Start/Initial Configuration Guide - How to begin configuring FMYiRC for your agency
- The following documents may not have up-to-date information for V1.20, but may still be quite relevant:
- Freemed-YiRC V1.00 Administration Manual - Administration manual for FMYiRC
- Freemed-YiRC V1.00 Printing Guide - Printing guide for FMYiRC
- Freemed-YiRC V1.00 User Manual - User manual for FMYiRC
- The following documents may not have up-to-date information for V1.20, but may still be quite relevant:
