SDSS HowTo Guide

[help][troubleshooting][faq][login]

HowTo Subscribe
HowTo Extend Your Client Subscription
HowTo Create Infobase Subscription
HowTo Create File Download Subscription
HowTo Enter Shipping Products
HowTo Enter File Download Products
HowTo Create an IP Recognition Login Record
HowTo Link User Back to Infobase Page which Bounced Him to Login Screen
HowTo Create Referer URL for Automatic User Login
HowTo Set Up Subscription/Download Files for Access from Remote (i.e., Servers outside the SCBBS network) Servers
How to Set Up File Download Subscription / Purchase Services for Adobe eBooks Distributed by an Adobe Content Server (ACS)

Remote Content Server Configuration Information

 

HowTo Subscribe

An SDSS Client Account subscription gives you the ability to create infobase/file download subscriptions and shipping/file download shopping cart products for your end users.  You may select the number of subscriptions, infobases and duration of your subscription.  Note that each initial subscription includes the ability to create 1 Subscription Record and 1 Infobase Record.

  1. You begin the SDSS Client Account subscription process at the SDSS Order Form.  If this is your first introduction to SDSS, you got to this page from the SDSS Order Form.   Use your browser BACK button to return to the Order Form.
  2. Select if this is a subscription for a New or Existing Account.  If you have already subscribed to SDSS as a Client, and wish to extend your subscription, then select "Existing".  If this is your initial SDSS Client subscription, then select "New".
  3. New or Existing Client?: If this subscription is for an existing account, please enter your existing Client Username and Password in the boxes provided.   If this is a new account, ignore these boxes.
  4. Setup Fee: If this subscription is for a new account, you will automatically be charged the "Setup Fee" displayed.  If this is an existing account, the Setup Fee is waived.
  5. Base Monthly Fee: This fee is the basic monthly charge for an SDSS Client Account, whether new or existing.  You pay this fee each month that your SDSS Client Account is active.  The base fee includes 1 Subscription Record and 1 Infobase Record.  In other words, if you do not choose any additional subscriptions or infobases, you will still be able to set up one online infobase subscription with one infobase.
  6. Additional Subscriptions: You enter here the number of additional subscriptions, after the first, that you desire.  For example, if you would like to offer your end users 3 subscriptions: "Great Battles of the Civil War", "Great Generals of the Civil War" and "Great Parties of the Civil War", then you would enter 2 additional subscriptions.   Remember, the first one is included in the Base Monthly Fee.  You can always come back and increase (or decrease) this number when you re-subscribe.
  7. Additional Infobases: The concept of the "infobase" originally came from the Folio Views Infobase model.  With SDSS, we modified the concept for non-Folio Views content to refer to an "information database" within a single subscription. For example, if your subscription consists of "Great Battles of the Civil War", you may have within that subscription individual infobases such as "Appomattox", "Gettysburg", "Bull Run", etc...  Note that in general, LivePublish, NXT3, dtSearch and Authentix Directory-Protected content do NOT require more than 1 Infobase because multiple data sets for them can only be separated by subscription.  Multiple infobases, at this time, are generally only required for siteDirector (Folio Views Infobase) content.

    You enter here the number of additional infobases, after the first, that you want.  The basic concept of SDSS Infobase Subscriptions is that they consist of groups of infobases.  However, that does not stop you from having only one infobase per subscription, or just one subscription consisting of one infobase.  As with subscriptions, you enter the number of infobases here, beyond the first, that you wish to have controlled by SDSS.  You can always come back and increase (or decrease) this number when you re-subscribe.  
  8. Number of Months: This is the number of months you wish to subscribe.   If you are a new Client, this will be the number of months starting from today.   If you are an existing Client, this will be the number of months starting from your existing Client Account expiration date.  Let's say you select 3 months, and today is June 1, 1999.  If this is a new account, the expiration date will be September 1, 1999.  If this is an existing account which is due to expire August 15, 1999, then the new expiration date would be November 15, 1999.
  9. Grand Total: This will be the sum of the Setup Fee (if new account) plus (Base Monthly Fee + (Number Additional Subscriptions * Additional Subscriptions Rate) + (Number Additional Infobases * Additional Infobases Rate)) * Number of Months.  On the SDSS Order Form, you can click on the "Calculate Monthly Total" and "Calculate Grand Total" buttons to get a better idea of how the Grand Total is reached.  This will be the amount you pay for this transaction.
  10. Continue: Click on the "Continue Button" to get a summary of your order.  You will see the options you selected, the expiration date, the maximum subscriptions and infobases you are allowed, and the total due.
  11. Please Read Legal Information: You must read our Legal Information and License Agreement before continuing beyond this point because by continuing, you indicate that you accept, understand and agree to our legal terms.
  12. Processing Payment Form - SDSS Client Account: After continuing from the check form, you will see the Processing Payment Form.  Here you enter in your address and credit card information.  The information entered into the section titled "Ship To/Mail To Address" will be used to create your Client Source Record (your basic account information).  Once you submit this form, and it is successfully accepted, you will have an SDSS Client Account.  You will see a receipt on your browser, and you will receive one via e-mail.  You will also receive a Client Username and Password, and the URL to log into SDSS as a Client.  PLEASE PRINT THIS INFORMATION AND KEEP IT IN A SAFE PLACE.

