Workarounds & APIs Guide
General API

You will need to install first and then configure the Appeon File Server. For installing the file server to IIS, Appeon PowerServer provides a setup.exe file at %IIS_Web_Root%\appeon\plugin\fileservice.

Step 1: Double click the setup.exe file to start the setup.

If the "Installation Incomplete" error displays, please try the solution in the the section called “Appeon File Server Installation Incomplete” in PowerServer Troubleshooting Guide.

Step 2: Click the Next button and then the following window pops up. Select a Web site where the Appeon File Server will be installed.

Note that DO NOT change the name of Virtual directory otherwise Appeon File Server will fail to start.

Step 3: Click Next until the installation is complete.

Step 4: Go to directory where the Appeon File Server is installed, for example (C:\inetpub\wwwroot\fileservice).

Step 5: Select Properties from the right-click menu of the fileservice folder.

Step 6: In the Security tab page of the fileservice Properties window,

For IIS 7.5 or above, grant the IIS_IUSRS user with Full Control permission to this folder.

Uninstall Appeon File Server

Step 1: Go to Start | Control Panel | Add and Remove Programs.

Step 2: Select Appeon File Server and click Remove button.

After deploying the Appeon File Server, follow steps below to configure it.

Open the appeonfileserver.xml in C:\Inetpub\wwwroot\fileservice.

<?xml version="1.0" encoding="UTF-8"?>
<webserver>
<!-- The value of attribute "value" must begin with either a single or double quote character. -->
 <file-path value="D:\appeon\upload" />
 <log-level value="3" />          <!--0 Error,1 Info,2 Func, 3 Debug-->
 <session-timeout value="3600" /> <!-- the unit is second  -->
 <allowed-file-types value="txt;doc;jpg;mpeg" ignorecase="true" />
 <max-file-size value="20" />     <!-- the unit is M --> 
 <users>
  <user name="test" password="password" />
  <user name="userA" password="userA" />
  <user name="userB" password="userB" />
 </users>
</webserver>

Modify the file according to your own demands.

You will need to configure first and then deploy the Appeon File Server. Follow steps below to configure the Appeon File Server:

Step 1: On the machine where the Appeon File Server will be deployed, create an XML file wherever you like and name it whatever you wish. In this example, create an XML file named "appeonfileserver.xml" under D:\appeon\config directory.

Step 2: Copy the following code to the XML file.

<?xml version="1.0" encoding="UTF-8"?>
<fileserver>
 <file-path value="D:\appeon" />
 <session-timeout value="3600" />
 <allowed-file-types value="txt;doc;jpg;mpeg" ignorecase="true" />
 <max-file-size value="20" />
 <users>
  <user name="userA" password="userA" />
  <user name="userB" password="userB" />
 </users>
</fileserver>

Step 3: Modify the settings in the XML file if necessary.

Step 4: On the machine where the PowerServer is installed, unzip the fileservice.war (%powerserver%\plugin\fileservice) and find the web.xml file under the WEB-INF folder. Then open web.xml with a text editor. Replace the bold text with the name and directory of the XML file created in the previous steps.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE web-app PUBLIC '-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN' 
'http://java.sun.com/dtd/web-app_2_3.dtd'>
<web-app>

<servlet>
 <servlet-name>fileservice</servlet-name>
 <servlet-class>com.appeon.fileserver.WebServiceDispatcher</servlet-class>
 <init-param>
  <param-name>config</param-name>
  <param-value>D:\appeon\config\appeonfileserver.xml</param-value>
 </init-param>
 <load-on-startup>1</load-on-startup>
</servlet>
<servlet>
 <servlet-name>uploadfile</servlet-name>
 <servlet-class>com.appeon.fileserver.UploadFile</servlet-class>
 <init-param>
  <param-name>config</param-name>
  <param-value>D:\appeon\config\appeonfileserver.xml</param-value>
 </init-param>
 <load-on-startup>1</load-on-startup>
</servlet>

<servlet-mapping>
 <servlet-name>fileservice</servlet-name>
 <url-pattern>/fileservice</url-pattern>
