OCi SAM Installation Guide

Installation Guide For Cloud Hosting (SAM)

A NEW Release of this tool is available
The download link for the new version of the Multi Profile Launcher installation file is provided below:

Installation Overview: 
1. Download the Multi Profile Launcher installation file and save it to your PC.
2. Open the downloaded installation file
3. Select the installation option “Only for me (OCI)” and click Install. 
4. Ensure that the Run OCI Multi Profile Launcher is ticked and click Finish
5. Follow Section 1.0 or Section 2.0 to continue the installation process
6. Refer to Section 3.0, 4.0, 5.0, or 6.0 for company profile setup or migration.

Common FAQ:  

How to download the Installation file? 

Download the OCI MultiProfile Launcher Setup 2.0.9.exe file from the provided source.    

How to locate the Downloaded File? 

If you’ve downloaded the installation file but can’t find it, try checking your Downloads folder, which is the default save location (press Windows + E to open File Explorer and click on Downloads). 
If it’s not there, use the search bar in File Explorer and type keywords like "OCi MultiProfile Launcher Setup"
Alternatively, open your browser’s download history (press Ctrl + J) and click “Show in folder” to locate the file directly. 

Which Section should I refer to : 

Installation 
  1. If you are a new user or installing OCI SAM on a new PC  ---> 1.0 Installation New User Or New PC.
  2. If you have previously installed the OCI SAM system on your PC ---> 2.0 Installation Existing User 
After the installation is completed, please continue to the sections below for company profile setup or migration.

Company Profiles 
  1. To add new company profiles ---> 3.0 Adding Profiles 
  2. If you are existing user who used the previous launcher and see the message: “Found ( ) existing profile folder(s) not in database and Linked names found in folder!   ---> 4.0 Migrating Existing Profiles 
  3. If you are an existing user and your previous launcher was put in another location and want to search for old profile,  and see the message " Found () existing profile folder(s) that are not in database and shows “No naming file found. Using default name” ---> 5.0 Migrate Existing Profiles but cannot auto find. 
  4. If you are existing user who is unsure where the previous folder is and want to migrate using default names, and see the message:" " Found () existing profile folder(s) that are not in database and shows “No naming file found. Using default name” ---> 6.0 Migrate Using Default Names 

1.0 Installation New User Or New PC
If you are a new user or this is a new PC,
The steps for both new and existing users are almost the same; the only difference is that for new users, they get prompted for an additional step. 
  1.  Download the Multi Profile Launcher installation file and save it to your PC.
  2. Open the downloaded installation file
  3. Select the installation option “Only for me (OCI)” and click Install. 
  4. Ensure that the Run OCI Multi Profile Launcher is ticked and click Finish
  5. Click Next on the Welcome to OCi MultiProfile Launcher screen.
  6. Click Next on the SAM Starter App screen.
  7. Click Finish on the Windows Permission screen.
  8. Click Install OCI System SAM Starter App.
  9.  The launcher will applying the system patches and bring you to the Company Profile Manager page.
    
2.0 Installation Existing User
If you have the OCi SAM system installed previously,
The steps for both new and existing users are almost the same; the only difference is that for new users, they get prompted for an additional step.

  1. Download the Multi profile launcher installation file and save it to your PC. 
  2. Open the downloaded installation file 
  3. Select the installation option "Only for me (OCI)" and click Install
  4. Ensure that the Run OCI Multi Profile Launcher is ticked and click Finish 
  5. The launcher will bring you to the Company Profile Page

3.0 Adding Profiles
The profile launcher is meant to allow you to connect to multiple companies (databases).
We call each company a profile.
You normally start with the training database.
The launcher has a guided tour to tell you what the buttons do. 
  1. Click Next to Add Profile
  2. Click Finish to Save Profile
  3. Enter your Company Profile name and click Add
  4. Click Launch.
  5. Enter the serial number and password.
  6. Click Login, and you will be directed to the OCI SAM system.

Repeat step 2 to add another company profile.