Thank you for becoming an SDSS Client.

HowTo Extend Your Client Subscription

Once you subscribe to SDSS as a Client, you can easily extend your subscription   at any time by going back to the SDSS Order Form page and following the instructions in "How to Subscribe" for an "existing" account. The main difference is that you will not be charged the "Setup Fee" when subscribing as an "existing" Client.

It is very important that you understand that when re-subscribing, your maximum subscriptions and maximum infobases are re-set to whatever your new order amount is.   So, if you initially order 2 subscriptions and 5 infobases, when you re-subscribe you need to indicate the same number of subscriptions and infobases if you want to maintain the same maximums you initiated.  The summary page in Step #10 of "How to Subscribe" will display to you the maximums your new order will create.

HowTo Create Infobase Subscription

  1. Log into SDSS as Client.
  2. From Client Top Menu, select "SD Security Maintenance".
  3. Select "Subscription" button, then click "add".  Enter your Subscription Record.  Repeat this for each subscription you would like to have available under SDSS.  Return to SD Security Maintenance menu ("home") when finished.
  4. Select "Infobase" button, then click "add".  Enter your Infobase Record.  Repeat this for each infobase you wish to have secured under SDSS.
  5. Once the Subscription and Infobase record(s) are set up successfully, the infobase is online with SDSS.  Anyone attempting to access the infobase will receive a prompt to log in or subscribe. 
  6. You may wish to create links on your website to the login and subscribe URLs to your SDSS subscriptions.  This is how it is done: 
    To Login:
    http://dns.scbbs.com/client-cgi-bin/secure_login.pl?<source_code>+<subscription_code>
    Where: "source_code" is your Client Account Source Code, which is the same as the Client Username assigned to you, and "subscription_code" is the code assigned to the Subscription Record you enter in Step #4 above.
    For example, if your Client Account Source Code = "C100", and you want to establish a login link to a Subscription with code "O1005", then you create the following login link:
    Example: http://dns.scbbs.com/client-cgi-bin/secure_login.pl?C100+O1005
    To Subscribe
    :
    http://dns.scbbs.com/client-cgi-bin/secureord.pl?<source_code>+<subscription_code>
    Example: http://dns.scbbs.com/client-cgi-bin/secureord.pl?C100+O1005
  7. When a user successfully logs in, he/she will be taken to the URL you supplied in the "Start URL" field of the "Subscription Record". 

That's it.  It's done.  Please make sure that your SDSS Softpages are correctly installed, and that your "Start URL" is correct.  It is YOUR responsibility to make sure that when your end user signs up or pays for your subscription, he/she can get to the infobase(s) they signed up or paid for.

