Installing pssRecruit
Contents of the download package:
- readme.txt
- pssRecruit.adm
- pssRecruit.exe or .cgi
- pssRecruit.ini
- pssRecruit.tpl
- footer.tpl
- header.tpl
- PopupHTML.tpl
- DisciplineDefinitions.tpl
- WelcomePageFooter.tpl
- /Postings
- /Postings/Job1234.txt
Currently pssRecruit has been compiled, tested and validated on Intel X86
or compatible platforms with the Supported Operating Systems
listed previously. The Solaris version requires a Sun SPARC or compatible platform.
The Digital Unix and OSF/1 binary requires an Alpha platform. IRIX requires a Silicon
Graphics platform. Cobalt Linux (MIPS) requires a MIPS platform. Compiled versions
for other Linux or Unix versions are available upon request.
You can have the experts install pssRecruit for you, using our Installation and Customization Service.
pssRecruit is easy to install. You can have your copy of pssRecruit installed and running in a few minutes by following the step-by-step instructions, below.
Before you start, be sure that you have...
- Downloaded the correct version for the operating system on your web server
- A location on your web server that has execution enabled
- Access to your web server to be able to change file permissions, create directories, and copy executable files.
Step-by-Step Instructions...
- Step 1. After retrieving the download package for your operating system, extract the distribution files into a temporary location.
- Step 2. Open the pssRecruit.ini file in a text editor. Select the URL = line appropriate for your system (...pssRecruit.exe for NT/Win2000 or
...pssRecruit.cgi for all others). Change this URL = line to the complete
URL where you intend to install pssRecuit. Delete the other URL = line that does not apply.
- Step 3. Copy the pssRecruit files to the location on your Web Server that has execution enabled. If you use ftp, use binary mode.
- NT Version -- The default location on IIS v4.0 is "C:\Inetpub\scripts".
- Linux/Unix Version -- The default location on Apache v1.3.9 is /home/httpd/cgi-bin or
/usr/local/www/cgi-bin.
- Step 4. Set file and directory permissions to permit file execution, reading and writing for the pssRecruit directory and files on your web server.
- NT Version -- The default location on IIS v4.0 is "C:\Inetpub\scripts". On a web server running Windows (2000, NT) and IIS5, IIS4 or PWS the IUSR_xxx should have "Full Control" to the pssRecruit directory and all subdirectories and files. Configurations vary and your server may not have this by default. If you have trouble adding pssRecruit users or new job postings, a system administrator may need to add specific permissions for IUSR_ to the pssRecruit directories and files.
The NTFS File Permissions are set by Right clicking on the directory, select Properties, Security, Permissions, Add, Show Users, Select IUSR_xxx, Full Control.
- Linux/Unix Version -- The default location on Apache v1.3.9 is /home/httpd/cgi-bin or /usr/local/www/cgi-bin. The name (or #number) of the user/group that httpd runs as must have ability to read and write all pssRecruit files. Additionally, you must chmod to give execute access for the user/group that httpd runs as to the pssRecruit.cgi file and execute access to the Postings directory. From the parent directory of pssRecruit issue the following commands chmod 666 -R pssRecruit, chmod 711 pssRecruit. Then change directory to pssRecruit and issue the following commands: chmod 755 pssRecruit.cgi and chmod 777 -R Postings . If you have trouble adding pssRecruit users or new job postings, a system administrator may need to add specific permissions for the user/group that httpd runs as to the pssRecruit directories and files.
Here it is step-by-step:
1.Navigate to cgi-bin directory (must be the parent directory of pssRecruit directory).
cd /home/httpd/cgi-bin
2.Apply rw-rw-rw- mask to pssRecruit directory and everything in it - read/write for all on everything.
chmod 666 -R pssRecruit
3. Apply rwx--x--x mask to directory - Make directory executable for all and writeable for httpd(owner).
chmod 711 pssRecruit
4. Change to pssRecruit directory.
cd pssRecruit
5. Apply rwxr-xr-x mask to pssRecruit.cgi - Make executable/read for all and writeable for httpd(owner).
chmod 755 pssRecruit.cgi
6. Apply rwxrwxrwx mask to Postings directory and everything in it - Make postings read/write/exe for all.
chmod 777 -R Postings
7. Done.
exit
- Step 5.
Generate 30 Day License Key. Run pssRecruit the first time by
typing the URL for your installation into the address bar of your favorite
web-browser. The first time you run pssRecruit, it will generate and
display a 30 day license key. Re-open the pssRecruit.ini file and replace the
temporary key on the Key = line. Save changes and copy the new
INI file to your web server. NOTE: The temporay key is only good for generating the
30 day license key, you MUST copy this 30 day license key into the Key =
field of your pssRecruit.ini file.
- Step 6. Add a new administrator username/password. After you have the proper Key in your pssRecruit.ini file, you can change the initial admin user account. To gain 'Admin' access to pssRecruit, navigate to the URL
http://YourDomain/PathToTheExecutable/pssRecruit.exe?-admin
Upon accessing the administrative interface the initial display in your web browser
is the login screen. Continue access by entering the username admin and the password 1234 then click on the 'Login' button. Passwords and user names are case sensitive (i.e. Password is different than password and recruiter1 is not the same user as Recruiter1). The first time you logon to pssRecruit you will be prompted to add a new administrative user. After clicking the AddUser button you will be logged off. You should then log on as the new administrator and delete the initial packaged username (admin). Now you are ready to add more recruiter and administrative users as explained below.
- Step 7. Place links on your web site to the pssRecruit application. For example, "www.mycompany.com/scripts/pssRecruit.exe" or "www.mycompany.com/cgi-bin/pssRecruit.cgi".
- Step 8. Optionally, customize the pssRecruit interface.
Based on your webserver configuration you may need to specify the full path to the GIF files. If you do not specify a path to the GIF files, the default location to place your GIF
file in IIS and PWS is C:\Inetpub\wwwroot. The default location on Apache v1.3.9 is /home/httpd/html or /usr/local/www/data.
Be sure to delete the administrator account that came set up in the download package.
See our pssRecruit support pages for additional examples and tips to customize your copy of pssRecruit.
If you desire to rename pssRecruit you may do so. You must also rename pssRecruit.ini, pssRecruit.adm and pssRecruit.tpl to correspond to the new name. For example, if you rename it MyRecruiter.exe or MyRecruiter.cgi you must rename the .ini file MyRecruiter.ini. If you do this and it it still looks for pssRecruit.ini then your OS is using a different source executable environment variable other than "SOURCEEXE" or "sourceExe." If this is the case simply continue to use pssRecruit.ini, run "printenv" (most systems have this program) and email us the output along with the type of OS you are running. From this we can add the new
source executable variable and get a new executable to you that will allow you to rename
pssRecruit to whatever you desire. If your system does not have a "printenv" email
us and we will send you one.