Home       SUPPORT       FREE CD       Mantis DEMO  

FIRST TIME   Install Instructions for Mantis400 First time or Update? If you have already loaded the software, and are UPDATING to a new version/release, or re-installing the same version, go immediately to UPDATE INSTALL INSTRUCTIONS! Version? If your Product *CD* is a LOWER version than 1.0.01, contact us. A newer version may be available! Documentation... The latest User Documentation is on the Mantis web site at http://Mantisbt.org. E-mail Configuration Once you have Zend Core (PHP itself) loaded, configure your e-mail. Start the Zend Core console at http://xxx.xxx.xxx.xxx:8000/ZendCore then click the Configuration/PHP tab, expand the Mail option, and enter values of your mail server for the send_mail, SMTP, and smtp_port entries. Closed the console, restart the Apache server, and emails should work from within Mantis400 and other PHP apps. The screen should resemble this: FIRST TIME INSTALL INSTRUCTIONS Step 1 We STRONGLY recommend that you log in as QSECOFR or equivalent. All of our software will reside exclusively in a folder under     /www/zendcore/htdocs/ in the IFS ROOT file system, and nowhere else. This install is for the Mantis product and it will be placed in     /www/zendcore/htdocs/mantis400 Step 2 Insert the CD in your CD drive on the AS/400 and use the     LODRUN   OPT01 command. The usual practice of referring to the drive as *OPT will NOT work for this install. The installation requires the absolute name of the optical device. This is usually "OPT01" (oh pee tee zero one). Please confirm this with WRKHDWRSC *STG if necessary. If you have more than one optical drive, specify it as OPT02, or whatever.     Press <Enter> When the command requests additional parameters, just     Press <Enter> The screen will resemble this for a short time: You will be required to agree to the License Agreement which you can view on the screen. Use the Enter key or the ROLL key to scroll through the license. Once you have scrolled to the bottom, press function key F20 to indicate you agree to abide by the License Agreement. The software will create the correct number of folders and populate them. If the installation appears to stall at the following screen, be patient. A lot of work is being done behind the scenes. This could take several minutes... Eventually, you will see the successful installation message at the bottom of the screen: Step 3 Start the PHP services and HTTP server on your system according to the PHP instructions. Step 4 Obtain an AS/400 User Profile and password that provide adequate authority. This should not be a standard, existing profile, but a new one dedicated to the Mantis software and PHP. The User Profile and password will be logged in one configuration file in the Mantis directory in readable format. All of the passwords for actual Mantis users are stored in encrytped format (MD5 hash). We will use this User Profile and Password later. Step 5 Start your web browser. We recommend the free and secure Firefox over MS Internet Explorer, but either will work fine. In the address bar of the browser, key in:     http://192.168.0.220:89/mantis400 where 192.168.0.220 is REPLACED with either the IP address of your AS/400 or the name as registered in your DNS. You will be taken to an address of     http://192.168.0.220:89/mantis400/admin/install.php Allow a few moments, and you will see this screen: Step 6 ALL UPPERCASE ENTRY MUST BE USED FOR THE FOLLOWING SETUP! Fill in the fields as shown with (ALL UPPERCASE) appropriate replacements: 6A. Select [DB2/400 (experimental)] from the drop down. If you only see DB2/400, use that. 6B. Replace S1071FDD with databse name of your system. This is typically the serial number of your system preceded by an "S". You can find the exact name by issuing the AS/400 command     WRKRDBDIRE and use the name of the desired *LOCAL entry. THIS IS A CRITICAL FACTOR IN THE INSTALL!! You cannot make up this name, it must be the *LOCAL value from WRKRDBDIRE. 6C. Using the new User Profile from you AS/400, fill in the "Username" field. 6D. Key in the password for that user. 6E. Construct the database name by using the AS/400 database name and add a slash and the desired SCHEMA name. This schema name will be the actual LIBRARY that the DB2 database resides in on the AS/400. Must be a legal LIBRARY name of up to 10 characters. Fill that in the "Database name" field. 6F. Use the same Username and Password as before for the "Admin" fields. 6G. Do not check the box to "Print SQL...". Make sure it is NOT checked. Your screen should resemble this: 6H. Click the button "Install/Upgrade Database". Step 7 The following screens will display: Note the message "Failed to set schema:". Ignore that. Scroll to the bottom of the long list of items, and they should all have a nice green box that says GOOD next to them. If they do not, contact Mantis400 support. The last screen: Confirm that the bottom of the screen says:     "Install was successful.     Continue to log into Mantis" Step 8 Now let's customize the configuration... If you are going to be doing any serious work on these files, we strongly recommend that you MAP a drive to the file system from your PC. This is done, in general terms, using Operations Navigator, opening the File Systems under your AS/400, selecting the IFS ROOT file system, and navigating to the /www/zendcore/htdocs folder. Right click it and SHARE it, and MAKE SURE TO SET IT TO READ/WRITE. Start the two servers on the AS/400 for file access:     STRTCPSVR   SERVER(*NETSVR   *DIRSRV) and shortly you can map a PC drive to htdocs. Start Windows Explorer (not Internet Explorer) and select Tools | Map network drive, select a drive letter that you like and specify your AS/400 as     \\systemname\htdocs where you replace systemname with the IP address, HOSTS file or DNS name of the AS/400. This also assumes you shared the htdocs folder as the name "htdocs" which is the default. Now yor favorite drive letter should display the contents of the htdocs folder. You can use the Windows Notepad editor to edit these files, but we recommend HTML/PHP-aware editors like NoteTab Pro, for a $30 investment. Even the FREE NoteTab Light is a much better editor than Notepad. If you use Windows Notepad, remember to change the selection box at the bottom "Files of type" to "All Files" to be able to see the .PHP and .HTML files. Use your favorite PLAIN TEXT editor (not MS Word or Wordpad) to edit the file:     \mantis400\config_inc.php It will look something like this: Of course, your User Profile and password will be displayed. Note that this file is not retrievable from any user's web browser, since it is a PHP file and is interpreted. We want to paste the following lines into the file htdocs/mantis400/config_inc.php AFTER the lines that already exist, BUT BEFORE THE LAST     ?> Therefore, you will insert the new lines here: Use the lines below, or click here for a new window with JUST the code so you can select it all with <Ctrl> + <A> and copy with <Ctrl> + <C> then paste it in the editor with <Ctrl> + <V> in the designated location. # ====================================================================== # ====================================================================== # START OF LINES TO ADD TO END OF /config_inc.php # ----------------------------------------------------- # ----------------------------------------------------- # Start of section with MANDATORY customization # ----------------------------------------------------- # Required so links in externally-delivered e-mail have correct # domain name to click back into Mantis. $g_path = 'http://external_domain_name_for_your_AS400.com:89/mantis400/'; # change ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ # --- email variables ------------- $g_administrator_email = 'your-e-mail@your-company.com'; $g_webmaster_email = 'your-e-mail@your-company.com'; # the 'From: ' field in emails $g_from_email = 'noreply@your-company.com'; # the return address for bounced mail $g_return_path_email = 'your-e-mail@your-company.com'; # allow email notification - note that if this is disabled, # sign-up and password reset messages will not be sent. $g_enable_email_notification = ON; # FTP settings, used if $g_file_upload_method = FTP $g_file_upload_ftp_server = 'your-company-ftp-server'; $g_file_upload_ftp_user = 'readwriteuser'; $g_file_upload_ftp_pass = 'readwritepass'; # ----------------------------------------------------- # End of section with MANDATORY customization # ----------------------------------------------------- # ----------------------------------------------------- # ----------------------------------------------------- # ----------------------------------------------------- # Start of section with OPTIONAL customization # ----------------------------------------------------- # --- email variables ------------- # the sender name, part of 'From: ' header in emails $g_from_name = 'Mantis400'; # --- sitewide variables ---------- # browser window title $g_window_title = 'Mantis Help Desk - AS/400 i5'; # title at top of html page $g_page_title = 'Mantis Help Desk - AS/400 i5'; # Files that are allowed or not allowed. Separate items by commas. # eg. 'php,html,java,exe,pl' # if $g_allowed_files is filled in NO other file types will be allowed. # $g_disallowed_files takes precedence over $g_allowed_files $g_allowed_files = ''; $g_disallowed_files = 'php,pl,java'; # --- cookie prefix --------------- # set this to a unique identifier. No spaces. $g_cookie_prefix = 'MANTIS400'; # Link to manual for User Documentation. $g_manual_url = 'http://www.mantisbt.org/manual/index.php/'; # String used to generate the confirm_hash for the # 'lost password' feature and captcha code for 'signup' # ATTENTION: CHANGE IT TO WHATEVER VALUE YOU PREFER $g_password_confirm_hash_magic_string = 'cornedbeefhash'; # absolute path (with trailing slash!) to folder which contains # your TrueType-Font files used to create the captcha image and $g_system_font_folder = './fonts/'; $g_font_per_captcha = 'arial.ttf'; # ----------------------------------------------------- # End of section with OPTIONAL customization # ----------------------------------------------------- # ----------------------------------------------------- # END OF LINES TO ADD TO /config_inc.php # ====================================================================== # ====================================================================== Notice that the listing is broken into two sections, the MANDATORY and the OPTIONAL. If you want the software to run correctly, the MANDATORY are required to be set to your values. The actual text to change is highlighted in RED. Our suggestions:   $g_path = 'http://external_domain_name_for_your_AS400.com:89/'; FOR EXTERNAL ACCESS: If your users will access Mantis from browsers at locations outside your LAN, "external_domain_name_for_your_AS400.com" must be replaced with the URL that an external user would need to type in to get to your AS/400 from the outside world. FOR INTERNAL ACCESS: If your users are only going to access Mantis from INSIDE the LAN, you can use the internal IP address (192.168..., 10...) or the internal DNS or HOSTS table name of the AS/400.   $g_administrator_email = 'your-e-mail@your-company.com';   $g_webmaster_email = 'your-e-mail@your-company.com';   $g_return_path_email = 'your-e-mail@your-company.com'; For the three addresses above, you can just use your e-mail temporarily to see the traffic that these addresses receive.   $g_from_email = 'noreply@your-company.com'; Replace "your-company.com" with your main domain name, as no e-mail will actually ever get deliveres, as we are assuming that NOREPLY is an invalid user.   $g_enable_email_notification = ON; This is important, as Mantis uses e-mail to copy all new issues and new notes on the issues to the interested parties.   $g_file_upload_ftp_server = 'your-company-ftp-server';   $g_file_upload_ftp_user = 'readwriteuser';   $g_file_upload_ftp_pass = 'readwritepass'; FTP capability is nice, and if you have it setup in your organization, set the values here. Otherwise, let it wait for later. Once these values are changed, save the file. Step 9 Click on the link on the installation screen     Continue to log into Mantis" or key in the url in your browser:     http://192.168.0.220:89/mantis400/admin/install.php replacing the 192.168.0.220 address with your own, as before. You will see this screen: Ignore the messages WARNING: You should disable the default "administrator" account or change its password. WARNING: Admin directory should be removed. for now. Log in with the user ID     administrator and the password     root Check the box to "Save Login" so the browser will remember this profile for now. You will see this screen: Click Manage on the gray menu bar to see this screen: Create one or two new accounts with administrator authority so you can delete the default administrator account. Then click [ Manage Projects ] and create some new projects. These are the main groups for issues. One project could be "Help Desk", another could be "Software Design Changes", etc... These can be modified or deleted at any time. When you click [Create New Project], and fill in at least the name, finsing by clicking [Add Project], the screen will say that it was successful. If you just wait a moment, that screen will refresh you back to the Project list screen. This is a common action in Mantis for the screen to display a success message then automatically refresh to the listing screen from which you came. Now select that Project by clicking its name, and scroll down to the Categories area: and add a few. Once you have a project and some Categories defined, click on Report Issue from the gray menu bar at the top for this screen: Select the Help Desk project, or whatever one you created, and check the box to "Make default". Click the [Select Project] button. Note the [Advanced Report] option at the top right of the screen. This is common for most entry screens in Mantis. You can select the level of complexity based on your needs. Experiment with that. Fill in a help desk request and click the [Submit Report] button. The default screen looks like this: And if you click the MINUS sign, it will look a lot more friendly! Step 10 Let's clean up two things we passed up earlier. First, click Manage on the gray menu bar and create at least two profiles with admin privileges. Do not set the "Protected" flag on these accounts or the user will not be able to log in from the e-mail that is generated automatically. Make sure to receive the e=mail and click the link in the e-mail to enable the new accounts by selecting a password. Make sure that you have an alternate login for administrator that works. Now, change the profile for the ADMINISTRATOR by clicking Reset Password. Respond to the e-mail by clicking the link, and provide a new password for the Administrator account. Now go to the mapped drive and rename the folder     /www/zendcore/htdocs/admin to some very obscure name. That will remove the two messages on the login screen. Congratulations! Your Help Desk is operational! Step 11 If you have any issues, jump back to the home page of Mantis400.com and register an Issue in the ONLINE Issue Tracker!