HowTo Create File Download Subscription

  1. Contact your SDSS System Administrator and advise him/her that you wish to offer "File Download Subscriptions".  The Administrator will give you a username, password and address where you will FTP the files you wish to make available with this subscription. The Administrator will also give you the information you need to define your files into the File Download table. All files you intend to make available for download via SDSS must be defined in the File Download table
  2. Log into SDSS as Client.
  3. From Client Top Menu, select "SD Security Maintenance".
  4. Select "Subscription" button, then click "add".  Enter your Subscription Record. If this subscription is only for file downloads, enter "D" for Subscription Type.  If this is an Infobase Subscription which includes file downloads, then make sure you enter "Y"  in the field called "File Downloads (Y/N)".  
  5. You need to create a File Record for each file which will be downloaded via this subscription.  Make sure you have uploaded your files to the FTP site provided to you by the SDSS Administrator, and you know what the root "Path" and "Hostpath" values are before proceeding to define files.
  6. Go back to SD Security Maintenance Menu, select "Files" button, then click "Add".  Here, you enter each file which will be accessed via this subscription.  Your SDSS Administrator will supply you with the "Path" and "Hostpath" root values needed by SDSS to identify where the file is located on the server, and what the URL to the file will be.  Please remember to assign ("add_filesub") the correct subscription code to each file record after it is recorded.  Each file can belong to multiple subscriptions.  You are responsible for entering the correct file records, and assigning to them the correct subscriptions.
  7. Please note that the "hostpath" to each file is the URL link used to access it.  It is the only way end-users will be able to get to the file.
  8. Once you set up the Subscription and Files record(s), end-users will have to log in to the Subscription in order to access the file(s).  The constructs for creating login and subscribe URLs are exactly the same for File Downloads as they are for Infobase Subscriptions:
    To Login:
    http://dns.scbbs.com/client-cgi-bin/secure_login.pl?<source_code>+<subscription_code>
    Where: "source_code" is your Client Account Source Code, which is the same as the Client Username assigned to you, and "subscription_code" is the code assigned to the Subscription Record you enter in Step #4 above.
    For example, if your Client Account Source Code = "C100", and you want to establish a login link to a Subscription with code "O1005", then you create the following login link:
    Example: http://dns.scbbs.com/client-cgi-bin/secure_login.pl?C100+O1005
    To Subscribe
    :
    http://dns.scbbs.com/client-cgi-bin/secureord.pl?<source_code>+<subscription_code>
    Example: http://dns.scbbs.com/client-cgi-bin/secureord.pl?C100+O1005
  9. As with Infobase Subscriptions, when a user successfully logs into a File Download Subscription, he/she will be taken to the URL you supplied in the "Start URL" field of the "Subscription Record".  The difference with File Download Subscriptions is that he/she will also be given access to the files in the Files Table that you associated with this subscription. However, keep in mind that you must direct your users to the file locations. You should do this with your Start URL page by placing links on it to the individual file "hostpaths" defined for this subscription.  

That's it.  You are responsible for making sure that the File Table data  is correctly entered, the Start URL is correct, and the URLs you provide to your end users to access the files are correct.  You also are responsible for making sure that the files are uploaded to the correct directories and available according to the schedule you promise to your end users for the subscription.

HowTo Enter Shipping Products

A product that you intend to sell online and ship does not require a Subscription Record.  It only requires a Client Account and a SubProduct Record entry.

  1. Log into SDSS as a Client.
  2. From the Client Top Menu, select "Customer Maintenance".
  3. Select "SubProduct" button, and click on "add".
  4. Enter the information for your product in the SubProduct Record.
  5. Enter any applicable Shipping or Tax information.
  6. Once this information is entered correctly, the SubProduct can now be made available via the SDSS Shopping Cart.  From your website, you will want to point your users to this product in the following manner:
    http://dns.scbbs.com/client-cgi-bin/cart.pl?<source_code>+<subproduct_code>+<mainproduct_code>+<shipping_type>
    For example, if your Client Source Code is "C100", and the SubProduct Code is "N100-2001" and the Main Product Code is "N100", and the Shipping Type is "S" (for shipped), then you point your end users to the following URL:
    http://dns.scbbs.com/client-cgi-bin/cart.pl?C100+N100-2001+N100+S
  7. That's it.  The product is now online.  You create a link on your website to the Shopping Cart URL of each product you wish to sell online via SDSS.

Do NOT advertise or sell products online that you are not prepared to ship.  Such will be grounds for termination of your SDSS Account.  Also, we prefer that you do not use SDSS to sell the following items: Multi-Level Marketing (MLM), Explicit Sexual and/or Pornographic Items,  Racist Literature, Firearms, Explosives, or Deadly Weapons of any sort.

HowTo Enter File Download Products