4.0 Migrate Existing Profiles
If you have used the previous launcher, the new launcher will automatically attempt to migrate the detected profiles.
  1. The launcher will appear message “Found ( ) existing profile folder(s) not in database and Linked names found in folder!”
  2.  A migration message guide will appear: “The Launcher has found your previous profiles and profile names automatically, Just click Migrate to bring them in” .  Click Next.
  3. A Skip & Clear Old Profiles message guide will appear: “If you click Skip and Clear, the old profiles will be deleted. Note: this only clears the old/previous connection and does not impact data.” Click Next.
  4. Click Next to add the profile.
  5. Click Finish to save the profile.
  6. Ensure that there is a message "Linked names found in folder!. Click Migrate to bring in your previous company profile name 
  7. Click Launch, and you will be directed to the OCI SAM system.

5.0 Migrate Existing Profiles but cannot auto find
If the previous launcher was put in another location, you can manually tell the launcher where to look.
The file to look for is called "software.json"
  1.  The launcher will appear the message " Found () existing profile folder(s) that are not in database and shows “No naming file found. Using default name”. 
  2. Click “Search for old Profiles (software.json)”.
  3. You will be redirected to a page where you can locate the software.json file. Select the file and click Open.
  4. The launcher will display “Linked names found in folder!” 
  5. Click Migrate to bring in your previous company profile name. 
  6. Click Launch, and you will be directed to the OCI SAM system.


6.0 Migrate Using Defaut Names
If you do not know where the previous folder is, you can just migrate using the default names.
After logging in, you know which company that profile is for, and you can rename it to the correct name.
Alternatively, you can clear the old profiles to create new profiles.
  1.  The launcher will appear the message: “ Found () existing profile folder(s) not in database" and "No naming found . Using default names". 
  2.  A migration message guide "The Launcher has found previous profiles without profile name . Click Migrate to use these profiles" will appear. Click Next. 
  3. The launcher will pop up a message guide " Find previous Profiles: The Launcher was unable to find previous profiles name. If you know the folder location of the previous Launcher you can select it otherwise you can still use the migrate button. The launcher will use default names. You can rename the profile later". Click Next. 
  4. A Skip & Clear old profile message guide "If you click Skip and Clear, the old profiles will be deleted. Note this only clears the old/previous connection away. it does not impact data at all.  Click Next. 
  5. Click Next to Add profile 
  6. Click Finish to save the profile 
  7. If you do not know where is the previous launcher folder is , click Migrate and the default company profile name “Migrated Profile XX” will appear.
  8. Click Launch, and you will be directed to the OCI SAM system.
  9. Log in with your user ID and password.
  10. Go to Setup → Company Details → Company to verify the company name.
  11. Go back to the launcher and click Rename to rename the company profile.









    • Related Articles

    • Multiple Company Launcher

      A NEW Release of this tool is available The download link for the new version of the Multi Profile Launcher installation file is provided below: Version: 2.0.9 OC MultiProfile Launcher Setup Installation New User Or New PC If you are a new user or ...

    • (SAM) Hosting Installation files

      OCi SAM Hosting Installation Files. Instructions Download the Zip file. Unzip the file. Run the 'Setup.exe' Note: The license email will contain the serial number and password in both text and PDF format. The same serial number and password is used ...

    • OCI SAM ON-PREMISE Client installation

      OCI SAM ON-PREMISE Client installation Step 1 User left click on Installation File Step 2 User left click Next Step 3: User left click on Next Step 4: User left click on Next Step 5: User left click on Close Step 6 User left double click on "OCi SAM ...

    • Cloud Server Hosting Services

      Switch to Cloud Server Hosting Now! System can be used anywhere. It provides users with the flexibility of having their database cloud hosted. Freeing users from the need to be desk bound. Your Accounting data is hosted on a secure enterprise class ...

    • How to Install the Application from a zip folder?

      The following is for those who are unable to run the installation file from the zipped folder due to one reason or another. This guide will show you how to extract the installation files from the zipped folder to a normal folder, allowing the ...