homepagewww.CraigRichards.com
Craig Richards LLC
search and site map
resume
Contact Us
BigSender, AdminPro, Envirolyzer, Whois Search, Percenticon and other software by Craig RichardsCraig Richards' theatre, film and television credits
News2Me
Design Services
maintenance services
programming services

AdminPro User Guide
Sun iForce Partner  buy now | download | support | forum | user survey | user guide | testimonials | version history | news2me
AdminPro User Guide
User Guide
Table of Contents
Getting Started
  downloading
  configuring
  uploading
  running

Troubleshooting FAQ

Setting Preferences
  user preferences
  session preferences

Using AdminPro
  navigating
  debugging CGI
  managing files
    uploading
    downloading
    renaming
    permissions
    opening, editing & saving
    creating directories
    deleting / removing

Security

Distribution Policy
& User Licenses

  multi-user license

Buy Now

Support

Discussion Board

User Survey

News2Me

AdminPro User Guide

AdminPro™ is the CGI debugging and remote file management tool from Craig Richards Design... Continuing innovation, development and support for this software depends a great deal on users who have paid their small shareware fee. If you like AdminPro and haven't yet paid your fee, please click here. Thank you.

With AdminPro on your server, you can easily perform a great many desired functions such as debugging CGI scripts and managing files on a server from your web browser on a desktop computer.

For most users, AdminPro nearly installs itself and its features seem clear (it has a built-in Quick Reference). However, if you'd like to make sure you're using AdminPro to its full potential or if you feel stuck at any point while downloading, configuring, uploading and using AdminPro, this User Guide is designed to help you.

Read why AdminFTP™ and AdminPro™ were re-combined into a single tool.


Getting Started with AdminPro

Downloading AdminPro
From the AdminPro download page, click on the link that is appropriate for the system from which you administrate your website (client). The archive will automatically begin downloading from our FTP server.

If attempts to run AdminPro only returns server errors, I encourage you to read that topic in the Troubleshooting FAQ

The AdminPro Single-User License agreement permits you to download and use AdminPro for up to a 10-day evaluation period before paying the license fee. If you like AdminPro and continue to use it, I urge you to support it.

Configuring AdminPro
Extract the downloaded AdminPro archive. In it, you'll find the "adminpro.cgi" application, the "adminpro-u.cgi" Upload File Module, the "adminpro.txt" document and ten tiny image files. Open the "adminpro.txt" document with a text editor such as Notepad or SimpleText. Read and agree to the Distribution Policy and License before continuing further.

In the case of AdminPro and the File Upload module, some webservers may not be configured to execute files with a ".cgi" extension so you may need to change the extension for "adminpro.cgi" and "adminpro-u.cgi" to ".pl" or ".plx" or anything else required by your server.

Notice the very first line of the "adminpro.cgi" and "adminpro-u.cgi" document that reads: #!/usr/bin/perl – that directs the webserver to execute it using the Perl interpreter and tells the webserver where Perl is located.

The path to Perl may be different on your server. A good shortcut for determining the path to perl on your server is to open a local copy of a script known to run on your server then copy and paste that first line from that script into adminpro.cgi amd adminpro-u.cgi. Another common path to perl is: TOP #!/usr/local/bin/perl if you want to try that. Then, save any changes you may have made to your "adminpro-u.cgi" document.

Uploading AdminPro to your server
Upload the "adminpro.cgi" application, the "adminpro.txt" document and the "adminpro-u.cgi" document to the same directory (usually the cgi-bin) in your server using your standard FTP software. If your website is hosted on a Unix or Linux server, change permissions for the "adminpro.cgi" document and the "adminpro-u.cgi" Perl script to world executable (755 or rwxr-xr-x).

You should also upload the set of ten tiny image files also included in the archive (folder folder, file file, file disabled file disabled, image image, test test, test disabled test disabled, download download, download disabled download disabled, delete delete and delete disabled delete disabled) to the same directory as the "adminpro.cgi" application – unless that directory's permissions are not world readable (commonly 755 or 777) – it's common for cgi-bin's contents to unreadable. (Do not change the names of the image files.)

Running AdminPro
From your desktop web browser, invoke AdminPro on your domain by typing its URL into the "location" or "site" field usually at the top of your web browser: (http://www.yourdomain.com/cgi-bin/adminpro.cgi) – essentially, the same way you visit any page on a website.

For Windows servers: The "properties" for the "adminpro.cgi" program may need to be set as executable by your server administrator.


From the diagram above, you'll seee that AdminPro's interface is divided into four main quadrants. On the left side:
  • The Directory Table which displays the current path at the top, any directories, then files. Sizes, modification dates and permissions (Unix/Linux servers only) are also displayed in that table.
  • Below the Directory Table is the Session Preferences Panel.

    The right side of the AdminPro interface has:
  • The Control Panel consisting of the "permissions grid" (Unix/Linux only), the "item" text field, "test" checkbox and the "execute" button.
  • Below the Control Panel is the Reporting Table which, by default displays AdminPro's Quick Reference to TOP all AdminPro's functions to help you get started. When you perform a function with AdminPro, the results of that task is then displayed in that "reporting" table.
     
  • Document last modified: May 10, 2006
    Site content © 1996–2009 Craig Richards LLC. All rights reserved worldwide.