A product that you intend to sell online and offer as a file download does not require a Subscription Record.  It only requires a Client Account and a SubProduct Record entry.

  1. Please contact your SDSS System Administrator and advise him/her that you wish to provide File Download purchases.  The Administrator will provide you with the username, password and address where you will FTP the files you wish to make available for purchase.  The Administrator will also give you the information you need to define your files into the File Download table.  All files you intend to sell online must be defined in the File Download table.
  2. Log into SDSS as a Client.
  3. From the Client Top Menu, select "Customer Maintenance".
  4. Select "SubProduct" button, and click on "add".
  5. Enter the information for your product in the SubProduct Record.  Note that you will need to enter the "File Name" of the product to be downloaded, and a "Shipping Type" of "D" into the record, in addition to the other normal fields. Return to Client Top Menu ("top") when finished.
  6. The file names of all SubProduct download files must be defined in the File Download table.  From the Client Top Menu, select "SD Security Maintenance".  Select the "Files" button and click on "add".  The File Table file name must match the SubProduct file name EXACTLY.  If the files you are defining are ONLY for purchase via the Shopping Cart, and will not be accessible via subscriptions, it is not necessary to assign subscriptions to them.  
  7. Once the SubProduct and Files information is entered correctly, the SubProduct download can now be made available via the SDSS Shopping Cart.  From your website, you will want to point your users to this product in the following manner:
    http://dns.scbbs.com/client-cgi-bin/cart.pl?<source_code>+<subproduct_code>+<mainproduct_code>+<shipping_type>
    For example, if your Client Source Code is "C100", and the SubProduct Code is "N100-3001" and the Main Product Code is "N100", and the Shipping Type is "D" (for shipped), then you point your end users to the following URL:
    http://dns.scbbs.com/client-cgi-bin/cart.pl?C100+N100-3001+N100+D
  8. That's it.  The file download is now online.  If someone purchases it, they will be placed into a temporary directory and the user will be given 24 hours to download it.  You create a link on your website to the Shopping Cart URL of each file download you wish to sell online via SDSS.

You are solely responsible for making sure the files are in the directory they are supposed to be in, and the "Hostpath" URLs are correct.  End users are VERY unhappy when they pay for a download and can't download the file they paid for.  Such will be grounds for termination of your SDSS Account.  Also, we prefer that you do not use SDSS to promote/market or sell information concerning the following items: Multi-Level Marketing (MLM), Explicit Sexual and/or Pornographic Items,  Racist Literature, Firearms, Explosives, or Deadly Weapons of any sort.

HowTo Create an IP Recognition Login Record 

This is a Customer Log (SDCUSTLOG) record which allows all users from a particular IP, IP network or IP range to access SDSS protected content without having to log in.  To do this, you simply enter the IP, or IP network using "*" (full 255 addresses), or IP range using "-".  For example, if you wanted all users from IP network 199.182.110. (199.182.110.0 through 199.182.110.255) to be "IP recognized",  then you would create a Customer Log record and enter "199.182.110.*" in the SDCLOG_IP (Log IP Address) field.   If you would like only users from IP addresses between 199.182.110.0 and 199.182.110.64 to be automatically logged in, then enter "199.182.110.0-64" into the SDCLOG_IP field.  If you would like all users from networks 199.182.110. through 199.182.115. to be automatically logged in, then enter "199.182.110-115.*" into the SDCLOG_IP field.

Note that you must also enter "Y" into the SDCLOG_RECOGNIZE (Log Auto-Recognize) field, which means you want the IP or IP domain automatically recognized and logged in using the username supplied in the SDCLOG_USERNAME (Log Username) field. 

Note that the username in SDCLOG_USERNAME must be a valid SDSS Customer (SDCUST Table) account for the subscription the user with this IP or within this IP domain is attempting to access.

  1. Log into SDSS as a Client.
  2. From the Client Top Menu, select "SD Security Maintenance".
  3. Select "Customer Log" button, and click on "add".
  4. Enter the information for this record in the Customer Log Record.  Note that you will need to enter "Y" into the "Log Auto-Recognize" field as well as entering the "Log IP Address" as 999.999.999.* or 999.999.999.999-999 or 999.999.999-999.* where the "999" groups are valid IPs, IP networks and/or IP ranges of users for whom you wish to allow automatic IP Recognition access.  Also note that there must be a valid SD Customer Account on file for the Subscription for which you are creating this log record.
  5. Don't forget to click on the "add_record" button to actually add this log record to the database.

HowTo Link User Back to Infobase Page Which Bounced Him to Login Screen

Someone comes to an infobase who is not logged in (new or existing user). He is bounced off the infobase to the Login screen. There, he can follow the link to create an account or enter his existing username/password. Once logged in, he is taken to the page you defined as the Subscription Start Page

How does he get back to the infobase page that originally bounced him to the login screen?

Please note this link:

    http://dns.scbbs.com/client-cgi-bin/referer.pl

This program does one thing: Sends the user to the last page he attempted to access before being bounced out of the infobase, or to back to the page which referred him to this program. Every time someone is bounced out of an infobase, the URL he was attempting to access is stored in a table called REFERERLOG, along with his IP address. "referer.pl" will take him to the infobase page from which he was bounced if his IP matches that in the REFERERLOG. The user returned to the page which referred him to this program (typically, your Subscription Start page if you put this link there) if his IP is not found in the REFERERLOG.

If you want this functionality, you should put the link above someplace on your Subscription Start page. You will need to explain to your users what this link is and its functionality in terms they will be able to understand.

HowTo Create Referer URL for Automatic User Login

SDSS has the ability to allow automatic logins to subscritions based upon the referer URL -- that is, based upon the URL which refers the login link.  In order to have automatic logins from a referer URL, you must have the following:

  1. Log into SDSS as a Client.
  2. From the Client Top Menu, select "SD Security Maintenance".
  3. Select "Referer File" button, and click on "add".
  4. Enter the information for this record into the Referer File. This information will be:
    a) URL of page which contains automatic login link(s).
    b) A valid SD Customer Account username for the Subscription(s) for which you are creating this Referer record.
    c) A default Subscription Code for this Referer record.
    d) The Source Code for the Subscription(s) that will be logged into using this Referer record.
  5. Don't forget to click on the "add_record" button to actually add this Referer record to the database.

HowTo Set Up Subscription/Download Files for Access from Remote (i.e., Servers outside the SCBBS network) Servers

SDSS has the ability to protect and serve files located on remote servers. By "remote", we mean that the files are physically located on a server which is outside of the SCBBS network. The following shows the file access flowchart of this process:

|End User's Browser| --------> |SDSS Server running sdssfile servlet| ----------> |Remote Server running sdssFileServer servlet|