</servlet-mapping>

</web-app>

Step 5: Save the file and re-compress the fileservice folder to fileservice.war using WinZip, WinRAR or JDK. Do not use the other compression tools such as 7-zip.

Then follow the next section Deploying the Appeon File Server to deploy fileservice.war.

After configuring the Appeon File Server, follow steps below to deploy it:

Step 1: On the machine where PowerServer is installed, access the WebLogic Server Administration Console in a Web browser.

Step 2: Click the Deployment link.

Step 3: Click the Install button and select the fileservice.war file at %powerserver%\plugin\fileservice.

Step 4: Click the Next button to use the default settings and then click the Finish button to finish the deployment of Appeon File Server.

Configuring the Appeon File Server in the Java server such as WebLogic, WebSphere, JBoss, JEUS etc. is the same. Please refer to Configuring the Appeon File Server for WebLogic.

After configuring the Appeon File Server, follow steps below to deploy it:

Step 1: On the machine where PowerServer is installed, access the WebSphere Administrative Console in a Web browser.

Step 2: Select Applications | Install New Applications from the left tree view. And then in the right page specify the path where the fileservice.war is (by default at %powerserver%\plugin\fileservice) and Context Root for the WAR file and click the Next button.

Step 3: Click Next with default settings until the file server is successfully installed on the WebSphere server.

Configuring the Appeon File Server in the Java server such as WebLogic, WebSphere, JBoss, JEUS etc. is the same. Please refer to Configuring the Appeon File Server for WebLogic.

After configuring the Appeon File Server, follow steps below to deploy it. There are two methods to deploy the Appeon File Server in JBoss:

Configuring the Appeon File Server in the Java server such as WebLogic, WebSphere, JBoss, JEUS etc. is the same. Please refer to Configuring the Appeon File Server for WebLogic.

After configuring the Appeon File Server, follow steps below to deploy it:

Copy the fileservice.war file to the directory %JEUS installation root directory%\webhome\autodeploy and then start JEUS server. The fileservice.war file will be deployed automatically.

AppeonFileService object provides the following functions to upload and download files:

long ll_re
string info

ll_re = fileservice.of_logonfileserver ("192.168.168.52", 80, "username=userA;password=userA") 

if ll_re = 0 then
 info = "Logon to file server is successful."
elseif  ll_re = 1 then
 info = "Failed to connect to the file server."
else
 info = "Failed to connect to the file server."
end if

Messagebox( "ll_re="+string(ll_re),info)

long ll_re
string info

ll_re = fileservice.of_logofffileserver ( ) 

if ll_re = 0 then
 info = "Logoff file server is successful."
elseif  ll_re = 1 then
 info = "Failed to log off file server."
else
 info = "The session has timed out or the user has not logged off the file server."
end if
 
Messagebox( "ll_re="+string(ll_re),info)

long ll_re
string info,ls_url

ls_url = fileservice.of_appeonupload ("C:\temp\1.pdf", "pdf_files", true, ll_re) 

if ll_re = 0 then
 info = "Upload is successful."
elseif  ll_re = 1 then
 info = "Failed to upload the file."
else
 info = "Other errors."
end if

Messagebox("ll_re="+string(ll_re),info+"~r~nurl="+ls_url)

long ll_re
string info

ll_re = fileservice.of_appeondownload ("pdf_files\1.pdf", "C:\") 

if ll_re = 0 then
 info = "Download is successful."
else
 info = "Other errors."
end if

Messagebox ("ll_re="+string(ll_re),info)

string ls_file

ls_file = "~"C:\Program Files\Internet Explorer\iexplore.exe~" C:\1.pdf"
Messagebox("",ls_file)
run(ls_file)

long ll_re
string info

ll_re = fileservice.of_fileexists ("pdf_files\1.pdf") 

if ll_re =1 then
 info = "The file exists."
elseif ll_re =0 then
 info = "The file does not exist on the file server."
else 
 info = "Other errors."
end if

Messagebox( "ll_re="+string(ll_re),info)

AppeonFileService object provides the following properties (private instances) to upload and download files: