We’ve developed some resources to help you work effectively from home during COVID-19 Click here to learn more

Install Service

In this article

    Default installation of Service does not allow you to install it in a sub application. With SuperOffice 8.1 both Sale and Service must be installed on the same root domain. It will be easier to create Application Routing Routing rules (ARR) if you do the manual installation and place Service in a sub application. 

    Before you install Service you need the CRM Server installed
    Also make sure you have a web server prepared and if this is a new installation of Service you need to prepare a domain and ODBC source
    Service also requires SuperOffice Web Services (NetServer) available 

    The installer will copy the necessary files to the Service program folder.

    1. Run the SuperOffice.CustomerService.exe

    2. When asked, select a destination folder for the installation of SuperOffice Service.

    3. Choose your hostname. The hostname should be the registered DNS name you will be using to access both CRM web and Customer Service request management interface in your web browser.

    4. You also have the option of installing and overwriting the customer web templates, or leave your own customized one in place (if you have done customizations). If you choose to install/overwrite the templates, the installer will attempt to make a backup copy. For new installations, always leave this field checked.

    5. Let the installer  create an IIS site based on the hostname you entered. If the IIS website it already available on the webserver then you need to uncheck the “Create IIS web site”.

    6. Before proceding, make sure you have set up or upgraded SuperOffice Web Services (NetServer) to the same version as Service.

     

    You need to configure some startup data that is specific to your installation – among else you need to specify the mail server to use, default from address, the company name, the ODBC database user, NetServer system users and a few other things.

    Start cmd.exe as an administrator from the start menu and navigate to your installation directory, and then to the subdirectoy /bin under that. Run the application ejtermsetup.exe, and you will be prompted for the necessary settings.

    Choose system language: Customer Service will use this language to prime the database with different things that are not multi-language (for example the default system templates, priorities and so on). You will not be able to changes this later.

    Hostname: This should be the hostname which application will be access on. Normally this is the same as the DNS address you entered when installing Customer Service. Note - this is where you may add hostname/applicationname if you have followed the steps for manual installation

    What is your name: Enter your name here. This is only used for information about who has installed the application.

    What database system will you use: Choose the database type which your database is running on.

    Username: This is the same username as you used in the ODBC setup.

    Password: This is the same password as you used in the ODBC setup.

    DSN: The name of the ODBC/DSN source.

    NetServer endpoint: Enter the URL for the NetServer installed for this Service installation. 

    SuperOffice CRM administrator user: Here you must enter a user which has NetServer administrator rights. This user will be used to create a NetServer system user, which will be used by the Service application. If you have just run the server setup, you configured a first user there, and you should use that one.

    Password for this user: The password for this CRM administrator user. After pressing "enter" you may have to wait some time.

    From 8.4 R04 Service needs to know NetServer's symmetric keys which are used to encrypt traffic from NetServer to Service. This is used to enable NetServer to call Service.

    Enter the SymmetricKey value found in the web.config file for NetServer: 

    Enter the SymmetricSecret value found in the web.config file for NetServer:
    You will find both values in the NetServer's Web.config, in the Security - Cryptography section. Enter the value part without the quotes.

    For installations where you run upgrade.exe (or ejTermsetup.exe for new installations), the program asks for the keys if they do not exist. It will then test whether the keys are correct.

    When running upgrade.exe interactively, upgrade.exe must update its config file with these values. If you do not run upgrade.exe then the values ​​must be manually added to the config file.

    In version 8.5 R06, we have rewritten the CRMScript triggers in Sales to use the same communication system as the Service entities, so that we standardize on one way of doing API calls from Sales to Service. As a consequence, you must verify that this communication system is working when upgrading, otherwise CRMScript triggers from Sales will stop working. Specifically, this means:

    - Make sure the authentication keys are present, and equal, in all config files (web.config(s) and config

    - Make sure your network topology allows HTTP(s) communication from the NetServer installation to the Service installation.

    NOTE: Previously, the connections originate from the Web client, now they originate from NetServer.

    If you use encrypted Web.config you can't read the Symmetric key values directly. You need to open the SuperOffice Web Product configuration tool, go to the Security section and copy the keys from there.image.png

    Basepath: This is where the application is installed. Normally there should be no reason to use anything but the default value, as this is picked up from the installer.

    Login name of existing CRM user: If you have an upgraded pre-seven CRM database, you must connect the first Customer Service user to an existing CRM user. Enter his/her username here.

    Email for the first user/administrator email: If the first user does not have an email address, you must enter it here.

    Default email: This is the default email address which will be used when sending emails. This should be an email address of an mail box that is intended to be imported into Customer Service.

    SMTP hostname: The address of your SMTP address, which will be used to send emails.

    SMTP port
    : The port number used by your SMTP server. This is normally 25.

    Cgi-bin path: The path to the cgi-bin folder on the web server when accessed using HTTP. If you let the installer set up the IIS site, you can use the default value.

    HTTP path: The full HTTP path to your server, except the cgi-bin part. If you let the installer set up the IIS site and you entered the same under “hostname”, you can use the default value.

    Available on the Internet: Enable this option if your Service Server installation is online on the Internet. This will unlock some functionality in the Service Server that relies on an Internet connection.

    Do  you want to start the ejScheduler service: If you start the service, the application will begin to import and send email as soon as you configure it. The service is also used for all background processes, like escalating request, sending alerts and so forth. If you answer “no” here, the service will still be installed and enabled, but not started. That means it will start when you boot the system if you do not disable it. You can go to service management to start the service when you are ready.

    When ejtermsetup.exe is done, it will tell you that your installation is ready to run and the address where it should be available in a web browser. You can log in with the administrator user you entered earlier, and start configuring the system.

    The ejtermsetup.exe application would have asked you if you wanted to start the ejScheduler service that is responsible for periodically running the console applications ejournalcron.exe and importmail.exe.

    These applications in turn will perform tasks like importing email, sending email, activating postponed tickets, and other tasks. If you did not let the ejtermsetup.exe start the scheduler for you, you should do it manually when you are ready:

    Open the Control panel

    Choose Administrative tools

    Click Services

    Click the appropriate eJournal Scheduler <sitename> for your site.

    Select Start Service

    To start the service at boot, right click eJournal Scheduler, select Properties and make sure Startup type is set to Automatic.

    Click Start to start the service

    You are now ready to log in and use Service by opening your client browser and go to [Hostname]/scripts/ticket.fcgi