The file is defined as usual in the File Download table. The Hostpath field for this table record will consist of an sdssfile URL to the file (i.e., http://www.domain.com/servlet/sdssfile/file).  The end user will access the file using sdssfile servlet.  The sdssfile servlet will contact the sdssFileServer servlet running on a remote server.  The file is physically located on the sdssFileServer remote server.  The sdssFileServer will stream the file to the sdssfile servlet, which in turn will stream the file to the end-user.

This setup requires the following:

  1. Copy files to be accessed into path on Remote Server.  Make note of this path.  Examples: c:\sdss\files or /home/sdss/files.
  2. Install sdssFileServer servlet onto Remote Server. 
    1. The two files to be installed, sdssFileServer.class and  sdssFileServer.web.xml, are located here ftp://ftp.scbbs.com/pub/sdss.
    2. sdssFileServer.class should go into your Java Servlet Engine "classes" directory, or directory where your Java Servlet class files are normally located.  
    3. sdssFileServer.web.xml needs to be in your Java Servlet Engine "WEB-INF" directory.  It should be either renamed to "web.xml" or added to your existing "web.xml" file located in your Java Servlet Engine "WEB-INF" directory.  
    4. Edit the "web.xml" file to reflect the correct "sdssVerify" value.  This value is the URL to the SDSS Verification Server.  You will need to verify the correct SDSS Verification Server URL with your SDSS Administrator.
    5. Make note of the full URL to the sdssFileServer servlet on the Remote Server.  Examples: http://www.RemoteServer.com/servlet/sdssFileServer or http://www.RemoteServer.com:8080/servlet/sdssFileServer
  3. Log into SDSS as a Client.  Note that the following steps assume that Subscription and/or SubProduct code(s) have already been set up.
  4. Create File Download record for each file to be downloaded.

    a. From the Client Top Menu, select "SD Security Maintenance".
    b. Select "Files" button, then click "Add".  
    c. Enter the information for this Files record:

        A) File Name.  Physical file name.  Must not contain any spaces. 
        B) Source Code.  Enter your SDSS Client Account Source Code here.
        C) Content Type.  Enter MIME Content Type for this file:

            (application/msword) .doc
            (application/octet-stream) .exe
            (image/gif) .gif
            (text/html) .html
            (image/jpeg) .jpg
            (application/pdf) .pdf
            (application/x-mspowerpoint) .ppt
            (image/tif) .tif
            (text/plain) .txt
            (application/x-msexcel) .xls
            (application/x-zip-compressed) .zip
            (video/quicktime) .mov
            (audio/x-pn-realaudio) .rm

        D) File Path.  Enter the exact directory path to this file, including the filename, as it is located on Remote Server.  
            Examples (where "file" is the filename): 

            c:\sdss\DownloadFiles\file
            /home/sdss/DownloadFiles/file

        E) Description File URL.  URL to web page which describes this file (optional -- used primarily if the file is for download only). 
        F) Type.  D = download file, H = HTML, T = description text, I = image, E = eBook.
        G) Title.  Brief title for file.
        H) Description.  Brief description for file.
        I) Host Path (URL).  Enter the URL to access the file. This URL will contain the sdssfile Servlet, SDSS Server and filename.
            Contact your SDSS Administrator for the name of the SDSS Server you should use for this file download URL.
            Note: this Host Path MUST contain the name of the file (even if it is physically located on the Remote Server).
            End users will not be able to get to the file without this complete URL.
            Example (where "file" is the filename):

            http://www.SdssServer.com/servlet/sdssfile/file

            Also Note: This URL should be on the same server as your securej_Login.htm file used as the "Start URL" for this
            subscription.  This is necessary because the sdssfile server must be the same server where the login cookie (set locally
            by securej_Login.htm) is located.

        J) Remote Server (Y/N).  You enter "Y" here if this file is PHYSICALLY located on a Remote Server.  Enter "Y".
        K) Remote Server URL.  Enter the URL to the sdssFileServer servlet running on the Remote Server.  
            Note that the Remote Server URL does NOT contain the name of the file.
            Example:

            http://www.RemoteServer.com/servlet/sdssFileServer

    d. Click on the "add_record" button to add this File record to the database.  
    e. Once the record is added, you must click on "add_filesub" for each Subscription that will have access to this file.
        If you do not add the subscription(s) here, users who log into the subscription(s) will NOT be able to access the file.
  5. Create Default SDSS Verification Server User Account.  This is an SD Customer Account record which contains your SDSS Client Account Source Code as the SD Customer Account Username.  This is a necessary step in order to be able to enter the IP addresses of servers who are allowed to access either the SDSS Verification Server OR the Remote Server running sdssFileServer.

    a. From the Client Top Menu, select "SD Security Maintenance".
    b. Select "Customer File" button and click on "add".
    c. Enter the information for this  Customer File record. This information will be:

        A) Order ID. This can be whatever you wish.
        B) E-Mail. The e-mail address for your primary contact.  This is essentially so someone will know when this record is to expire.
        C) Expiration Date. This date should be longterm.  Basically, you don't want this record to expire.
        D) Username. Enter your SDSS Client Account Source Code here. This value MUST match your Client Source code exactly.
        E) Password. This can be whatever you wish.
        F)  Source Code. Enter your SDSS Client Account Source Code here also.
        G) Name. You will need to enter a name here in order to record the record.

    d. Click on the "add_record" button to add this Customer record to the database.
  6. Enter Customer Log File (SDCUSTLOG) SDSS Verification Server record(s) for SDSS Verification Server User Account(s) created in Step #5 above.  These records need to be created in order to allow the Remote Server to contact the SDSS Verification Server, and to allow the sdssfile Server (the URL end-users will use to access files, defined in the "Hostpath" field of the File Download Table record) to contact the Remote Server.  To create these records, you will need to know the IP addresses of the sdssfile Server and the sdssFileServer Server.

    a. From the Client Top Menu, select "SD Security Maintenance".
    b. Select "Customer Log" button and click on "add".
    c. Enter the information for this  Customer Log record. This information will be:

        A) IP. Enter the IP address of the server (sdssfile or sdssFileServer) for which you are entering an SDSS Verification Server record.
            Note that you will need to enter an SDSS Verification Server record for BOTH servers.
        B) Username. Enter your SDSS Verification Server Customer Account username (i.e., your SDSS Client Account Source Code) here.
            This is the username you entered in Step #5 above.
        C) Password. You can leave this blank.
        D) Expiration Date. This date should be longterm.  Basically, you don't want this record to expire.
        E) Subscription Code. Select any Subscription Code you want.  It really doesn't matter here.
        F) Source Code. Enter your SDSS Client Account Source Code here.
        G) Auto-Recognize IP (Y/N). Enter "V"  here.  "V" means that the server at the IP entered is allowed to access the SDSS Verification Server.
            By extension, any server defined here with "V" can also access an sdssFileServer Remote Server.

    d. Click on the "add_record" button to add this Customer Log record to the database.

From this point, files set up using the process above will be available for SDSS download using this URL:

    http://www.SdssServer.com/servlet/sdssfile/file

HowTo Set Up File Download Subscription / Purchase Services for Adobe eBooks Distributed by an Adobe Content Server (ACS)

SDSS has the ability to serve Adobe PDF eBooks  located on an Adobe Content Server (ACS).  The following shows the file access flowchart of this process:

|End User's Browser| ---> |SDSS Server running sdssfile servlet| ---> |Server running sdssEBookServer servlet|---> | Server running sdssGBLink.asp ASP program|--> | Server running Adobe Content Server Fulfillment Module|

This process assumes that the eBook has been deployed on an ACS Fulfillment Module and has also been defined in the SDSS File Download (FILES) Table.  The end user accesses the eBook using the SDSS servlet sdssfile.  This is the front end of the access process and requires that the user have a subscription to the eBook or that the user has purchased the eBook.  The sdssfile servlet contacts the sdssEBookServer servlet, which double checks that this user has access to this eBook, and if so, sends the download request to the sdssGBLink.asp program.  The sdssGBLink.asp contacts the ACS and generates a download link for the eBook which is sent back to the sdssfile servlet and displayed to the end user.  The end user then clicks on this link and, if he has the Adobe eBook Reader Plug-In installed, is able to download and read the eBook.

This setup requires the following:

  1. a. Install ACS as per instructions in "ACS Installation Guide" documentation.
    b. Setup an ACS Fullfilment Module as per the "Using the Fulfillment Module" instructions in "Getting Started with the ACS" documentation.
    c. Create an ACS Store to use for eBooks to be provided by SDSS ("Defining a Bookstore in the Database").
    d. Upload, Package and Deploy the desired eBooks to the ACS ("Using Book Preparation Module" section of  "Getting Started with the ACS"
        documentation ).
    e. Make the eBooks Available from the  Store you have defined for SDSS ("Specifying the Availability of eBooks for Fulfillment").
    f. Make note of the Store Key Name and Fullfilment URL Signature Key.
    g. Also make note of the Book Title, Identifier Type and Identifier Code for each eBook you intend to provide under SDSS.
  2. Install GBLink Module, sdssEBookServer servlet and sdssGBLink.asp ASP program onto GBLink Server.  The GBLink Server can be the ACS server or any server on which the GBLink Module is installed.  
    1. Follow the "Installing the GBLink Module" instructions in the "Getting Started with the ACS" documentation to install the GBLink module on a Remote Server.  This server can be the same one you use for ACS, or any Web Server which meet the ACS requirements.
    2. The three SDSS files to be installed, sdssEBookServer.class and  sdssEBookServer.web.xml, are located here ftp://ftp.scbbs.com/pub/sdss/ACS.
    3. sdssGBLink.asp should be installed into a directory under your Web Server path.  It needs to be accessible via an HTTP connection by the sdssEBookServer servlet.  It should also have permissions set so that it can be accessed ONLY by the IP of the server on which runs the sdssEBookServer servlet (in other words, the IP address of the same server sdssGBLink.asp is running on).
    4. sdssEBookServer.class should go into your Java Servlet Engine "classes" directory, or directory where your Java Servlet class files are normally located.  
    5. sdssEBookServer.web.xml first needs to be edited.  You need to enter the following servlet initialization parameter values into this file (enter values between the single quotation marks):

      sdssVerify.  Edit here the URL to the SDSS Verification Server.  This will be given to you by SCBBS.  Example: http://test.scbbs.com/servlet/sdssVerify 
      GBLinkURL.  Edit here the URL to the sdssGBLink.asp ASP program. Example: http://www.YourGBLinkServer.com/sdssGBLink.asp 
      keyname.  Edit here the ACS Store Key Name for the Store you created for SDSS handled eBooks.
      keysig.  Edit here the ACS Store Fullfillment URL Signature Key for the Store you created for SDSS handled eBooks.
      server. Edit here the IP address of your ACS Server.
    6. sdssEBookServer.web.xml next should be copied to be in your Java Servlet Engine "WEB-INF" directory.  It should be either renamed to "web.xml" or added to your existing "web.xml" file located in your Java Servlet Engine "WEB-INF" directory.  
    7. Make note of the full URL to the sdssEBookServer servlet on the GBLink Server.  Examples: http://www.GBLinkServer.com/servlet/sdssEBookServer or http://www.GBLinkServer.com:8080/servlet/sdssEBookServer
  3. Log into SDSS as a Client.  Note that the following steps assume that Subscription and/or SubProduct code(s) have already been set up.
  4. Create File Download record for each file to be downloaded.

    a. From the Client Top Menu, select "SD Security Maintenance".
    b. Select "Files" button, then click "Add".  
    c. Enter the information for this Files record:

        A) File Name.  Enter the ACS identifier code for this eBook.  Must not contain any spaces. 
        B) Source Code.  Enter your SDSS Client Account Source Code here.
        C) Content Type.  Enter MIME Content Type for this file:

            (application/pdf) .pdf

        D) File Path.  Enter the ACS eBook identifier type (i.e., ISBN, SKU, etc...).
        E) Description File URL.  URL to web page which describes this file (optional -- used primarily if the file is for download only). 
        F) Type. Enter "E".  ( D = download file, H = HTML, T = description text, I = image, E = eBook)
        G) Title.  Enter the eBook title.
        H) Description.  Enter a brief description for the eBook.
        I) Host Path (URL).  Enter the URL used to access this eBook. 
            This URL will contain the SDSS Server, sdssfile Servlet and ACS eBook identifier code.
            Contact your SDSS Administrator for the name of the SDSS Server you should use for this eBook download URL.
            Note: this Host Path MUST contain the eBook identifier code (entered as the "File Name" above).
            End users will not be able to get to the file without this complete URL.
            Example (where "eBookIdentiferCode" is the ACS identifier code of the eBook to be downloaded):

            http://www.SdssServer.com/servlet/sdssfile/eBookIdentifierCode

            Also Note: This URL should be on the same server as your securej_Login.htm file used as the "Start URL" for this
            subscription.  This is necessary because the sdssfile server must be the same server where the login cookie (set locally
            by securej_Login.htm) is located.

        J) Remote Server (Y/N).  You enter "Y" here.
        K) Remote Server URL.  Enter the URL to the sdssEBookServer servlet running on the GBLiink Server.  
            Note that the GBLink Server URL does NOT contain the name of the file.
            Example:

            http://www.GBLinkServer.com/servlet/sdssEBookServer 

    d. Click on the "add_record" button to add this File record to the database.  
    e. Once the record is added, you must click on "add_filesub" for each Subscription that will have access to this eBook.
        If you do not add the subscription(s) here, users who log into the subscription(s) will NOT be able to access the eBook.
  5. Create Default SDSS Verification Server User Account.  This is an SD Customer Account record which contains your SDSS Client Account Source Code as the SD Customer Account Username.  This is a necessary step in order to be able to enter the IP addresses of servers who are allowed to access either the SDSS Verification Server OR the GBLink Server running sdssEBookServer.

    a. From the Client Top Menu, select "SD Security Maintenance".
    b. Select "Customer File" button and click on "add".
    c. Enter the information for this  Customer File record. This information will be:

        A) Order ID. This can be whatever you wish.
        B) E-Mail. The e-mail address for your primary contact.  This is essentially so someone will know when this record is to expire.
        C) Expiration Date. This date should be longterm.  Basically, you don't want this record to expire.
        D) Username. Enter your SDSS Client Account Source Code here. This value MUST match your Client Source code exactly.
        E) Password. This can be whatever you wish.
        F)  Source Code. Enter your SDSS Client Account Source Code here also.
        G) Name. You will need to enter a name here in order to record the record.

    d. Click on the "add_record" button to add this Customer record to the database.
  6. Enter Customer Log File (SDCUSTLOG) SDSS Verification Server record(s) for SDSS Verification Server User Account(s) created in Step #5 above.  These records need to be created in order to allow the Remote Server to contact the SDSS Verification Server, and to allow the sdssfile Server (the URL end-users will use to access files, defined in the "Hostpath" field of the File Download Table record) to contact the Remote Server.  To create these records, you will need to know the IP addresses of the sdssfile Server and the sdssEBookServer Server.

    a. From the Client Top Menu, select "SD Security Maintenance".
    b. Select "Customer Log" button and click on "add".
    c. Enter the information for this  Customer Log record. This information will be:

        A) IP. Enter the IP address of the server (sdssfile or sdssEBookServer) for which you are entering an SDSS Verification Server record.
            Note that you will need to enter an SDSS Verification Server record for BOTH servers.
        B) Username. Enter your SDSS Verification Server Customer Account username (i.e., your SDSS Client Account Source Code) here.
            This is the username you entered in Step #5 above.
        C) Password. You can leave this blank.
        D) Expiration Date. This date should be longterm.  Basically, you don't want this record to expire.
        E) Subscription Code. Select any Subscription Code you want.  It really doesn't matter here.
        F) Source Code. Enter your SDSS Client Account Source Code here.
        G) Auto-Recognize IP (Y/N). Enter "V"  here.  "V" means that the server at the IP entered is allowed to access the SDSS Verification Server.
            By extension, any server defined here with "V" can also access an sdssEBookServer Remote Server.

    d. Click on the "add_record" button to add this Customer Log record to the database.

From this point, eBooks set up using the process above will be available for SDSS download using this URL:

    http://www.SdssServer.com/servlet/sdssfile/eBookIdentifierCode